WebAssembly.compileStreaming()
WebAssembly.compileStreaming()
方法用来从一个流式源中直接编译一个 WebAssembly.Module
。当模块需要在被实例化前被编译时,这个方法会很有用。如果要从流式源实例化一个模块应采用 WebAssembly.instantiateStreaming()
方法。
语法
Promise<WebAssembly.Module> WebAssembly.compileStreaming(source);
参数
返回值
一个会被解决(resolve)为编译后的 WebAssembly.Module
对象的 Promise
。
异常
- 如果
bufferSource
不是一个 typed array,将会抛出TypeError
异常。 - 如果编译失败,promise 会通过拒绝(reject)来返回一个
WebAssembly.CompileError
。
示例
下面的例子(在 GitHub 上查看我们的 compile-streaming.html 示例或者直接在线预览)直接从流式源传输一个 .wasm 模块然后将其编译为一个 WebAssembly.Module
对象。因为 compileStreaming()
方法可以接受一个结果为 Response
对象的 promise,因此你可以直接用 fetch()
的调用结果来调用该方法。
js
var importObject = { imports: { imported_func: (arg) => console.log(arg) } };
WebAssembly.compileStreaming(fetch("simple.wasm"))
.then((module) => WebAssembly.instantiate(module, importObject))
.then((instance) => instance.exports.exported_func());
得到的 module 实例接下来通过 WebAssembly.instantiate()
方法被实例化了,然后调用模块导出的函数。
Specifications
Specification |
---|
WebAssembly Web API # dom-webassembly-compilestreaming |
Browser compatibility
BCD tables only load in the browser