WebAssembly.instantiateStreaming() - JavaScript 编辑

WebAssembly.instantiateStreaming() 方法直接从流式底层源编译和实例化WebAssembly模块。这是加载wasm代码一种非常有效的优化方式。

Syntax

Promise<ResultObject> WebAssembly.instantiateStreaming(source, importObject);

Parameters

source

一个Response对象 或 一个可以履行（fulfill）一个（Response）的 Promise，表示你想要传输、编译和实例化的 .wasm 模块基础源。

importObject 可选

包含一些想要导入到新创建Instance中值的对象，例如方法 或  WebAssembly.Memory 对象。每个已编译模块的声明导入必须有一个匹配属性，否则抛出 WebAssembly.LinkError 异常。

Return value

一个 Promise ，通过resolve返回一个包含两个属性的 ResultObject ：

• module: WebAssembly.Module 对象表示编译完成的WebAssembly模块. 这个Module能够再次被实例化 或 通过postMessage()共享。
• instance: WebAssembly.Instance 对象包含WebAssembly所有公开方法 Exported WebAssembly functions.

Exceptions

• 如果任意参数的类型或结构错误, TypeError 抛出.
• 如果操作失败, Promise通过reject根据失败原因返回 WebAssembly.CompileError，WebAssembly.LinkError 或 WebAssembly.RuntimeError。

Examples

下面的示例 (在GitHub上查看 instantiate-streaming.html 示例, 并且也可 view it live ) 直接从基础源传输一个 .wasm 模块，然后进行编译和实例化, Promise 履行后返回一个 ResultObject. 因为 instantiateStreaming() 方法允许履行后返回Response对象的Promise，你可以直接传递一个 WindowOrWorkerGlobalScope.fetch() 请求，它会在履行后将response传递给方法.

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

WebAssembly.instantiateStreaming(fetch('simple.wasm'), importObject)
.then(obj => obj.instance.exports.exported_func());

然后访问ResultObject的实例成员，并调用包含的公开函数。

Specifications

Specification	Status	Comment
WebAssembly features for web embedding instantiateStreaming()	Draft	Initial draft definition.

Browser compatibility

BCD tables only load in the browser

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.

See also

• WebAssembly overview page
• WebAssembly concepts
• Using the WebAssembly JavaScript API
• Promise
• 使用Fetch