Global_Objects/WebAssembly/Global を更新 (#2295)

- Markdownに変換
- 2021/08/31 時点の英語版に同期
- Global コンストラクターは新規翻訳

1 files changed, 87 insertions, 0 deletions

diff --git a/files/ja/web/javascript/reference/global_objects/webassembly/global/index.md b/files/ja/web/javascript/reference/global_objects/webassembly/global/index.md
new file mode 100644
index 0000000000..68b78bdb66
--- /dev/null
+++ b/files/ja/web/javascript/reference/global_objects/webassembly/global/index.md
@@ -0,0 +1,87 @@
+---
+title: WebAssembly.Global
+slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/Global
+tags:
+  - Class
+  - JavaScript
+  - Reference
+  - WebAssembly
+browser-compat: javascript.builtins.WebAssembly.Global
+translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/Global
+---
+{{JSRef}}
+
+**`WebAssembly.Global`** はグローバル変数のインスタンスを表します。 JavaScript からアクセスでき、1つ以上の {{jsxref("WebAssembly.Module")}} インスタンス間でインポート/エクスポートすることができます。これにより複数のモジュールを動的にリンクすることができます。
+
+## コンストラクター
+
+- [`WebAssembly.Global()`](/ja/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/Global/Global)
+  - : 新しい `Global` オブジェクトを生成します。
+
+## Global のインスタンス
+
+すべての `Global` のインスタンスは `Global()` コンストラクターのプロパティオブジェクトを継承します。これによりすべての `Global` インスタンスを変更することができます。
+
+### インスタンスプロパティ
+
+- `Global.prototype.constructor`
+  - : このオブジェクトのインスタンスを生成した関数を返します。既定では、これは {{jsxref("WebAssembly.Global()")}} コンストラクターです。
+- `Global.prototype[@@toStringTag]`
+  - : [@@toStringTag](/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toStringTag) プロパティの初期値で、文字列値 "WebAssembly.Global" です。
+- `Global.prototype.value`
+  - : グローバル変数の中に含まれている値です。これにより、グローバル値を直接設定および取得することができます。
+
+### インスタンスメソッド
+
+- `Global.prototype.valueOf()`
+  - : グローバル変数の中に含まれている値を返す古い形のメソッドです。
+
+## 例
+
+### 新しい Global インスタンスの生成
+
+以下の例では新しいグローバルインスタンスは `WebAssembly.Global()` コンストラクターを用いて初期化され、初期値 0 の変更可能な `i32` 型として定義されます。
+
+その後この値は、`Global.value` プロパティを使うことによって `42` に、`global.wasm` モジュールから公開された (どんな値が与えられても 1 を加算して、新しい値を返す)  `incGlobal()` 関数を使うことによって `43` になります。
+
+```js
+const output = document.getElementById('output');
+
+function assertEq(msg, got, expected) {
+  output.innerHTML += `Testing ${msg}: `;
+  if (got !== expected)
+    output.innerHTML += `FAIL!<br>Got: ${got}<br>Expected: ${expected}<br>`;
+  else
+    output.innerHTML += `SUCCESS! Got: ${got}<br>`;
+}
+
+assertEq("WebAssembly.Global exists", typeof WebAssembly.Global, "function");
+
+const global = new WebAssembly.Global({value:'i32', mutable:true}, 0);
+
+WebAssembly.instantiateStreaming(fetch('global.wasm'), { js: { global } })
+.then(({instance}) => {
+    assertEq("getting initial value from wasm", instance.exports.getGlobal(), 0);
+    global.value = 42;
+    assertEq("getting JS-updated value from wasm", instance.exports.getGlobal(), 42);
+    instance.exports.incGlobal();
+    assertEq("getting wasm-updated value from JS", global.value, 43);
+});
+```
+
+> **Note:** この例は[GitHub 上の実行例](https://mdn.github.io/webassembly-examples/js-api-examples/global.html)で確認できます。また、[ソースコード](https://github.com/mdn/webassembly-examples/blob/master/js-api-examples/global.html)も参照してください。
+
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- [WebAssembly](/ja/docs/WebAssembly) overview page
+- [WebAssembly concepts](/ja/docs/WebAssembly/Concepts)
+- [WebAssembly JavaScript API の使用](/ja/docs/WebAssembly/Using_the_JavaScript_API)
+- [Import/Export mutable globals proposal](https://github.com/WebAssembly/mutable-global/blob/master/proposals/mutable-global/Overview.md)