WebAssembly.Memory() Konstruktor

memoryDescriptor

Ein Objekt, das die folgenden Mitglieder enthalten kann:

initial

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

maximum Optional

Die maximale Größe, auf die der WebAssembly-Speicher wachsen darf, in Einheiten von WebAssembly-Seiten. Wenn vorhanden, fungiert der Parameter maximum als Hinweis für die Engine, im Voraus Speicher zu reservieren. Die Engine kann jedoch diese Reservierungsanfrage ignorieren oder begrenzen. Ungeteilte WebAssembly-Speicher müssen kein maximum 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. Der Standardwert ist false.

TypeError

Ausgelöst, wenn mindestens eine dieser Bedingungen erfüllt ist:

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

RangeError

Ausgelöst, wenn mindestens eine dieser Bedingungen erfüllt ist:

• maximum ist angegeben und kleiner als initial.
• initial überschreitet 65.536 (2^16). 2^16 Seiten sind 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.
• Die Zuordnung schlägt fehl. Dies kann auftreten, wenn versucht wird, zu viel auf einmal zuzuweisen, oder wenn der Benutzeragent anderweitig keinen Speicher mehr hat.

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

Das folgende Beispiel (sehen Sie sich memory.html auf GitHub an und sehen Sie es sich auch live an) erstellt eine neue WebAssembly Memory-Instanz mit einer Anfangsgröße von 10 Seiten (640KiB) und einer maximalen Größe von 100 Seiten (6,4MiB). Das Beispiel lädt und instanziiert den geladenen Speicher.wasm-Bytecode mit der Funktion WebAssembly.instantiateStreaming(), während der Speicher importiert wird, der in der obigen Zeile erstellt wurde. Anschließend speichert es einige Werte in diesem Speicher, exportiert eine Funktion und verwendet die exportierte Funktion, um diese Werte zu summieren. Die Memory-Eigenschaft buffer 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 ungeteilt. Sie können einen geteilten 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 Übersichtsseite
• WebAssembly-Konzepte
• Verwendung der WebAssembly-JavaScript-API