memoryDescriptor

Ein Objekt, das die folgenden Mitglieder enthalten kann:

initial

Die anfängliche Größe des WebAssembly-Speichers, gemessen in Einheiten von WebAssembly-Seiten.

maximum Optional

Die maximale Größe, auf die der WebAssembly-Speicher wachsen darf, gemessen in Einheiten von WebAssembly-Seiten. Wenn vorhanden, wirkt der maximum Parameter als Hinweis an die Engine, im Voraus Speicher zu reservieren. Die Engine kann jedoch diese Reservierungsfrage ignorieren oder beschränken. Nicht-geteilte WebAssembly-Speicher müssen keine maximum-Größe festlegen, aber geteilte Speicher schon.

shared Optional

Ein boolescher Wert, der definiert, ob der Speicher ein geteilter Speicher ist oder nicht. Wenn auf true gesetzt, ist es ein geteilter Speicher. Die Standardeinstellung ist false.

TypeError

Wird ausgelöst, wenn mindestens eine der folgenden Bedingungen erfüllt ist:

• memoryDescriptor ist kein Objekt.
• initial ist nicht angegeben.
• shared ist vorhanden und true, aber maximum ist nicht angegeben.

RangeError

Wird ausgelöst, wenn mindestens eine der folgenden Bedingungen erfüllt ist:

• maximum ist angegeben und kleiner als initial.
• initial überschreitet 65.536 (2^16). 2^16 Seiten entsprechen 2^16 * 64KiB = 4GiB Bytes, was der maximale Bereich ist, den ein Wasm-Modul adressieren kann, da Wasm derzeit nur 32-Bit-Adressierung zulässt.
• Zuweisung schlägt fehl. Dies kann auftreten, wenn versucht wird, zu viel auf einmal zuzuweisen, oder wenn der User-Agent anderweitig keinen Speicher mehr hat.

Es gibt zwei Möglichkeiten, ein WebAssembly.Memory Objekt zu erhalten: Es aus JavaScript zu konstruieren oder es von einem WebAssembly-Modul exportieren zu lassen.

Das folgende Beispiel (siehe memory.html auf GitHub und sehen Sie es sich live an) erstellt eine neue WebAssembly Memory Instanz mit einer anfänglichen Größe von 10 Seiten (640KiB) und einer maximalen Größe von 100 Seiten (6,4MiB). Das Beispiel lädt und instanziiert das geladene memory.wasm-Bytecode mit der Funktion WebAssembly.instantiateStreaming(), während es den im obigen Zeilen erstellten Speicher importiert. Es speichert dann einige Werte in diesem Speicher, exportiert eine Funktion und verwendet die exportierte Funktion, um diese Werte zu summieren. Die buffer Eigenschaft des Memory Objekts gibt einen ArrayBuffer zurück.

const memory = new WebAssembly.Memory({
  initial: 10,
  maximum: 100,
});

WebAssembly.instantiateStreaming(fetch("memory.wasm"), {
  js: { mem: memory },
}).then((obj) => {
  const summands = new DataView(memory.buffer);
  for (let i = 0; i < 10; i++) {
    summands.setUint32(i * 4, i, true); // WebAssembly is little endian
  }
  const sum = obj.instance.exports.accumulate(0, 10);
  console.log(sum);
});

Standardmäßig sind WebAssembly-Speicher nicht geteilt. Sie können ein geteilter Speicher aus JavaScript erstellen, indem Sie shared: true im Initialisierungsobjekt des Konstruktors übergeben:

const memory = new WebAssembly.Memory({
  initial: 10,
  maximum: 100,
  shared: true,
});

Die buffer Eigenschaft dieses Speichers gibt einen SharedArrayBuffer zurück.

• WebAssembly Übersicht
• WebAssembly-Konzepte
• Verwendung der WebAssembly JavaScript API