WebAssembly.Global()-Konstruktor

descriptor

Ein Objekt, das zwei Eigenschaften enthält:

• value: Ein String, der den Datentyp der globalen Variablen darstellt. Dies kann einer der folgenden sein:
  • i32: Ein 32-Bit-Integer.
  • i64: Ein 64-Bit-Integer. (In JavaScript wird dies als BigInt dargestellt.)
  • f32: Eine 32-Bit-Gleitkommazahl.
  • f64: Eine 64-Bit-Gleitkommazahl.
  • v128: Ein 128-Bit-Vektor.
  • externref: Eine Host-Referenz.
  • anyfunc: Eine Funktionsreferenz.
• mutable: Ein booleanischer Wert, der bestimmt, ob die globale Variable änderbar ist oder nicht. Standardmäßig ist dies false.

value

Der Wert, den die Variable enthält. Dieser kann beliebig sein, solange sein Typ dem Datentyp der Variablen entspricht. Wenn kein Wert angegeben ist, wird ein typisierter Wert von 0 verwendet, wenn der Wert von descriptor.value einer der folgenden ist: i32, i64, f32 oder f64; und null wird verwendet, wenn descriptor.value externref oder anyfunc ist (wie im DefaultValue-Algorithmus festgelegt).

Das folgende Beispiel zeigt, wie eine neue globale Instanz mit dem WebAssembly.Global()-Konstruktor erstellt wird. Sie wird als veränderbarer i32-Typ definiert, mit einem Wert von 0.

Der Wert der globalen Variable wird dann zuerst auf 42 mit der Global.value-Eigenschaft und dann auf 43 mittels der incGlobal()-Funktion geändert, die aus dem global.wasm-Modul exportiert wird (dies addiert 1 zu jedem gegebenen Wert 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-Proposal für veränderbare globale Variablen