WebAssembly.Global() Konstruktor

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2020 browserübergreifend verfügbar.

Ein WebAssembly.Global()-Konstruktor erstellt ein neues Global-Objekt, das eine globale Variableninstanz darstellt, die sowohl von JavaScript aus zugänglich ist als auch über eine oder mehrere WebAssembly.Module-Instanzen importierbar/exportierbar ist. Dies ermöglicht die dynamische Verknüpfung mehrerer Module.

In diesem Artikel

Syntax

new WebAssembly.Global(descriptor, value)

Parameter

descriptor

Ein Objekt, das zwei Eigenschaften enthält:

value

Ein String, der den Datentyp der globalen Variable 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.
funcref
externref

mutable

Ein boolescher Wert, der bestimmt, ob die globale Variable veränderbar ist oder nicht. Standardmäßig ist dies false.

value

Der Wert, den die Variable enthält. 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 der Wert von descriptor.value einer der i32, i64, f32 oder f64 ist, und null, wenn descriptor.value externref oder anyfunc ist.

Beispiele

Erstellen einer neuen Global-Instanz

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 geändert, zuerst auf 42 mit der Global.value-Eigenschaft, und dann auf 43 unter Verwendung der incGlobal()-Funktion, die aus dem global.wasm-Modul exportiert wird (diese fügt dem gegebenen Wert 1 hinzu und gibt dann den neuen Wert zurück).

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

Hinweis: Sie können das Beispiel live auf GitHub ausführen; sehen Sie sich auch den Quellcode an.

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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden