New translations assemblyscript-migration-guide.mdx (Japanese)

graphprotocol · benface · Jan 28, 2022 · Jan 28, 2022 · Jan 28, 2022 · Jan 28, 2022
commit 63122a797958306a303c278502bc8eae9849109e
diff --git a/pages/ja/developer/assemblyscript-migration-guide.mdx b/pages/ja/developer/assemblyscript-migration-guide.mdx
@@ -1,18 +1,18 @@
 ---
-title: AssemblyScript マイグレーションガイド
+title: AssemblyScript Migration Guide
 ---
 
-これまでサブグラフは、[AssemblyScriptの最初のバージョン](https://github.com/AssemblyScript/assemblyscript/tree/v0.6) （v0.6）を使用していました。 ついに[最新のバージョン](https://github.com/AssemblyScript/assemblyscript/tree/v0.19.10)(v0.19.10) のサポートを追加しました! 🎉
+Up until now, subgraphs have been using one of the [first versions of AssemblyScript](https://github.com/AssemblyScript/assemblyscript/tree/v0.6) (v0.6). Finally we've added support for the [newest one available](https://github.com/AssemblyScript/assemblyscript/tree/v0.19.10) (v0.19.10)! 🎉
 
-これにより、サブグラフの開発者は、AS言語と標準ライブラリの新しい機能を使用できるようになります。
+That will enable subgraph developers to use newer features of the AS language and standard library.
 
-このガイドは、バージョン`0.22.0`以下の`graph-cli`/`graph-ts` をお使いの方に適用されます。 もしあなたがすでにそれ以上のバージョンにいるなら、あなたはすでに AssemblyScript のバージョン`0.19.10` を使っています。
+This guide is applicable for anyone using `graph-cli`/`graph-ts` below version `0.22.0`. If you're already at a higher than (or equal) version to that, you've already been using version `0.19.10` of AssemblyScript 🙂
 
-> 注：`0.24.0`以降、`graph-node`はサブグラフマニフェストで指定された`apiVersion`に応じて、両方のバージョンをサポートしています。
+> Note: As of `0.24.0`, `graph-node` can support both versions, depending on the `apiVersion` specified in the subgraph manifest.
 
-## 特徴
+## Features
 
-### 新機能
+### New functionality
 
 - `TypedArray`s can now be built from `ArrayBuffer`s by using the [new `wrap` static method](https://www.assemblyscript.org/stdlib/typedarray.html#static-members) ([v0.8.1](https://github.com/AssemblyScript/assemblyscript/releases/tag/v0.8.1))
 - New standard library functions: `String#toUpperCase`, `String#toLowerCase`, `String#localeCompare`and `TypedArray#set` ([v0.9.0](https://github.com/AssemblyScript/assemblyscript/releases/tag/v0.9.0))
@@ -30,21 +30,21 @@ title: AssemblyScript マイグレーションガイド
 - Add `toUTCString` for `Date` ([v0.18.30](https://github.com/AssemblyScript/assemblyscript/releases/tag/v0.18.30))
 - Add `nonnull/NonNullable` builtin type ([v0.19.2](https://github.com/AssemblyScript/assemblyscript/releases/tag/v0.19.2))
 
-### 最適化
+### Optimizations
 
 - `Math` functions such as `exp`, `exp2`, `log`, `log2` and `pow` have been replaced by faster variants ([v0.9.0](https://github.com/AssemblyScript/assemblyscript/releases/tag/v0.9.0))
 - Slightly optimize `Math.mod` ([v0.17.1](https://github.com/AssemblyScript/assemblyscript/releases/tag/v0.17.1))
 - Cache more field accesses in std Map and Set ([v0.17.8](https://github.com/AssemblyScript/assemblyscript/releases/tag/v0.17.8))
 - Optimize for powers of two in `ipow32/64` ([v0.18.2](https://github.com/AssemblyScript/assemblyscript/releases/tag/v0.18.2))
 
-### その他
+### Other
 
 - The type of an array literal can now be inferred from its contents ([v0.9.0](https://github.com/AssemblyScript/assemblyscript/releases/tag/v0.9.0))
 - Updated stdlib to Unicode 13.0.0 ([v0.10.0](https://github.com/AssemblyScript/assemblyscript/releases/tag/v0.10.0))
 
-## アップグレードの方法
+## How to upgrade?
 
-1. `subgraph.yaml`のマッピングの`apiVersion`を`0.0.6`に変更してください。
+1. Change your mappings `apiVersion` in `subgraph.yaml` to `0.0.6`:
 
 ```yaml
 ...
@@ -56,7 +56,7 @@ dataSources:
       ...
 ```
 
-2. 使用している`graph-cli`を`最新版`に更新するには、次のように実行します。
+2. Update the `graph-cli` you're using to the `latest` version by running:
 
 ```bash
 # if you have it globally installed
@@ -66,20 +66,20 @@ npm install --global @graphprotocol/graph-cli@latest
 npm install --save-dev @graphprotocol/graph-cli@latest
 ```
 
-3. `graph-ts`についても同様ですが、グローバルにインストールするのではなく、メインの依存関係に保存します。
+3. Do the same for `graph-ts`, but instead of installing globally, save it in your main dependencies:
 
 ```bash
 npm install --save @graphprotocol/graph-ts@latest
 ```
 
-4. ガイドの残りの部分に従って、言語の変更を修正します。
-5. `codegen`を実行し、再度`deploy`します。
+4. Follow the rest of the guide to fix the language breaking changes.
+5. Run `codegen` and `deploy` again.
 
-## 変更点
+## Breaking changes
 
 ### Nullability
 
-古いバージョンのAssemblyScriptでは、以下のようなコードを作ることができました:
+On the older version of AssemblyScript, you could create code like this:
 
 ```typescript
 function load(): Value | null { ... }
@@ -88,7 +88,7 @@ let maybeValue = load();
 maybeValue.aMethod();
 ```
 
-しかし、新しいバージョンでは、値がnullableであるため、次のようにチェックする必要があります:
+However on the newer version, because the value is nullable, it requires you to check, like this:
 
 ```typescript
 let maybeValue = load()
@@ -98,27 +98,27 @@ if (maybeValue) {
 }
 ```
 
-あるいは、次のように強制します:
+Or force it like this:
 
 ```typescript
 let maybeValue = load()! // breaks in runtime if value is null
 
 maybeValue.aMethod()
 ```
 
-どちらを選択すべきか迷った場合は、常に安全なバージョンを使用することをお勧めします。 値が存在しない場合は、サブグラフハンドラの中でreturnを伴う初期のif文を実行するとよいでしょう。
+If you are unsure which to choose, we recommend always using the safe version. If the value doesn't exist you might want to just do an early if statement with a return in you subgraph handler.
 
-### 変数シャドウイング
+### Variable Shadowing
 
-以前は、[変数のシャドウイング](https://en.wikipedia.org/wiki/Variable_shadowing)を行うことができ、次のようなコードが動作していました。
+Before you could do [variable shadowing](https://en.wikipedia.org/wiki/Variable_shadowing) and code like this would work:
 
 ```typescript
 let a = 10
 let b = 20
 let a = a + b
 ```
 
-しかし、現在はこれができなくなり、コンパイラは次のようなエラーを返します。
+However now this isn't possible anymore, and the compiler returns this error:
 
 ```typescript
 ERROR TS2451: Cannot redeclare block-scoped variable 'a'
@@ -127,17 +127,17 @@ ERROR TS2451: Cannot redeclare block-scoped variable 'a'
  ~~~~~~~~~~~~~
 in assembly/index.ts(4,3)
 ```
-変数シャドウイングを行っていた場合は、重複する変数の名前を変更する必要があります。
-### Null比較
-サブグラフのアップグレードを行うと、時々以下のようなエラーが発生することがあります。
+You'll need to rename your duplicate variables if you had variable shadowing.
+### Null Comparisons
+By doing the upgrade on your subgraph, sometimes you might get errors like these:
 
 ```typescript
 ERROR TS2322: Type '~lib/@graphprotocol/graph-ts/common/numbers/BigInt | null' is not assignable to type '~lib/@graphprotocol/graph-ts/common/numbers/BigInt'.
      if (decimals == null) {
                      ~~~~
  in src/mappings/file.ts(41,21)
 ```
-解決するには、 `if` 文を以下のように変更するだけです。
+To solve you can simply change the `if` statement to something like this:
 
 ```typescript
   if (!decimals) {
@@ -147,23 +147,23 @@ ERROR TS2322: Type '~lib/@graphprotocol/graph-ts/common/numbers/BigInt | null' i
   if (decimals === null) {
 ```
 
-これは、==ではなく！=の場合も同様です。
+The same applies if you're doing != instead of ==.
 
-### キャスト
+### Casting
 
-以前の一般的なキャストの方法は、次のように`as`キーワードを使うだけでした。
+The common way to do casting before was to just use the `as` keyword, like this:
 
 ```typescript
 let byteArray = new ByteArray(10)
 let uint8Array = byteArray as Uint8Array // equivalent to: <Uint8Array>byteArray
 ```
 
-しかし、これは2つのシナリオでしか機能しません。
+However this only works in two scenarios:
 
-- プリミティブなキャスト(between types such as `u8`, `i32`, `bool`; eg: `let b: isize = 10; b as usize`);
-- クラス継承のアップキャスティング（サブクラス→スーパークラス）
+- Primitive casting (between types such as `u8`, `i32`, `bool`; eg: `let b: isize = 10; b as usize`);
+- Upcasting on class inheritance (subclass → superclass)
 
-例
+Examples:
 
 ```typescript
 // primitive casting
@@ -179,10 +179,10 @@ class Bytes extends Uint8Array {}
 let bytes = new Bytes(2) < Uint8Array > bytes // same as: bytes as Uint8Array
 ```
 
-キャストしたくても、`as`/`<T>var`を使うと**安全ではない**というシナリオが2つあります。
+There are two scenarios where you may want to cast, but using `as`/`<T>var` **isn't safe**:
 
-- クラス継承のダウンキャスト（スーパークラス → サブクラス）
-- スーパークラスを共有する2つの型の間
+- Downcasting on class inheritance (superclass → subclass)
+- Between two types that share a superclass
 
 ```typescript
 // downcasting on class inheritance
@@ -199,7 +199,7 @@ class ByteArray extends Uint8Array {}
 let bytes = new Bytes(2) < ByteArray > bytes // breaks in runtime :(
 ```
 
-このような場合には、`changetype<T>`関数を使用します。
+For those cases, you can use the `changetype<T>` function:
 
 ```typescript
 // downcasting on class inheritance
@@ -218,7 +218,7 @@ let bytes = new Bytes(2)
 changetype<ByteArray>(bytes) // works :)
 ```
 
-単にnull性を除去したいだけなら、`as` オペレーター(or `<T>variable`)を使い続けることができますが、値がnullではないことを確認しておかないと壊れてしまいます。
+If you just want to remove nullability, you can keep using the `as` operator (or `<T>variable`), but make sure you know that value can't be null, otherwise it will break.
 
 ```typescript
 // remove nullability
@@ -231,18 +231,18 @@ if (previousBalance != null) {
 let newBalance = new AccountBalance(balanceId)
 ```
 
-Nullabilityについては、[nullability check feature](https://www.assemblyscript.org/basics.html#nullability-checks)を利用することをお勧めします。
+For the nullability case we recommend taking a look at the [nullability check feature](https://www.assemblyscript.org/basics.html#nullability-checks), it will make your code cleaner 🙂
 
-また、キャストを容易にするために、いくつかの型にスタティックメソッドを追加しました。
+Also we've added a few more static methods in some types to ease casting, they are:
 
 - Bytes.fromByteArray
 - Bytes.fromUint8Array
 - BigInt.fromByteArray
 - ByteArray.fromBigInt
 
-### プロパティアクセスによるNullabilityチェック
+### Nullability check with property access
 
-[nullability check feature](https://www.assemblyscript.org/basics.html#nullability-checks)を使用するには、次のように`if`文や三項演算子(`?` and `:`) を使用します。
+To use the [nullability check feature](https://www.assemblyscript.org/basics.html#nullability-checks) you can use either `if` statements or the ternary operator (`?` and `:`) like this:
 
 ```typescript
 let something: string | null = 'data'
@@ -260,7 +260,7 @@ if (something) {
 }
 ```
 
-しかし、これは、以下のように、プロパティのアクセスではなく、変数に対して`if`/ternaryを行っている場合にのみ機能します。
+However that only works when you're doing the `if` / ternary on a variable, not on a property access, like this:
 
 ```typescript
 class Container {
@@ -273,15 +273,15 @@ container.data = 'data'
 let somethingOrElse: string = container.data ? container.data : 'else' // doesn't compile
 ```
 
-すると、このようなエラーが出力されます。
+Which outputs this error:
 
 ```typescript
 ERROR TS2322: Type '~lib/string/String | null' is not assignable to type '~lib/string/String'.
 
    let somethingOrElse: string = container.data ? container.data : "else";
                                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ```
-この問題を解決するには、そのプロパティアクセスのための変数を作成して、コンパイラがnullability checkのマジックを行うようにします。
+To fix this issue, you can create a variable for that property access so that the compiler can do the nullability check magic:
 
 ```typescript
 class Container {
@@ -296,9 +296,9 @@ let data = container.data
 let somethingOrElse: string = data ? data : 'else' // compiles just fine :)
 ```
 
-### プロパティアクセスによるオペレーターオーバーロード
+### Operator overloading with property access
 
-アセンブリスクリプトのコンパイラは、値の片方がnullableであることを警告するコンパイル時のエラーを出さずに、ただ黙ってコンパイルするので、実行時にコードが壊れる可能性があります。
+If you try to sum (for example) a nullable type (from a property access) with a non nullable one, the AssemblyScript compiler instead of giving a compile time error warning that one of the values is nullable, it just compiles silently, giving chance for the code to break at runtime.
 
 ```typescript
 class BigInt extends Uint8Array {
@@ -322,7 +322,7 @@ let wrapper = new Wrapper(y)
 wrapper.n = wrapper.n + x // doesn't give compile time errors as it should
 ```
 
-この件に関して、アセンブリ・スクリプト・コンパイラーに問題を提起しましたが、 今のところ、もしサブグラフ・マッピングでこの種の操作を行う場合には、 その前にNULLチェックを行うように変更してください。
+We've opened a issue on the AssemblyScript compiler for this, but for now if you do these kind of operations in your subgraph mappings, you should change them to do a null check before it.
 
 ```typescript
 let wrapper = new Wrapper(y)
@@ -334,25 +334,25 @@ if (!wrapper.n) {
 wrapper.n = wrapper.n + x // now `n` is guaranteed to be a BigInt
 ```
 
-### 値の初期化
+### Value initialization
 
-もし、このようなコードがあった場合:
+If you have any code like this:
 
 ```typescript
 var value: Type // null
 value.x = 10
 value.y = 'content'
 ```
 
-これは、値が初期化されていないために起こります。したがって、次のようにサブグラフが値を初期化していることを確認してください。
+It will compile but break at runtime, that happens because the value hasn't been initialized, so make sure your subgraph has initialized their values, like this:
 
 ```typescript
 var value = new Type() // initialized
 value.x = 10
 value.y = 'content'
 ```
 
-また、以下のようにGraphQLのエンティティにNullableなプロパティがある場合も同様です。
+Also if you have nullable properties in a GraphQL entity, like this:
 
 ```graphql
 type Total @entity {
@@ -361,7 +361,7 @@ type Total @entity {
 }
 ```
 
-そして、以下のようなコードになります:
+And you have code similar to this:
 
 ```typescript
 let total = Total.load('latest')
@@ -373,7 +373,7 @@ if (total === null) {
 total.amount = total.amount + BigInt.fromI32(1)
 ```
 
-`total.amount`の値を確実に初期化する必要があります。なぜなら、最後の行のsumのようにアクセスしようとすると、クラッシュしてしまうからです。 そのため、最初に初期化する必要があります。
+You'll need to make sure to initialize the `total.amount` value, because if you try to access like in the last line for the sum, it will crash. So you either initialize it first:
 
 ```typescript
 let total = Total.load('latest')
@@ -386,7 +386,7 @@ if (total === null) {
 total.tokens = total.tokens + BigInt.fromI32(1)
 ```
 
-あるいは、このプロパティに nullable 型を使用しないように GraphQL スキーマを変更することもできます。そうすれば、`コード生成`の段階でゼロとして初期化されます。
+Or you can just change your GraphQL schema to not use a nullable type for this property, then we'll initialize it as zero on the `codegen` step 😉
 
 ```graphql
 type Total @entity {
@@ -405,9 +405,9 @@ if (total === null) {
 total.amount = total.amount + BigInt.fromI32(1)
 ```
 
-### クラスのプロパティの初期化
+### Class property initialization
 
-以下のように、他のクラス（自分で宣言したものや標準ライブラリで宣言したもの）のプロパティを持つクラスをエクスポートした場合、そのクラスのプロパティを初期化します:
+If you export any classes with properties that are other classes (declared by you or by the standard library) like this:
 
 ```typescript
 class Thing {}
@@ -417,7 +417,7 @@ export class Something {
 }
 ```
 
-コンパイラがエラーになるのは、クラスであるプロパティにイニシャライザを追加するか、`!` オペレーターを追加する必要があるからです。
+The compiler will error because you either need to add an initializer for the properties that are classes, or add the `!` operator:
 
 ```typescript
 export class Something {
@@ -441,11 +441,11 @@ export class Something {
 }
 ```
 
-### GraphQLスキーマ
+### GraphQL schema
 
-これはAssemblyScriptの直接的な変更ではありませんが、`schema.graphql`ファイルを更新する必要があるかもしれません。
+This is not a direct AssemblyScript change, but you may have to update your `schema.graphql` file.
 
-タイプの中にNon-Nullable Listのフィールドを定義することができなくなりました。 次のようなスキーマを持っているとします。
+Now you no longer can define fields in your types that are Non-Nullable Lists. If you have a schema like this:
 
 ```graphql
 type Something @entity {
@@ -458,7 +458,7 @@ type MyEntity @entity {
 }
 ```
 
-Listタイプのメンバーには、以下のように`!` を付ける必要があります。
+You'll have to add an `!` to the member of the List type, like this:
 
 ```graphql
 type Something @entity {
@@ -471,9 +471,9 @@ type MyEntity @entity {
 }
 ```
 
-これはAssemblyScriptのバージョンによるnullabilityの違いから変更されたもので、`src/generated/schema.ts`ファイル（デフォルトのパス、あなたはこれを変更したかもしれません）に関連しています。
+This changed because of nullability differences between AssemblyScript versions, and it's related to the `src/generated/schema.ts` file (default path, you might have changed this).
 
-### その他
+### Other
 
 - Aligned `Map#set` and `Set#add` with the spec, returning `this` ([v0.9.2](https://github.com/AssemblyScript/assemblyscript/releases/tag/v0.9.2))
 - Arrays no longer inherit from ArrayBufferView, but are now distinct ([v0.10.0](https://github.com/AssemblyScript/assemblyscript/releases/tag/v0.10.0))