WebAssembly.instantiateStreaming()

source

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

importObject Optional

Ein Objekt, das die Werte enthält, die in das neu erstellte Instance importiert werden sollen, wie z.B. Funktionen oder WebAssembly.Memory-Objekte. Es muss eine passende Eigenschaft für jeden deklarierten Import des kompilierten Moduls geben, ansonsten wird ein WebAssembly.LinkError geworfen.

Ein Promise, das auf 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.

• Wenn einer der Parameter nicht den korrekten Typ oder die korrekte Struktur aufweist, wird ein TypeError geworfen.
• Wenn der Vorgang fehlschlägt, wird das Versprechen mit einem WebAssembly.CompileError, WebAssembly.LinkError oder WebAssembly.RuntimeError abgelehnt, abhängig von der Ursache des Fehlers.

Im folgenden Beispiel (siehe unser instantiate-streaming.html-Demo auf GitHub, und sehen Sie es sich live an auch) wird ein Wasm-Modul direkt aus einer zugrunde liegenden Quelle gestreamt, dann kompiliert und instanziiert. Das Versprechen wird mit einem ResultObject erfüllt. Da die Funktion instantiateStreaming() ein Versprechen für ein Response-Objekt akzeptiert, können Sie ihr direkt einen fetch()-Aufruf übergeben, und sie 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 darin enthaltene exportierte Funktion ausgeführt.

• Überblick über WebAssembly
• WebAssembly-Konzepte
• Verwendung der WebAssembly-JavaScript-API