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 March 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

js
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 de callback.

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 :

js
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 :

js
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

Voir aussi