WebAssembly.Memory.prototype.grow()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2017.
La méthode grow()
, rattachée au prototype de l'objet Memory
, permet d'augmenter la taille de l'espace mémoire correspondant d'un nombre de pages WebAssembly.
Syntaxe
memory.grow(nombre);
Paramètres
nombre
-
Le nombre de pages WebAssembly duquel on veut augmenter l'espace mémoire correspondant à l'objet courant (une page mémoire WebAssembly correspond à 64 Ko).
Valeur de retour
La taille de l'espace mémoire avant l'extension, exprimée en nombre de pages WebAssembly.
Exemples
Dans le code qui suit, on crée une instance de Memory
qui mesure initialement 1 page (soit 64 Ko) et dont la taille maximale est de 10 pages (soit 6,4 Mo).
var memory = new WebAssembly.Memory({ initial: 10, maximum: 100 });
Ensuite, on augmente la taille de l'espace mémoire d'une page grâce à la méthode :
const bytesPerPage = 64 * 1024;
console.log(memory.buffer.byteLength / bytesPerPage); // "1"
console.log(memory.grow(1)); // "1"
console.log(memory.buffer.byteLength / bytesPerPage); // "2"
On voit ici que la valeur de grow()
indique l'espace utilisé avant l'agrandissement de la mémoire.
Spécifications
Specification |
---|
WebAssembly JavaScript Interface # dom-memory-grow |
Compatibilité des navigateurs
BCD tables only load in the browser