WebAssembly.compile()

Baseline 広く利用可能 *

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年10月以降、すべてのブラウザーで利用可能です。

* この機能の一部は、対応レベルが異なる場合があります。

WebAssembly.compile() 関数は WebAssembly バイナリーコードを WebAssembly.Module の形にコンパイルします。この関数は、モジュールをインスタンス化する前にコンパイルする必要がある場合に便利です (それ以外の場合は、 WebAssembly.instantiate() 関数を使用してください)。

構文

WebAssembly.compile(bufferSource);

引数

bufferSource

コンパイルする .wasm モジュールのバイナリーコードを含む型付き配列または ArrayBuffer です。

返値

コンパイルされたモジュールを表す WebAssembly.Module オブジェクトに解決する Promise です。

例外

bufferSource が型付き配列ではなかった場合、 TypeError が発生します。
コンパイルに失敗した場合、プロミスは WebAssembly.CompileError で拒否されます。

例

compile の使用

次の例では、読み込まれた simple.wasm バイトコードを、 compile() 関数を使用してコンパイルし、ワーカーに postMessage() を用いて送信します。

js
var worker = new Worker("wasm_worker.js");

fetch("simple.wasm")
  .then((response) => response.arrayBuffer())
  .then((bytes) => WebAssembly.compile(bytes))
  .then((mod) => worker.postMessage(mod));

メモ: おそらく多くの場合は WebAssembly.compileStreaming() を使用したほうが compile() よりも効率的なのでそちらの方がいいでしょう。