TypedArray.prototype.every()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
La méthode every()
teste si tous les éléments du tableau typé satisfont une condition implémentée par la fonction de test fournie. Cette méthode utilise le même algorithme Array.prototype.every()
. Pour le reste de cet article, TypedArray correspond à un des types de tableaux typés.
Exemple interactif
Syntaxe
typedarray.every(callback[, thisArg])>
Paramètres
callback
-
La fonction utilisée pour tester chaque élément du tableau. Elle utilise trois arguments :
valeurCourante
-
L'élément du tableau typé qui est en cours de traitement.
index
-
L'indice de l'élément du tableau typé en cours de traitement.
array
-
Le tableau typé sur lequel on a appelé la méthode
every
.
thisArg
-
Paramètre optionnel, la valeur à utiliser en tant que
this
lors de l'exécution decallback
.
Valeur de retour
true
si la fonction de rappel obtient une valeur équivalente à vrai (truthy) pour chaque élément du tableau typé, false
sinon.
Description
La méthode every
exécute la fonction callback
fournie pour chaque élément du tableau typé jusqu'à ce que callback
renvoie une valeur fausse (une valeur qui vaut false
lorsqu'elle est convertie en un booléen). Si un tel élément est trouvé, la méthode every
renvoie immédiatement false
. Dans le cas contraire, si callback
renvoie une valeur vraie pour tous les éléments, la méthode every
renverra true
.
callback
est appelé avec trois arguments : la valeur de l'élément, l'indice de cet élément et le tableau qui est parcouru.
Si le paramètre thisArg
est utilisé, il sera passé à la fonction callback
en tant que valeur this
. Sinon, la valeur undefined
sera utilisée comme valeur this
. La valeur this
définitivement prise en compte par la fonction callback
est déterminée selon les règles usuelles de détermination de this
.
every
ne modifie pas le tableau typé sur lequel elle a été appelée.
Exemples
Tester la taille des éléments d'un tableau typé
Dans l'exemple suivant, on teste si tous les éléments du tableau typé sont supérieurs à 10 :
function estGrand(element, index, array) {
return element >= 10;
}
new Uint8Array([12, 5, 8, 130, 44]).every(estGrand); // false
new Uint8Array([12, 54, 18, 130, 44]).every(estGrand); // true
Tester les éléments d'un tableau typé avec les fonctions fléchées
Les fonctions fléchées permettent d'utiliser une syntaxe plus concise pour parvenir au même résultat :
new Uint8Array([12, 5, 8, 130, 44]).every((elem) => elem >= 10); // false
new Uint8Array([12, 54, 18, 130, 44]).every((elem) => elem >= 10); // true
Spécifications
Specification |
---|
ECMAScript Language Specification # sec-%typedarray%.prototype.every |
Compatibilité des navigateurs
BCD tables only load in the browser