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
.sub()
permet de soustraire une valeur donnée à une position donnée du tableau partagé. Elle renvoie l'ancienne valeur qui était contenue dans le tableau avant l'opération. 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.sub(typedArray, index, valeur)
Paramètres
typedArray
- Un tableau typé entier partagé parmi
Int8Array
,Uint8Array
,Int16Array
,Uint16Array
,Int32Array
ouUint32Array
. index
- La position du tableau typé
typedArray
à laquelle on veut soustrairevaleur
. valeur
- La quantité qu'on souhaite soustraire.
Valeur de retour
L'ancienne valeur qui était contenue à (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] = 48; Atomics.sub(ta, 0, 12); // renvoie 48, l'ancienne valeur Atomics.load(ta, 0); // 36
Spécifications
Spécification | Statut | Commentaires |
---|---|---|
ECMAScript Shared Memory and Atomics La définition de 'Atomics.sub' 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