WebAssembly.compileStreaming()

Experimental

これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

WebAssembly.compileStreaming() 関数はソースのストリームから直接 WebAssembly.Module にコンパイルします。この関数はモジュールをインスタンス化する前にコンパイルする必要がある場合に役立ちます (そうでない場合は、WebAssembly.instantiateStreaming() 関数の仕様が推奨されます)。

構文

Promise<WebAssembly.Module> WebAssembly.compileStreaming(source);

パラメータ

source: ストリーム、コンパイルする .wasm モジュールのソースコードを表す Response オブジェクトか、それを fulfill するプロミス。

戻り値

解決時にコンパイルされたモジュールを表す WebAssembly.Module を渡す Promise 。

例外

bufferSource が型付き配列でない場合、 TypeError がスローされます。
失敗した場合、プロミスは WebAssembly.CompileError を持って棄却されます。

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

var 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() を使用してインスタンス化され、エクスポートされた関数が実行されます。

仕様

Specification	Status	Comment
WebAssembly features for web embedding compileStreaming() の定義	ドラフト	初回ドラフト定義

ブラウザ実装状況

BCD tables only load in the browser