WebAssembly

Die Hauptanwendungsbereiche für das WebAssembly-Objekt sind:

• Laden von WebAssembly-Code mit der Funktion WebAssembly.instantiate().
• Erstellen neuer Speicher- und Tabelleneinheiten über die Konstruktoren WebAssembly.Memory()/WebAssembly.Table().
• Bereitstellung von Möglichkeiten zur Behandlung von Fehlern, die in WebAssembly auftreten, über die Konstruktoren WebAssembly.CompileError()/WebAssembly.LinkError()/WebAssembly.RuntimeError().

WebAssembly.CompileError

Zeigt einen Fehler während der WebAssembly-Dekodierung oder -Validierung an.

WebAssembly.Global

Repräsentiert eine globale Variableninstanz, die sowohl von JavaScript aus zugänglich als auch importierbar/exportierbar über ein oder mehrere Instanzen von WebAssembly.Module ist. Dies ermöglicht das dynamische Verknüpfen mehrerer Module.

WebAssembly.Instance

Ist eine zustandsbehaftete, ausführbare Instanz eines WebAssembly.Module.

WebAssembly.LinkError

Zeigt einen Fehler während der Modul-Initialisierung an (außer Traps von der Startfunktion).

WebAssembly.Memory

Ein Objekt, dessen buffer-Eigenschaft ein skalierbarer ArrayBuffer ist, der die rohen Bytes des Speichers hält, auf die eine WebAssembly Instance zugreift.

WebAssembly.Module

Enthält zustandslosen WebAssembly-Code, der bereits vom Browser kompiliert wurde und effizient mit Arbeitern geteilt und mehrfach instanziiert werden kann.

WebAssembly.RuntimeError

Fehlerart, die immer dann ausgelöst wird, wenn WebAssembly eine Trap spezifiziert.

WebAssembly.Table

Eine arrayähnliche Struktur, die eine WebAssembly-Tabelle repräsentiert, welche Referenzen speichert, wie z.B. Funktionsreferenzen.

WebAssembly.Tag

Ein Objekt, das eine Art von WebAssembly-Ausnahme darstellt.

WebAssembly.Exception

Ein WebAssembly-Ausnahmeobjekt, das sowohl innerhalb als auch über WebAssembly/JavaScript-Grenzen hinweg geworfen, gefangen und erneut geworfen werden kann.

WebAssembly.instantiate()

Die primäre API für das Kompilieren und Instanziieren von WebAssembly-Code, die sowohl ein Module als auch seine erste Instance zurückgibt.

WebAssembly.instantiateStreaming()

Kompiliert und instanziiert ein WebAssembly-Modul direkt aus einer gestreamten zugrunde liegenden Quelle und gibt sowohl ein Module als auch seine erste Instance zurück.

WebAssembly.compile()

Kompiliert ein WebAssembly.Module aus WebAssembly-Binärcode und lässt die Instanziierung als separaten Schritt.

WebAssembly.compileStreaming()

Kompiliert ein WebAssembly.Module direkt aus einer gestreamten zugrunde liegenden Quelle und lässt die Instanziierung als separaten Schritt.

WebAssembly.validate()

Validiert ein gegebenes typisiertes Array von WebAssembly-Binärcode und gibt zurück, ob die Bytes gültiger WebAssembly-Code sind (true) oder nicht (false).

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

Die .instance-Eigenschaft des ResultObject wird dann aufgerufen und die enthaltene exportierte Funktion wird aufgerufen.

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