WebAssembly.instantiateStreaming()

source

Ein Response-Objekt oder ein Versprechen, das mit einem erfüllt wird und die zugrunde liegende Quelle eines Wasm-Moduls repräsentiert, das Sie streamen, kompilieren und instanziieren möchten.

importObject Optional

Ein Objekt, das die Werte enthält, die in die neu erstellte Instance importiert werden sollen, wie Funktionen oder WebAssembly.Memory-Objekte. Es muss für jeden deklarierten Import des kompilierten Moduls eine übereinstimmende Eigenschaft vorhanden sein, andernfalls wird ein WebAssembly.LinkError ausgelöst.

compileOptions Optional

Ein Objekt, das Kompilierungsoptionen enthält. Eigenschaften können umfassen:

builtins Optional

Ein Array von Strings, das die Nutzung von JavaScript builtins im kompilierten Wasm-Modul ermöglicht. Die Strings definieren die builtins, die Sie aktivieren möchten. Derzeit ist der einzige verfügbare Wert "js-string", der JavaScript-String-Builtins aktiviert.

importedStringConstants Optional

Ein String, der einen Namensraum für importierte globale String-Konstanten spezifiziert. Diese Eigenschaft muss angegeben werden, wenn Sie importierte globale String-Konstanten im Wasm-Modul verwenden möchten.

Ein Promise, das sich in ein ResultObject auflöst, welches zwei Felder enthält:

• module: Ein WebAssembly.Module-Objekt, das das kompilierte WebAssembly-Modul repräsentiert. Dieses Module kann erneut instanziiert oder über postMessage() geteilt werden.
• instance: Ein WebAssembly.Instance-Objekt, das alle Exportierten WebAssembly-Funktionen enthält.

• Falls einer der Parameter nicht den korrekten Typ oder die korrekte Struktur hat, wird ein TypeError ausgelöst.
• Wenn die Operation fehlschlägt, wird das Promise mit einem WebAssembly.CompileError, WebAssembly.LinkError oder WebAssembly.RuntimeError zurückgewiesen, je nach Grund des Fehlers.

Das folgende Beispiel (siehe unser instantiate-streaming.html Demo auf GitHub, und sehen Sie es live) streamt ein Wasm-Modul direkt aus einer zugrunde liegenden Quelle, kompiliert und instanziiert es dann, wobei das Versprechen mit einem ResultObject erfüllt wird. Da die Funktion instantiateStreaming() ein Promise für ein Response-Objekt akzeptiert, können Sie ihr direkt einen fetch()-Aufruf übergeben, und es wird die Antwort in die Funktion übergeben, wenn sie erfüllt wird.

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

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

Das ResultObject-Instanzmitglied wird dann aufgerufen, und die enthaltene exportierte Funktion aufgerufen.

Dieses Beispiel aktiviert JavaScript-String-Builtins und importierte globale String-Konstanten beim Kompilieren und Instanziieren des Wasm-Moduls mit instantiateStreaming(), bevor die exportierte main()-Funktion ausgeführt wird (die "hello world!" in die Konsole loggt). Sehen Sie es live.

const importObject = {
  // Regular import
  m: {
    log: console.log,
  },
};

const compileOptions = {
  builtins: ["js-string"], // Enable JavaScript string builtins
  importedStringConstants: "string_constants", // Enable imported global string constants
};

WebAssembly.instantiateStreaming(
  fetch("log-concat.wasm"),
  importObject,
  compileOptions,
).then((result) => result.instance.exports.main());

• WebAssembly Übersicht
• WebAssembly-Konzepte
• Verwendung der WebAssembly JavaScript API