WebAssembly.Memory()

Constructeur

WebAssembly.Memory()

Cre un nouvel objet Memory.

Proprits d'instance

Memory.prototype.buffer Lecture seule

Retourne le tampon contenu dans la mmoire.

Mthodes d'instance

Memory.prototype.grow()

Augmente la taille de l'instance de mmoire d'un nombre dfini de pages WebAssembly (chacune de 64 KiB). Dtache le buffer prcdent.

Exemples

Crer un nouvel objet Memory

Il existe deux faons d'obtenir un objet WebAssembly.Memory. La premire consiste le construire partir de JavaScript. L'extrait suivant cre une nouvelle instance de mmoire WebAssembly avec une taille initiale de 10 pages (640 KiB) et une taille maximale de 100 pages (6,4 MiB). Sa proprit buffer retourne un ArrayBuffer.

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

L'exemple suivant (voir memory.html (angl.) sur GitHub, et la voir en direct (angl.)) rcupre et instancie le code binaire charg  memory.wasm  en utilisant la fonction WebAssembly.instantiateStreaming(), tout en important la mmoire cre la ligne ci-dessus. Il stocke ensuite des valeurs dans cette mmoire, exporte une fonction, et utilise la fonction exporte pour additionner ces valeurs. Notez l'utilisation de DataView pour accder la mmoire afin d'utiliser toujours le format petit-boutiste.

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 est petit boutiste
  }
  const sum = obj.instance.exports.accumulate(0, 10);
  console.log(sum);
});

Une autre faon d'obtenir un objet WebAssembly.Memory est de l'avoir export par un module WebAssembly. Cette mmoire peut tre accde dans la proprit exports de l'instance WebAssembly (aprs que la mmoire ait t exporte dans le module WebAssembly). L'exemple suivant importe une mmoire exporte depuis WebAssembly avec le nom memory, puis affiche le premier lment de la mmoire, interprt comme un Uint32Array.

WebAssembly.instantiateStreaming(fetch("memory.wasm")).then((obj) => {
  const values = new DataView(obj.instance.exports.memory.buffer);
  console.log(values.getUint32(0, true));
});

Crer une mmoire partage

Par dfaut, les mmoires WebAssembly ne sont pas partages. Vous pouvez crer une mmoire partage depuis JavaScript en passant shared: true dans l'objet d'initialisation du constructeur :

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

La proprit buffer de cette mmoire retournera un objet SharedArrayBuffer.

Spcifications

Compatibilit des navigateurs

webassembly.api.Memory

webassembly.multiMemory

Voir aussi

• Un aperu de WebAssembly
• Les concepts associs WebAssembly
• Utiliser l'API JavaScript WebAssembly