HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
All web technology
Learn web development
Discover our tools
Get to know MDN better
Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
View in English Always switch to English
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2017.
Le constructeur WebAssembly.Memory() permet de créer un nouvel objet Memory dont la propriété buffer est un tableau tampon ArrayBuffer redimensionnable ou un SharedArrayBuffer contenant les octets bruts de mémoire à laquelle accède une Instance WebAssembly.
WebAssembly.Memory()
Memory
buffer
ArrayBuffer
SharedArrayBuffer
Instance
Une mémoire créée par du code JavaScript ou WebAssembly sera accessible et modifiable depuis JavaScript ou WebAssembly.
new WebAssembly.Memory(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
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
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.
true
false
Note : Une page WebAssembly mesure une taille constante de 65 536 octets, soit 64Ko.
descripteurMemoire
TypeError
RangeError
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.
WebAssembly.Memory
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()
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); });
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 :
shared: true
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.
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.