WebAssembly.Table()

descripteurTableau

Un objet composé des propriétés qui suivent :

element

Une chaîne de caractères qui représente le type de référence enregistrée dans le tableau. Actuellement, la seule valeur possible est "anyfunc" (pour indiquer des fonctions).

initial

La longueur initiale du tableau WebAssembly. Cela correspond au nombre d'éléments contenus dans le tableau.

maximum Facultatif

La taille maximale que pourra avoir tableau WebAssembly s'il est étendu.

• Si tableDescriptor n'est pas un objet, une exception TypeError sera levée.
• Si maximum est défini et est inférieur à initial, une exception RangeError sera levée.

Toutes les instances Table héritent des propriétés du prototype du constructeur Table(). Ce dernier peut être utilisé afin de modifier l'ensemble des instances Table.

Table.prototype.constructor

Renvoie la fonction qui a créé l'instance. Par défaut, c'est le constructeur WebAssembly.Table().

Table.prototype.length

Renvoie la longueur du tableau, c'est-à-dire le nombre de références qui sont enregistrées dans le tableau.

Table.prototype.get()

Une fonction d'accès qui permet d'obtenir l'élément du tableau situé à une position donnée.

Table.prototype.grow()

Cette méthode permet d'augmenter la taille du tableau Table d'un incrément donné.

Table.prototype.set()

Cette méthode permet de modifier un élément du tableau situé à une position donnée.

Dans l'exemple qui suit (tiré du fichier table2.html et qui dispose d'une démonstration), on crée une nouvelle instance d'un tableau WebAssembly avec une taille initiale permettant de stocker 2 références. Ensuite, on imprime la longueur du tableau et le contenu des deux éléments (obtenus grâce à la méthode Table.prototype.get() afin de montrer que la longueur vaut 2 et que le tableau ne contient encore aucune référence de fonction (pour les deux positions, on a la valeur null).

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

Ensuite, on crée un objet d'import qui contient une référence au tableau :

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

Enfin, on charge et on instancie un module WebAssembly (table2.wasm) grâce à la fonction WebAssembly.instantiateStreaming(). Le module table2.wasm a ajouté deux références de fonctions (cf. sa représentation textuelle). Chacune de ces fonctions fournit une valeur simple :

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

On voit ici qu'il faut d'abord récupérer la fonction puis effectuer une invocation pour obtenir la valeur correspondante à partir de l'accesseur (autrement dit, on écrit get(0)() plutôt que get(0) pour obtenir le résultat de la fonction) .

Dans cet exemple, on voit comment créer et manipuler le tableau depuis du code JavaScript mais ce même tableau est également accessible depuis l'instance WebAssembly.

• Le portail WebAssembly
• Les concepts relatifs à WebAssembly
• Utiliser l'API JavaScript WebAssembly