WebAssembly

Das JavaScript-Objekt WebAssembly fungiert als Namensraum für alle mit WebAssembly verbundenen Funktionen.

Im Gegensatz zu den meisten anderen globalen Objekten ist WebAssembly kein Konstruktor (es ist kein Funktionsobjekt). Sie können es mit Math vergleichen, das ebenfalls ein Namensraumobjekt für mathematische Konstanten und Funktionen ist, oder mit Intl, das das Namensraumobjekt für Internationalisierungs-Konstruktoren und andere sprachsensible Funktionen ist.

Beschreibung

Die Hauptanwendungsbereiche für das WebAssembly-Objekt sind:

Schnittstellen

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.

Statische Methoden

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).

Beispiele

Ein Wasm-Modul streamen, kompilieren und instanziieren

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.

js
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.

Spezifikationen

Specification
WebAssembly JavaScript Interface
# webassembly-namespace

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch