TypedArray.prototype.some()

La méthode some() teste si certains éléments du tableau typé remplissent une condition décrite par la fonction de test donnée. Cette méthode utilise le même algorithme que Array.prototype.some(). Dans le reste de cet article TypedArray correspond à un des types de tableaux typés.

Syntaxe

typedarray.some(callback[, thisArg])

Paramètres

callback

La fonction à tester pour chaque élément. Elle prend trois arguments :

valeurCourante

L'élément du tableau typé en cours de traitement.

index

L'indice de l'élément du tableau typé en cours de traitement.

array

Le tableau typé sur lequel la méthode every a été appelée.

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 renvoie une valeur équivalente à true pour chaque élément du tableau typé, false sinon.

Description

La méthode some exécute la fonction callback fournie pour chaque élément du tableau typé jusqu'à ce que callback renvoie une valeur vraie (une valeur qui vaut true lorsqu'elle est convertie en un booléen). Si un tel élément est trouvé, la méthode some renvoie immédiatement true. Dans le cas contraire, si callback renvoie une valeur fausse pour tous les éléments, la méthode some renverra false.

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.

some ne modifie pas le tableau typé sur lequel elle a été appelée.

Exemples

Tester la valeur des éléments d'un tableau typé

Dans l'exemple qui suit, on teste s'il existe au moins un élément du tableau typé qui est supérieur à 10.

function supérieurÀ10(élément, index, array) {
  return élément > 10;
}
new Uint8Array([2, 5, 8, 1, 4]).some(supérieurÀ10);  // false
new Uint8Array([12, 5, 8, 1, 4]).some(supérieurÀ10); // true

Tester la valeur des éléments avec les fonctions fléchées

Les fonctions fléchées permettent d'utiliser une syntaxe plus concise pour arriver au même résultat :

new Uint8Array([2, 5, 8, 1, 4]).some(elem => elem > 10); // false
new Uint8Array([12, 5, 8, 1, 4]).some(elem => elem > 10); // true

Spécifications

Compatibilité des navigateurs

Voir aussi

• TypedArray.prototype.every()
• Array.prototype.some()