WebAssembly.Table.prototype.set()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2017 browserübergreifend verfügbar.

Die set() Prototyp-Methode des WebAssembly.Table-Objekts ändert eine in einem bestimmten Index gespeicherte Referenz in einen anderen Wert.

In diesem Artikel

Syntax

set(index, value)

Parameter

index

Der Index der Funktionsreferenz, die Sie ändern möchten.

value

Der Wert, auf den Sie die Referenz ändern möchten. Dies muss ein Wert des Elementtyps der Tabelle sein. Abhängig vom Typ kann es eine exportierte WebAssembly-Funktion, ein JavaScript-Wrapper für eine zugrunde liegende Wasm-Funktion oder eine Host-Referenz sein.

Rückgabewert

Keiner (undefined).

Ausnahmen

Wenn index größer oder gleich Table.prototype.length ist, wird ein RangeError ausgelöst.
Wenn value nicht vom Elementtyp der Tabelle ist, wird ein TypeError ausgelöst.

Beispiele

Verwendung von Table.set

Das folgende Beispiel (siehe table2.html Quellcode und Live-Version) erstellt eine neue WebAssembly-Tabelle mit einer anfänglichen Größe von zwei Referenzen. Anschließend geben wir die Tabellenlänge und die Inhalte der beiden Indizes aus (abgerufen über Table.prototype.get()), um zu zeigen, dass die Länge zwei beträgt und die Indizes derzeit keine Funktionsreferenzen enthalten (sie geben aktuell null zurück).

js
const tbl = new WebAssembly.Table({ initial: 2, element: "anyfunc" });
console.log(tbl.length);
console.log(tbl.get(0));
console.log(tbl.get(1));

Wir erstellen dann ein Importobjekt, das eine Referenz auf die Tabelle enthält:

js
const importObj = {
  js: { tbl },
};

Abschließend laden und instanziieren wir ein Wasm-Modul (table2.wasm) mit WebAssembly.instantiateStreaming(), drucken die Tabellenlänge und rufen die zwei Funktionsreferenzen auf, die jetzt in der Tabelle gespeichert sind. Das table2.wasm-Modul fügt der Tabelle zwei Funktionsreferenzen hinzu, die beide einen einfachen Wert ausgeben (siehe Textdarstellung):

js
WebAssembly.instantiateStreaming(fetch("table2.wasm"), importObject).then(
  (obj) => {
    console.log(tbl.length);
    console.log(tbl.get(0)());
    console.log(tbl.get(1)());
  },
);

Beachten Sie, dass Sie am Ende des Zugriffsoperators einen zweiten Funktionsaufrufsoperator einfügen müssen, um die referenzierte Funktion tatsächlich aufzurufen und den darin gespeicherten Wert zu protokollieren (z. B. get(0)() anstelle von get(0)).

Dieses Beispiel zeigt, dass wir die Tabelle von JavaScript aus erstellen und darauf zugreifen, aber dieselbe Tabelle ist auch innerhalb der Wasm-Instanz sichtbar und aufrufbar.

WebAssembly Übersicht
WebAssembly-Konzepte
Verwendung der WebAssembly JavaScript-API

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden