Atomics : mthode statique add()

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis dcembre 2021.

En savoir plus
Voir la compatibilit complte

La mthode statique Atomics.add() ajoute une valeur donne un lment du tableau une position donne et retourne l'ancienne valeur qui tait contenue cet emplacement. Cette opration atomique garantit qu'aucune autre opration d'criture n'est applique tant que la valeur modifie n'est pas crite.

Syntaxe

Atomics.add(typedArray, index, value)

Paramtres

typedArray: Un tableau typ entier partag parmi Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array ou Uint32Array.
index: La position du tableau typedArray auquel on souhaite ajouter une valeur.
value: La valeur ajouter.

Valeur de retour

L'ancienne valeur la position donne (typedArray[index]).

Exceptions

TypeError: Leve si typedArray n'est pas un des types d'entiers autoriss.
RangeError: Leve si index est en dehors des limites de typedArray.

Exemples

Notez que ces exemples ne peuvent pas tre excuts directement depuis la console ou une page web arbitraire, car SharedArrayBuffer n'est pas dfini moins que ses exigences de scurit ne soient respectes.

Utiliser la mthode `Atomics.add()`

// Cre un SharedArrayBuffer avec une taille en octets
const sab = new SharedArrayBuffer(1024);
// Cre une vue et dfinit la valeur de l'index 0
const ta = new Uint8Array(sab);
ta[0] = 7;

// 7 + 12 = 19
console.log(Atomics.add(ta, 0, 12)); // retourne 7, l'ancienne valeur
console.log(Atomics.load(ta, 0)); // 19, la nouvelle/valeur actuelle

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification # sec-atomics.add

Compatibilit des navigateurs

Voir aussi

L'objet Atomics
La mthode Atomics.sub()

Aider amliorer MDN

Cette page vous a-t-elle t utile ?

Oui Non

Apprendre contribuer

Cette page a t modifie le 27 mars 2026 par les contributeurices du MDN.

Voir cette page sur GitHub Signaler un problme avec ce contenu