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.exchange() permet d'échanger une valeur donnée à une position donnée du tableau et de renvoyer l'ancienne valeur qui était contenue dans le tableau. 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.exchange(typedArray, index, valeur)
Paramètres
typedArray- Un tableau typé entier partagé parmi
Int8Array,Uint8Array,Int16Array,Uint16Array,Int32ArrayouUint32Array. index- La position dans le tableau
typedArrayà laquelle on veut placervaleur. valeur- Le nombre qu'on souhaite échanger.
Valeur de retour
L'ancienne valeur qui était contenue à (typedArray[index]).
Exceptions levées
- Cette méthode lève
TypeErrorsi le type detypedArrayn'est pas un des types entiers autorisés. - Cette méthode lève
TypeErrorsitypedArrayn'est pas tableau typé partagé. - Cette méthode lève
RangeErrorsiindexest en dehors des limites detypedArray.
Exemples
var sab = new SharedArrayBuffer(1024); var ta = new Uint8Array(sab); Atomics.exchange(ta, 0, 12); // renvoie 0, l'ancienne valeur Atomics.load(ta, 0); // 12
Spécifications
| Spécification | Statut | Commentaires |
|---|---|---|
| ECMAScript Shared Memory and Atomics La définition de 'Atomics.exchange' 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 pour 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