WebAssembly.Global() Konstruktor

Syntax

new WebAssembly.Global(descriptor, value)

Parameter

descriptor

Ein Objekt, das zwei Eigenschaften enthlt:

value

Ein String, der den Datentyp der Globalen 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-Fliekommazahl.
• f64: Eine 64-Bit-Fliekommazahl.
• funcref
• externref

mutable

Ein boolescher Wert, der bestimmt, ob die globale Variable vernderbar ist oder nicht. Standardmig ist dies false.

value

Der Wert, den die Variable enthlt. Dies kann jeder Wert sein, solange sein Typ mit dem Datentyp der Variablen bereinstimmt. Wenn kein Wert angegeben ist:

• wird ein typisiertes 0 verwendet, wenn descriptor.value i32, i64, f32 oder f64 ist
• wird ein Verweis auf undefined verwendet, wenn descriptor.value externref ist
• wird null verwendet, wenn descriptor.value funcref ist

Ausnahmen

TypeError

Wird ausgelst, wenn eine der folgenden Bedingungen erfllt ist:

• descriptor ist kein Objekt.
• descriptor.value fehlt oder ist kein gltiger Werttyp (wie zum Beispiel "v128").
• value ist angegeben, kann aber nicht in den von descriptor.value benannten WebAssembly-Typ konvertiert werden.

Beispiele

Erstellen einer neuen Global-Instanz

Das folgende Beispiel zeigt eine neue globale Instanz, die mit dem WebAssembly.Global()-Konstruktor erstellt wird. Es wird als vernderbarer i32 Typ mit einem Wert von 0 definiert.

Der Wert der globalen Variable wird dann gendert, zuerst auf 42 mit der Global.value-Eigenschaft und dann auf 43 mit der incGlobal()-Funktion, die aus dem global.wasm-Modul exportiert wird (dies addiert 1 zu dem gegebenen Wert und gibt dann den neuen Wert zurck).

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);
  },
);

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• global Definition
• WebAssembly bersicht
• WebAssembly Konzepte
• Verwendung der WebAssembly-JavaScript-API