WebAssembly

WebAssembly JavaScript オブジェクトは全ての WebAssembly に関連する機能の名前空間として振る舞います。

他のグローバルオブジェクトとは異なり、WebAssembly はコンストラクタではありません (関数オブジェクトではない) 。数学定数、関数の名前空間である Math や 、国際化コンストラクタと他の言語に依存する関数のための Intl と同等のものです。

概要

WebAssembly オブジェクトの主な用途は次のとおりです:

• WebAssembly.instantiate() 関数を用いて WebAssembly コードをロードします。
• WebAssembly.Memory()/WebAssembly.Table() コンストラクタ経由で新しいメモリやテーブルを生成します。
• WebAssembly.CompileError()/WebAssembly.LinkError()/WebAssembly.RuntimeError() コンストラクタを経由して、WebAssembly で発生するエラーを処理する機能を提供します、

メソッド

WebAssembly.instantiate()

WebAssembly コードをコンパイル、インスタンス化するための主要な API で、 Module と、その最初の Instance を返します。

WebAssembly.instantiateStreaming()

ソースのストリームから直接 WebAssembly モジュールをコンパイル、インスタンス化し、 Module と、その最初の Instance を返します。

WebAssembly.compile()

WebAssembly.Module を用いて WebAssembly バイナリコードからコンパイルします。インスタンス化は別ステップとして分離されます。

WebAssembly.compileStreaming()

ソースのストリームから直接 WebAssembly.Module にコンパイルします。インスタンス化は別ステップとして分離されます。

WebAssembly.validate()

WebAssembly バイナリコードの型付き配列を検証し、バイト列が有効な WebAssembly コードか (true) 否か (false) を返します。

コンストラクタ

WebAssembly.Module()

新しい WebAssembly Module オブジェクトを生成します。

WebAssembly.Instance()

新しい WebAssembly Instance オブジェクトを生成します。

WebAssembly.Memory()

新しい WebAssembly Memory オブジェクトを生成します。

WebAssembly.Table()

新しい WebAssembly Table オブジェクトを生成します。

WebAssembly.CompileError()

新しい WebAssembly CompileError オブジェクトを生成します。

WebAssembly.LinkError()

新しい WebAssembly LinkError オブジェクトを生成します。

WebAssembly.RuntimeError()

新しい WebAssembly RuntimeError オブジェクトを生成します。

例

fetch を使用して WebAssembly バイトコードをフェッチした後、WebAssembly.instantiate() 関数を使用してモジュールをコンパイル、インスタンス化します。その過程で、WebAssembly モジュールに JavaScript の関数をインポートします。このプロミスは解決時に Module と Instance を含むオブジェクト (result) を渡します。次に、Instance からエクスポートされている エクスポートされた WebAssembly 関数 を呼び出します。

var importObject = {
  imports: {
    imported_func: function(arg) {
      console.log(arg);
    }
  }
};

fetch('simple.wasm').then(response =>
  response.arrayBuffer()
).then(bytes =>
  WebAssembly.instantiate(bytes, importObject)
).then(result =>
  result.instance.exports.exported_func()
);

仕様

ブラウザ実装状況

関連情報

• WebAssembly overview page
• WebAssembly のコンセプト
• WebAssembly JavaScript API を使用する