WebAssembly.Global
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年3月以降、すべてのブラウザーで利用可能です。
WebAssembly.Global はグローバル変数のインスタンスを表します。JavaScript からアクセスでき、1 つ以上の WebAssembly.Module インスタンス間でインポート/エクスポートすることができます。これにより複数のモジュールを動的にリンクすることができます。
コンストラクター
WebAssembly.Global()-
新しい
Globalオブジェクトを生成します。
Global インスタンス
すべての Global インスタンスは Global() コンストラクターのプロパティオブジェクトを継承します。これによりすべての Global インスタンスを変更することができます。
インスタンスプロパティ
Global.prototype.value-
グローバル変数の中に含まれている値です。これにより、グローバル値を直接設定および取得することができます。
Global.prototype.constructor-
このオブジェクトのインスタンスを生成した関数を返します。デフォルトでは、これは
WebAssembly.Global()コンストラクターです。 Global.prototype[Symbol.toStringTag]-
[Symbol.toStringTag]プロパティの初期値で、文字列値 "WebAssembly.Global" です。
インスタンスメソッド
Global.prototype.valueOf()-
グローバル変数の中に含まれている値を返す古い形のメソッドです。
例
新しい Global インスタンスの生成
以下の例では、新しいグローバルインスタンスが WebAssembly.Global() コンストラクターを用いて生成されます。変更可能 (mutable) な i32 型として定義され、値は 0 です。
その後、グローバルの値は、まず Global.value プロパティを使用して 42 に変更され、次に global.wasm モジュールからエクスポートされた incGlobal() 関数を使用して 43 に変更されます（これは、与えられた値に 1 を追加してから新しい値を返します）。
const output = document.getElementById("output");
function assertEq(msg, got, expected) {
const result =
got === expected
? `SUCCESS! Got: ${got}\n`
: `FAIL!\nGot: ${got}\nExpected: ${expected}\n`;
output.innerText += `Testing ${msg}: ${result}`;
}
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(
"初期値を wasm から取得",
instance.exports.getGlobal(),
0,
);
global.value = 42;
assertEq(
"JS が更新した値を wasm から取得",
instance.exports.getGlobal(),
42,
);
instance.exports.incGlobal();
assertEq("wasm が更新した値を JS から取得", global.value, 43);
},
);
メモ: この例は GitHub 上の実行例で確認できます。また、ソースコードも参照してください。
仕様書
| 仕様書 |
|---|
| WebAssembly JavaScript Interface # globals |