WebAssembly.compileStreaming()

構文

WebAssembly.compileStreaming(source)

引数

source

ストリーム、コンパイルする .wasm モジュールのソースコードを表す Response オブジェクト、またはそれで履行されるプロミスです。

返値

Promise で、コンパイルされたモジュールを表す WebAssembly.Module に解決します。

例外

• source が Response でも Response に解決する Promise でもなかった場合、プロミスは TypeError で拒否されます。
• コンパイルに失敗した場合、プロミスは WebAssembly.CompileError で拒否されます。
• source の Promise が拒否された場合、プロミスはエラーで拒否されます。
• source の Result にエラーがあった場合（MIME タイプが不正であるなど）、プロミスはエラーで拒否されます。

例

ストリーミングのコンパイル

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

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

WebAssembly.compileStreaming(fetch("simple.wasm"))
  .then((module) => WebAssembly.instantiate(module, importObject))
  .then((instance) => instance.exports.exported_func());

結果として受け取ったモジュールインスタンスはその後 WebAssembly.instantiate() を使用してインスタンス化され、エクスポートされた関数が実行されます。

仕様書

ブラウザーの互換性

関連情報

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