WebAssembly.Table

WebAssembly.Table()

Erstellt ein neues Table-Objekt.

Table.prototype.length Schreibgeschützt

Gibt die Länge der Tabelle zurück, d.h. die Anzahl der Elemente in der Tabelle.

Table.prototype.get()

Zugriffsfunktion — erhält das Element, das an einem gegebenen Index gespeichert ist.

Table.prototype.grow()

Erhöht die Größe der Table-Instanz um eine bestimmte Anzahl von Elementen.

Table.prototype.set()

Setzt ein Element, das an einem gegebenen Index gespeichert ist, auf einen gegebenen Wert.

Das folgende Beispiel (siehe table2.html Quelltext und Live-Version) erstellt eine neue WebAssembly-Table-Instanz mit einer Anfangsgröße von 2 Elementen. Wir geben dann die Tabellenlänge und die Inhalte der beiden Indizes aus (abgerufen über Table.prototype.get()), um zu zeigen, dass die Länge zwei ist und beide Elemente null sind.

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

Anschließend erstellen wir ein Import-Objekt, das die Tabelle enthält:

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

Zum Schluss laden und instanziieren wir ein Wasm-Modul (table2.wasm) mit der Methode WebAssembly.instantiateStreaming(). Das table2.wasm Modul enthält zwei Funktionen (eine, die 42 und eine, die 83 zurückgibt) und speichert beide in den Elementen 0 und 1 der importierten Tabelle (siehe Textdarstellung). Nach der Instanziierung hat die Tabelle immer noch die Länge 2, aber die Elemente enthalten nun aufrufbare Exportierte WebAssembly-Funktionen, die wir aus JS aufrufen können.

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 Accessors einen zweiten Funktionsaufrufs-Operator hinzufügen müssen, um die referenzierte Funktion tatsächlich aufzurufen und den darin gespeicherten Wert zu protokollieren (z.B. get(0)() statt get(0)).

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

• WebAssembly Übersichtsseite
• WebAssembly-Konzepte
• Die WebAssembly JavaScript API verwenden