Constructeur WebAssembly.Memory()

Syntaxe

new WebAssembly.Memory(descripteurMemoire);

Paramètres

descripteurMemoire

Un objet contenant les propriétés suivantes :

initial

La taille initiale de la mémoire WebAssembly Memory, exprimée en nombre de pages WebAssembly.

maximum Facultatif

La taille maximale que peut atteindre la mémoire WebAssembly, exprimée en nombre de pages WebAssembly. Lorsque ce paramètre est présent, il peut être utilisé comme indication par le moteur afin de réserver la mémoire d'avance. Toutefois, le moteur pourra ignorer cette réservation ou l'effectuer avec une taille moindre. Les mémoires WebAssembly qui ne sont pas partagées n'ont pas besoin de définir une propriété maximum, en revanche, c'est une propriété nécessaire pour les mémoires partagées.

shared Facultatif

Une valeur booléenne qui définit si la mémoire est partagée ou non. Si elle vaut true, il s'agira d'une mémoire partagée. La valeur par défaut est false.

Exceptions

• Si descripteurMemoire n'est pas un objet, une exception TypeError sera levée.
• Si maximum est indiqué et est inférieur à initial, une exception RangeError sera levée.

Exemples

Créer une nouvelle instance Memory

Il existe deux façons d'obtenir un objet WebAssembly.Memory. La première consiste à la construire depuis du code JavaScript. Dans l'exemple qui suit, on crée 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 propriété buffer renverra un objet ArrayBuffer.

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

La deuxième méthode 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 démonstration correspondante), on récupère et on instancie le bytecode chargé memory.wasm avec la méthode WebAssembly.instantiateStreaming() tout en important la mémoire créée à la ligne précédente. On stocke ensuite certaines valeurs dans cette mémoire 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);
});

Créer une mémoire partagée

Par défaut, les mémoires WebAssembly ne sont pas partagées. On peut créer une mémoire partagée en passant shared: true dans l'objet d'initialisation du constructeur :

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

La propriété buffer de l'objet mémoire correspondant renverra alors un objet SharedArrayBuffer.

Spécifications

Compatibilité des navigateurs

Voir aussi

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