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

Atomics : méthode statique store()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨décembre 2021⁩.

La méthode statique store() de l'objet Atomics enregistre une valeur donnée à un emplacement donné du tableau partagé et retourne cette valeur.

Exemple interactif

// Crée un SharedArrayBuffer avec une taille en octets
const buffer = new SharedArrayBuffer(16);
const uint8 = new Uint8Array(buffer);
uint8[0] = 5;

console.log(Atomics.store(uint8, 0, 2));
// Résultat attendu : 2

console.log(Atomics.load(uint8, 0));
// Résultat attendu : 2

Syntaxe

js
Atomics.store(typedArray, index, value)

Paramètres

typedArray

Un tableau typé entier partagé parmi Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, Uint32Array, BigInt64Array ou BigUint64Array.

index

La position du tableau typedArray à laquelle on souhaite stocker la valeur.

value

Le nombre à enregistrer.

Valeur de retour

La valeur qui a été enregistrée.

Exceptions

TypeError

Lèvee si typedArray n'est pas l'un des types d'entiers autorisés.

RangeError

Levée si index est en dehors des limites de typedArray.

Exemples

Utilisation de store()

js
const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);

Atomics.store(ta, 0, 12); // 12

Spécifications

Specification
ECMAScript® 2026 Language Specification
# sec-atomics.store

Compatibilité des navigateurs

Voir aussi