WebAssembly.instantiateStreaming()

source

一個Response 物件或一個將以一個物件為結果的承諾，表示要流式傳輸、編譯和例項化的 Wasm 模組的底層原始碼。

importObject 可選

一個包含要匯入到新建立的 Instance 中的值的物件，例如函式或WebAssembly.Memory 物件。每個宣告的匯入的已編譯模組都必須有一個匹配的屬性，否則將丟擲WebAssembly.LinkError。

一個Promise，它解析為一個ResultObject，其中包含兩個欄位

• module: 一個WebAssembly.Module 物件，表示已編譯的 WebAssembly 模組。此 Module 可以再次例項化，也可以透過postMessage() 共享。
• instance: 一個WebAssembly.Instance 物件，其中包含所有匯出的 WebAssembly 函式。

• 如果任一引數的型別或結構不正確，則會丟擲TypeError。
• 如果操作失敗，承諾將拒絕並丟擲一個WebAssembly.CompileError、WebAssembly.LinkError 或WebAssembly.RuntimeError，具體取決於失敗的原因。

以下示例（請參閱我們在 GitHub 上的instantiate-streaming.html 演示，以及即時檢視它）直接從底層原始碼流式傳輸 Wasm 模組，然後對其進行編譯和例項化，承諾將以一個 ResultObject 為結果。因為 instantiateStreaming() 函式接受一個針對Response 物件的承諾，所以您可以直接將其傳遞給fetch() 呼叫，它將在承諾完成時將響應傳遞到函式中。

const importObject = {
  my_namespace: { imported_func: (arg) => console.log(arg) },
};

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

然後訪問 ResultObject 的例項成員，並呼叫其中包含的匯出的函式。

• WebAssembly 概述頁面
• WebAssembly 概念
• 使用 WebAssembly JavaScript API