WebAssembly.Instance オブジェクトはステートフルで、実行可能な Module のインスタンスです。Instance オブジェクトには JavaScript から WebAssembly コードを呼び出すことを許可された エクスポートされたWebAssembly関数 が含まれます。
WebAssembly.Instance() コンストラクタ関数は同期的に WebAssembly.Module オブジェクトをインスタンス化することができます。しかし、主な Instance の取得方法は非同期の WebAssembly.instantiate() 関数を使用する方法です。
コンストラクタ構文
重要: 巨大なモジュールのインスタンス化は高コストになる可能性があります。開発者は絶対に必要な場合にのみ同期的な Instance() コンストラクタを使用すべきです。他のすべての場合で非同期の WebAssembly.instantiate() メソッドの仕様が推奨されます。
var myInstance = new WebAssembly.Instance(module, importObject);
パラメータ
- module
- インスタンス化する
WebAssembly.Moduleオブジェクト。 - importObject Optional
- 関数や
WebAssembly.Memoryオブジェクトなどの新しく生成されるInstanceにインポートされる値を持つオブジェクト。モジュール内で宣言されたインポートそれぞれに対応するプロパティが存在する必要があります。そうでない場合、WebAssembly.LinkError がスローされます。
Instance インスタンス
全ての Instance インスタンスは Instance() コンストラクタの プロトタイプオブジェクト を継承します。これは全ての Instance インスタンスに影響するように変更可能です。
インスタンスプロパティ
Instance.prototype.constructor- このオブジェクトのインスタンスを生成した関数を返します。デフォルトでは
WebAssembly.Instance()コンストラクタです。 Instance.prototype.exports読取専用- WebAssembly モジュールインスタンスからエクスポートされた全ての関数をメンバとして持つオブジェクトを返します。これらは、JavaScriptからアクセスして使用することができます。
インスタンスメソッド
なし。
仕様
| 仕様 | 策定状況 | コメント |
|---|---|---|
| WebAssembly JavaScript Interface Instance の定義 |
草案 | 初回ドラフト定義。 |
ブラウザ実装状況
| 機能 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| 基本対応 | 57 | 16 | 522 | なし | 44 | 11 |
exports | 57 | 16 | 522 | なし | 44 | 11 |
prototype | 57 | 16 | 522 | なし | 44 | 11 |
| 機能 | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| 基本対応 | 57 | 57 | あり1 | 522 | ? | 11 | 7.0 |
exports | 57 | 57 | あり1 | 522 | ? | 11 | 7.0 |
prototype | 57 | 57 | あり1 | 522 | ? | 11 | 7.0 |
1. This feature is behind the Experimental JavaScript Features preference.
2. Disabled in the Firefox 52 Extended Support Release (ESR).
関連情報
- WebAssembly overview page
- WebAssembly のコンセプト
- WebAssembly JavaScript API を使用する