From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../webassembly/instantiatestreaming/index.html | 85 ++++++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 files/zh-cn/web/javascript/reference/global_objects/webassembly/instantiatestreaming/index.html (limited to 'files/zh-cn/web/javascript/reference/global_objects/webassembly/instantiatestreaming') diff --git a/files/zh-cn/web/javascript/reference/global_objects/webassembly/instantiatestreaming/index.html b/files/zh-cn/web/javascript/reference/global_objects/webassembly/instantiatestreaming/index.html new file mode 100644 index 0000000000..f6698d9862 --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/webassembly/instantiatestreaming/index.html @@ -0,0 +1,85 @@ +--- +title: WebAssembly.instantiateStreaming() +slug: Web/JavaScript/Reference/Global_Objects/WebAssembly/instantiateStreaming +translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/instantiateStreaming +--- +
{{JSRef}}
+ +

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

+ +

Syntax

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

Parameters

+ +
+
source
+
一个{{domxref("Response")}}对象 或 一个可以履行（fulfill）一个（Response）的 {{jsxref("Promise")}}，表示你想要传输、编译和实例化的 .wasm 模块基础源。
+
importObject {{optional_inline}}
+
包含一些想要导入到新创建Instance中值的对象，例如方法 或  {{jsxref("WebAssembly.Memory")}} 对象。每个已编译模块的声明导入必须有一个匹配属性，否则抛出 WebAssembly.LinkError 异常。
+
+ +

Return value

+ +

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

+ + + +

Exceptions

+ + + +

Examples

+ +

下面的示例 (在GitHub上查看 instantiate-streaming.html 示例, 并且也可 view it live ) 直接从基础源传输一个 .wasm 模块，然后进行编译和实例化, Promise 履行后返回一个 ResultObject. 因为 instantiateStreaming() 方法允许履行后返回{{domxref("Response")}}对象的Promise，你可以直接传递一个 {{domxref("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

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('WebAssembly Embedding', '#webassemblyinstantiatestreaming', 'instantiateStreaming()')}}{{Spec2('WebAssembly Embedding')}}Initial draft definition.
+ +

Browser compatibility

+ +
+ + +

{{Compat("javascript.builtins.WebAssembly.instantiateStreaming")}}

+
+ +

See also

+ + -- cgit v1.2.3-54-g00ecf