WebAssembly.Global

WebAssembly.Global()

Crée un nouvel objet Global.

Toutes les instances de Global héritent du prototype du constructeur Global(), ce dernier peut être modifié afin de modifier le comportement de l'ensemble des instances Global.

Global.prototype.constructor

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

Global.prototype[@@toStringTag]

La valeur initiale de la propriété @@toStringTag est la chaîne de caractères "WebAssembly.Global".

Global.prototype.value

La valeur contenue au sein de la variable globale. Elle peut être utilisée pour récupérer ou modifier la valeur de la variable globale.

Global.prototype.valueOf()

Une méthode ancienne qui renvoie la valeur contenue au sein de la variable globale.

Dans l'exemple suivant, on montre comment créer une nouvelle instance globale grâce au constructeur WebAssembly.Global(). Cette instance globale est définie avec le type i32 et est indiquée comme modifiable. Sa valeur initiale est 0.

On change ensuite la valeur de la variable globale en la passant à 42 grâce à la propriété Global.value puis en la passant à 43 grâce à la fonction incGlobal() qui a été exportée depuis le module global.wasm (cette fonction ajoute 1 à n'imorte quelle valeur puis renvoie cette nouvelle valeur).

const output = document.getElementById("output");

function assertEq(msg, res, attendu) {
  output.innerHTML += `Test ${msg} : `;
  if (res !== attendu)
    output.innerHTML += `ÉCHEC !<br>Résultat : ${res}<br>Attendu : ${attendu}<br>`;
  else output.innerHTML += `SUCCÈS ! Résultat : ${res}<br>`;
}

assertEq(
  "Existence de WebAssembly.Global",
  typeof WebAssembly.Global,
  "function",
);

const global = new WebAssembly.Global({ value: "i32", mutable: true }, 0);

WebAssembly.instantiateStreaming(fetch("global.wasm"), { js: { global } }).then(
  ({ instance }) => {
    assertEq(
      "Obtention de la valeur initiale depuis wasm",
      instance.exports.getGlobal(),
      0,
    );
    global.value = 42;
    assertEq(
      "Obtention de la valeur mise à jour en JS depuis wasm",
      instance.exports.getGlobal(),
      42,
    );
    instance.exports.incGlobal();
    assertEq(
      "Obtention de la valeur mise à jour côté wasm en JS",
      global.value,
      43,
    );
  },
);

• Aperçu de WebAssembly
• Concepts WebAssembly
• Utiliser l'API JavaScript WebAssembly
• Proposition d'import/export pour les variables globales mutables