WebAssembly.Instance() Konstruktor

Syntax

new WebAssembly.Instance(module, importObject)

Parameter

module

Das WebAssembly.Module Objekt, das instanziiert werden soll.

importObject Optional

Ein Objekt, das die Werte enthlt, die in die neu erstellte Instance importiert werden sollen, wie Funktionen oder WebAssembly.Memory Objekte. Fr jeden deklarierten Import des module muss eine passende Eigenschaft vorhanden sein, andernfalls wird ein WebAssembly.LinkError ausgelst.

Ausnahmen

• Wenn einer der Parameter nicht den korrekten Typ oder die richtige Struktur hat, wird ein TypeError ausgelst.
• Wenn die Operation fehlschlgt, wird abhngig von der Ursache des Fehlers entweder ein WebAssembly.CompileError, WebAssembly.LinkError oder WebAssembly.RuntimeError ausgelst.
• Einige Browser knnen einen RangeError auslsen, da sie die Kompilierung und Instanziierung von Wasm mit groen Puffern im UI-Thread verbieten.

Beispiele

Synchrone Instanziierung eines WebAssembly-Moduls

Die WebAssembly.Instance() Konstruktorfunktion kann aufgerufen werden, um ein gegebenes WebAssembly.Module Objekt synchron zu instanziieren, zum Beispiel:

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

fetch("simple.wasm")
  .then((response) => response.arrayBuffer())
  .then((bytes) => {
    const mod = new WebAssembly.Module(bytes);
    const instance = new WebAssembly.Instance(mod, importObject);
    instance.exports.exported_func();
  });

Der bevorzugte Weg, um eine Instance zu erhalten, ist jedoch die asynchrone Funktion WebAssembly.instantiateStreaming(), zum Beispiel so:

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

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

Spezifikationen

Browser-Kompatibilitt

Siehe auch

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