WebAssembly.instantiateStreaming()

source

Response オブジェクト、またはそれで解決するプロミスで、コンパイルしてインスタンス化する .wasm モジュールのソースを表します。

importObject 省略可

関数や WebAssembly.Memory オブジェクトなど、新しく生成される Instance にインポートされる値を持つオブジェクト。コンパイルされたモジュールの宣言されたインポートそれぞれに対応するプロパティが存在する必要があります。そうでない場合、WebAssembly.LinkError が発生します。

Promise で、次の 2 つのフィールドを持つ ResultObject で解決します。

• module: コンパイルされた WebAssembly.Module オブジェクト。この Module は再度インスタンス化することや、postMessage() 経由で共有することができます。
• instance: WebAssembly.Instance オブジェクトで、すべてのエクスポートされた WebAssembly 関数を含みます。

• いずれかの引数が正しい型または構造でない場合、TypeError が発生します。
• 失敗した場合、プロミスは失敗の原因に応じて WebAssembly.CompileError、WebAssembly.LinkError、WebAssembly.RuntimeError をもって拒否されます。

次の例 (Github上のデモ instantiate-streaming.html と、動作例を参照してください) では、ソースから .wasm モジュールを直接コンパイルしてインスタンス化しています。このプロミスは ResultObject で履行されます。 instantiateStreaming() 関数は Response オブジェクトに解決するプロミスを受け取るので、直接 fetch() の呼び出し結果を渡すことができます。

const importObject = { imports: { imported_func: (arg) => console.log(arg) } };

WebAssembly.instantiateStreaming(fetch("simple.wasm"), importObject).then(
  (obj) => obj.instance.exports.exported_func(),
);

最後に ResultObject が持つ instance メンバーにアクセスして、エクスポートされた関数を実行しています。

• WebAssembly 概要ページ
• WebAssembly の概念
• WebAssembly JavaScript API の使用