Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.
La méthode statique Atomics
.compareExchange()
échange une valeur d'un tableau à un emplacement donné si la valeur qui était dans le tableau correspond à une valeur donnée. Cette opération atomique garantit qu'aucune autre opération d'écriture n'est appliquée tant que la valeur modifiée n'est pas écrite.
Syntaxe
Atomics.compareExchange(typedArray, index, valeurAttendue, valeurRemplacement)
Paramètres
typedArray
- Un tableau typé entier partagé parmi
Int8Array
,Uint8Array
,Int16Array
,Uint16Array
,Int32Array
ouUint32Array
. index
- La position du tableau
typedArray
à laquelle on veut échanger les valeurs. valeurAttendue
- La valeur avec laquelle on teste l'égalité.
valeurRemplacement
- Le nombre qu'on souhaite placer dans le tableau si l'ancienne valeur est égale avec
valeurAttendue
.
Valeur de retour
L'ancienne valeur présente à typedArray[index]
.
Exceptions levées
- Cette méthode lève
TypeError
si le type detypedArray
n'est pas un des types entiers autorisés. - Cette méthode lève
TypeError
sitypedArray
n'est pas tableau typé partagé. - Cette méthode lève
RangeError
siindex
est en dehors des limites detypedArray
.
Exemples
var sab = new SharedArrayBuffer(1024); var ta = new Uint8Array(sab); ta[0] = 7; Atomics.compareExchange(ta, 0, 7, 12); // renvoie 7, l'ancienne valeur Atomics.load(ta, 0); // 12
Spécifications
Spécification | Statut | Commentaires |
---|---|---|
ECMAScript Shared Memory and Atomics La définition de 'Atomics.compareExchange' dans cette spécification. |
Projet | Définition initiale. |
Compatibilité des navigateurs
Fonctionnalité | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Support simple | Pas de support [2] | Pas de support | 46 (46) [1] | Pas de support | Pas de support | Pas de support |
Fonctionnalité | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Support simple | Pas de support | Pas de support | 46.0 (46) [1] | Pas de support | Pas de support | Pas de support |
[1] Cette fonctionnalité est désactivée grâce à une préférence. Sous about:config
, il faut activer javascript.options.shared_memory
avec true
.
[2] L'implémentation est en cours de développement et ces marqueurs d'exécution doivent être utilisés : --js-flags=--harmony-sharedarraybuffer --enable-blink-feature=SharedArrayBuffer