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 in die neu erstellte Instance zu importierenden Werte enthält, wie z. B. Funktionen oder WebAssembly.Memory-Objekte. Es muss für jeden deklarierten Import des kompilierten Moduls eine übereinstimmende Eigenschaft geben, sonst wird ein WebAssembly.LinkError ausgelöst.

compileOptions Optional

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

builtins Optional

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

importedStringConstants Optional

Eine Zeichenfolge, die einen Namensraum für importierte globale Zeichenfolgenkonstanten spezifiziert. Diese Eigenschaft muss angegeben werden, wenn Sie in dem Wasm-Modul importierte globale Zeichenfolgenkonstanten verwenden möchten.

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

• module: Ein WebAssembly.Module-Objekt, das das kompilierte WebAssembly-Modul darstellt. 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 hat, wird ein TypeError ausgelöst.
• Wenn die Operation fehlschlägt, wird das Versprechen mit einem WebAssembly.CompileError, WebAssembly.LinkError oder WebAssembly.RuntimeError abgelehnt, abhängig von der Ursache 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 es und instanziiert es, wobei das Versprechen mit einem ResultObject erfüllt wird. Da die Funktion instantiateStreaming() ein Versprechen für ein Response-Objekt akzeptiert, können Sie direkt einen fetch()-Aufruf übergeben, der die Antwort in die Funktion übergibt, wenn es 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's instance-Element wird dann aufgerufen und die darin enthaltene exportierte Funktion wird aufgerufen.

Dieses Beispiel aktiviert JavaScript-String-builtin-Funktionen 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 protokolliert). Sehen Sie es live laufen.

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 Übersichtsseite
• WebAssembly-Konzepte
• Verwendung der WebAssembly-JavaScript-API