WebAssembly.Global

WebAssembly.Global()

Erstellt ein neues Global-Objekt.

Alle Global-Instanzen erben vom Prototyp-Objekt des Global()-Konstruktors — dies kann geändert werden, um alle Global-Instanzen zu beeinflussen.

Global.prototype.constructor

Gibt die Funktion zurück, die die Instanz dieses Objekts erstellt hat. Standardmäßig ist dies der WebAssembly.Global()-Konstruktor.

Global.prototype[Symbol.toStringTag]

Der anfängliche Wert der [Symbol.toStringTag]-Eigenschaft ist der String-Wert "WebAssembly.Global".

Global.prototype.value

Der in der globalen Variablen enthaltene Wert — dieser kann verwendet werden, um den Wert der globalen Variablen direkt festzulegen und abzurufen.

Global.prototype.valueOf()

Eine Methode alten Stils, die den in der globalen Variablen enthaltenen Wert zurückgibt.

Das folgende Beispiel zeigt die Erstellung einer neuen globalen Instanz mit dem WebAssembly.Global()-Konstruktor. Sie wird als veränderbarer i32-Typ definiert, mit einem Wert von 0.

Der Wert der globalen Variablen wird dann zunächst über die Global.value-Eigenschaft auf 42 geändert und anschließend auf 43 mithilfe der incGlobal()-Funktion, die aus dem global.wasm-Modul exportiert wird (diese addiert 1 zu jedem gegebenen Wert hinzu und gibt dann den neuen Wert zurück).

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

function assertEq(msg, got, expected) {
  const result =
    got === expected
      ? `SUCCESS! Got: ${got}\n`
      : `FAIL!\nGot: ${got}\nExpected: ${expected}\n`;
  output.innerText += `Testing ${msg}: ${result}`;
}

assertEq("WebAssembly.Global exists", typeof WebAssembly.Global, "function");

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

WebAssembly.instantiateStreaming(fetch("global.wasm"), { js: { global } }).then(
  ({ instance }) => {
    assertEq(
      "getting initial value from wasm",
      instance.exports.getGlobal(),
      0,
    );
    global.value = 42;
    assertEq(
      "getting JS-updated value from wasm",
      instance.exports.getGlobal(),
      42,
    );
    instance.exports.incGlobal();
    assertEq("getting wasm-updated value from JS", global.value, 43);
  },
);

• WebAssembly Übersichtsseite
• WebAssembly-Konzepte
• Verwendung der WebAssembly JavaScript-API
• Import/Export mutable globals proposal