这是一个实验中的功能
此功能某些浏览器尚在开发中，请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订，所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

`WebAssembly.instantiate()` 是编译和实例化 WebAssembly 代码的主要方法. 这个方法有两个重载方式:

- 第一种重载使用WebAssembly二进制代码的 typed array 或 ArrayBuffer 形式进行编译和实例化. 返回的 `Promise` 会携带已编译的 `WebAssembly.Module` 和它的第一个实例化对象 `WebAssembly.Instance`.
- 第二种重载使用已编译的 `WebAssembly.Module` , 返回的 `Promise` 携带一个 `Module`的实例化对象 `Instance`. 如果这个 `Module` 已经被编译了或者是从缓存中获取的( retrieved from cache), 那么这种重载方式是非常有用的.

## 语法

### 主重载方式 — 使用wasm二进制代码

    Promise<ResultObject> WebAssembly.instantiate(bufferSource, importObject);

#### 参数

bufferSource
  一个包含你想编译的wasm模块二进制代码的 typed array(类型数组) or ArrayBuffer(数组缓冲区)
importObject 可选
  一个将被导入到新创建实例中的对象，它包含的值有函数、`WebAssembly.Memory` 对象等等。编译的模块中，对于每一个导入的值都要有一个与其匹配的属性与之相对应，否则将会抛出 WebAssembly.LinkError。

#### 返回值

解析为包含两个字段的 `ResultObject` 的一个 `Promise`:

- `module`: 一个被编译好的 `WebAssembly.Module` 对象. 这个模块可以被再次实例化，通过 postMessage() 被分享，或者缓存到 IndexedDB。
- `instance`: 一个包含所有 Exported WebAssembly functions的`WebAssembly.Instance`对象。

#### 异常

- 如果参数的类型或结构不正确，将会抛出异常 `TypeError` .
- 如果操作失败，promise 将会被 reject 掉， 根据失败的原因不同，会抛出3种异常，`WebAssembly.CompileError`，`WebAssembly.LinkError`, 或`WebAssembly.RuntimeError`。

### 第二种重载 — 使用模块对象

    Promise<WebAssembly.Instance> WebAssembly.instantiate(module, importObject);

#### 参数

module
  将被实例化的 `WebAssembly.Module` 对象。
importObject 可选
  一个将被导入到新创建实例中的对象，它包含的值有函数、`WebAssembly.Memory` 对象等等。编译的模块中，对于每一个导入的值都要有一个与其匹配的属性与之相对应，否则将会抛出 WebAssembly.LinkError。

#### 返回值

一个解析为 `WebAssembly.Instance` 的`Promise` 对象。

#### 异常

- 如果参数的类型或结构不正确，将抛出异常 `TypeError` 。
- 如果操作失败，promise 将会被 reject 掉， 根据失败的原因不同，会抛出3种异常，`WebAssembly.CompileError`，`WebAssembly.LinkError`, 或`WebAssembly.RuntimeError`。

## 例子

### 第一种重载例子

使用 fetch 获取一些 WebAssembly 二进制代码后，我们使用 `WebAssembly.instantiate()` 方法编译并实例化模块，在此过程中，导入了一个 Javascript 方法在 WebAssembly 模块中， 接下来我们使用`Instance` 导出的Exported 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()
    );

注: 查看GitHub(在线实例)的 index.html 中一个相似的例子，使用了我们的`fetchAndInstantiate()`库函数

### 第二种重载例子

下面的例子（查看我们GitHub的 index-compile.html 例子，可在线演示）使用 `compile()` 方法编译了 simple.wasm 字节码，然后通过 postMessage() 发送给一个线程 worker。

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

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

在线程中 (查看 `wasm_worker.js`) 我们定义了一个导入对象供模块使用，然后设置了一个事件处理函数来接收主线程发来的模块。当模块被接收到后，我们使用`WebAssembly.instantiate()` 方法创建一个实例并且调用它从内部导出的函数。

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

    onmessage = function(e) {
      console.log('module received from main thread');
      var mod = e.data;

      WebAssembly.instantiate(mod, importObject).then(function(instance) {
        instance.exports.exported_func();
      });
    };

## Specifications

Specification | Status | Comment
--- | --- | ---
WebAssembly JavaScript Interface instantiate() | Working Draft | Initial draft definition.

## Browser compatibility

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

| Desktop | Mobile | Server
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | Android webview | Chrome for Android | Edge Mobile | Firefox for Android | Opera for Android | Safari on iOS | Samsung Internet | Node.js
`instantiate` | Chrome Full support 57 | Edge Full support 16 | Firefox Full support 52 Notes Full support 52 Notes Notes Disabled in the Firefox 52 Extended Support Release (ESR). | IE No support No | Opera Full support 44 | Safari Full support 11 | WebView Android Full support 57 | Chrome Android Full support 57 | Edge Mobile Full support Yes Disabled Full support Yes Disabled Disabled This feature is behind the `Experimental JavaScript Features` preference. | Firefox Android Full support 52 Notes Full support 52 Notes Notes Disabled in the Firefox 52 Extended Support Release (ESR). | Opera Android ? | Safari iOS Full support 11 | Samsung Internet Android Full support 7.0 | nodejs Full support 8.0.0

### Legend

Full support
  Full support
No support
  No support
Compatibility unknown
  Compatibility unknown
See implementation notes.
  See implementation notes.
User must explicitly enable this feature.
  User must explicitly enable this feature.

## See also

- WebAssembly overview page
- WebAssembly concepts
- Using the WebAssembly JavaScript API