Constructeur WebAssembly.Table()

Syntaxe

new WebAssembly.Table(descripteurTable);

Paramtres

descripteurTable

Un objet qui peut contenir les proprits suivantes :

element

Une chane de caractres reprsentant le type de valeur stocker dans la table. Pour le moment, sa valeur ne peut tre que "anyfunc" (indiquant les fonctions).

initial

Le nombre initial d'lments dans la table WebAssembly.

maximum Facultatif

Le nombre maximal d'lments jusqu'auquel la table WebAssembly peut grandir.

Exceptions

• Si descripteurTable n'est pas un objet, une exception TypeError sera leve.
• Si maximum est fourni et est infrieur initial, une exception RangeError sera leve.

Exemples

Crer une nouvelle instance d'une Table WebAssembly

Dans l'exemple suivant (voir le code source et la dmo live correspondants), on cre une nouvelle instance d'une table WebAssembly avec une taille initiale de 2 lments. On affiche alors la longueur de la table et son contenu (grce Table.prototype.get() pour montrer que la longueur vaut 2 et que les deux lments sont null.

var 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"

On peut ensuite crer un objet d'import qui contient la table :

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

Enfin, on charge et on instancie un module WASM (table2.wasm) en utilisant la mthode WebAssembly.instantiateStreaming(). Le module table2.wasm contient deux fonctions (une qui renvoie 42 et l'autre qui renvoie 83) et on stocke ces deux fonctions dans les lments 0 et 1 de la table importe (voir la reprsentation textuelle). Ainsi, aprs l'instanciation, la table a toujours une longueur qui vaut 2 et les lments contiennent dsormais des fonctions WebAssembly exportes qu'on peut appeler depuis le code JavaScript.

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

On notera qu'il faut inclure une deuxime paire de parenthses afin d'invoquer la fonction rfrence et d'afficher la valeur qui y est stocke (on crit donc get(0)() plutt que get(0)) .

Dans cet exemple, on illustre la cration et l'accs la table depuis du code JavaScript, mais cette mme table est visible depuis l'instance WASM galement.

Spcifications

Compatibilit des navigateurs

Voir aussi

• La page WebAssembly
• Concepts WebAssembly
• Utiliser l'API JavaScript WebAssembly