Constructeur WebAssembly.Memory()

Syntaxe

new WebAssembly.Memory(descripteurMemoire);

Paramtres

descripteurMemoire

Un objet contenant les proprits suivantes :

initial

La taille initiale de la mmoire WebAssembly Memory, exprime en nombre de pages WebAssembly.

maximum Facultatif

La taille maximale que peut atteindre la mmoire WebAssembly, exprime en nombre de pages WebAssembly. Lorsque ce paramtre est prsent, il peut tre utilis comme indication par le moteur afin de rserver la mmoire d'avance. Toutefois, le moteur pourra ignorer cette rservation ou l'effectuer avec une taille moindre. Les mmoires WebAssembly qui ne sont pas partages n'ont pas besoin de dfinir une proprit maximum, en revanche, c'est une proprit ncessaire pour les mmoires partages.

shared Facultatif

Une valeur boolenne qui dfinit si la mmoire est partage ou non. Si elle vaut true, il s'agira d'une mmoire partage. La valeur par dfaut est false.

Exceptions

• Si descripteurMemoire n'est pas un objet, une exception TypeError sera leve.
• Si maximum est indiqu et est infrieur initial, une exception RangeError sera leve.

Exemples

Crer une nouvelle instance Memory

Il existe deux faons d'obtenir un objet WebAssembly.Memory. La premire consiste la construire depuis du code JavaScript. Dans l'exemple qui suit, on cre une nouvelle instance d'un objet Memory WebAssembly avec une taille initiale de 10 pages (640Ko) et une taille maximale de 100 pages (6,4Mo). Sa proprit buffer renverra un objet ArrayBuffer.

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

La deuxime mthode pour obtenir un objet WebAssembly.Memory consiste l'exporter depuis un module WebAssembly. Dans l'exemple suivant (voir memory.html sur GitHub pour le code source, ainsi que la dmonstration correspondante), on rcupre et on instancie le bytecode charg memory.wasm avec la mthode WebAssembly.instantiateStreaming() tout en important la mmoire cre la ligne prcdente. On stocke ensuite certaines valeurs dans cette mmoire et on exporte une fonction qu'on utilise pour additionner certaines des valeurs.

WebAssembly.instantiateStreaming(fetch("memory.wasm"), {
  js: { mem: memory },
}).then((obj) => {
  var i32 = new Uint32Array(memory.buffer);
  for (var i = 0; i < 10; i++) {
    i32[i] = i;
  }
  var sum = obj.instance.exports.accumulate(0, 10);
  console.log(sum);
});

Crer une mmoire partage

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

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

La proprit buffer de l'objet mmoire correspondant renverra alors un objet SharedArrayBuffer.

Spcifications

Compatibilit des navigateurs

Voir aussi

• La page WebAssembly
• Concepts WebAssembly
• Utiliser l'API JavaScript WebAssembly