[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/some [Back]  [Original]

TypedArray.prototype.some() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

TypedArray.prototype.some()

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2016.

La mthode some() teste si certains lments du tableau typ remplissent une condition dcrite par la fonction de test donne. Cette mthode utilise le mme algorithme que Array.prototype.some(). Dans le reste de cet article TypedArray correspond un des types de tableaux typs.

Dans cet article

Exemple interactif

function isNegative(element, index, array) {
  return element < 0;
}

const int8 = new Int8Array([-10, 20, -30, 40, -50]);
const positives = new Int8Array([10, 20, 30, 40, 50]);

console.log(int8.some(isNegative));
// Expected output: true

console.log(positives.some(isNegative));
// Expected output: false

Syntaxe

js
typedarray.some(callback[, thisArg])

Paramtres

callback

La fonction tester pour chaque lment. Elle prend trois arguments :

valeurCourante

L'lment du tableau typ en cours de traitement.

index

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

array

Le tableau typ sur lequel la mthode some a t appele.

thisArg

Paramtre optionnel, la valeur utiliser en tant que this lors de l'excution de callback.

Valeur de retour

true si la fonction de rappel renvoie une valeur quivalente true pour chaque lment du tableau typ, false sinon.

Description

La mthode some excute la fonction callback fournie pour chaque lment du tableau typ jusqu' ce que callback renvoie une valeur vraie (une valeur qui vaut true lorsqu'elle est convertie en un boolen). Si un tel lment est trouv, la mthode some renvoie immdiatement true. Dans le cas contraire, si callback renvoie une valeur fausse pour tous les lments, la mthode some renverra false.

callback est appel avec trois arguments : la valeur de l'lment, l'indice de cet lment et le tableau qui est parcouru.

Si le paramtre thisArg est utilis, il sera pass la fonction callback en tant que valeur this. Sinon, la valeur undefined sera utilise comme valeur this. La valeur this dfinitivement prise en compte par la fonction callback est dtermine selon les rgles usuelles de dtermination de this.

some ne modifie pas le tableau typ sur lequel elle a t appele.

Exemples

Tester la valeur des lments d'un tableau typ

Dans l'exemple qui suit, on teste s'il existe au moins un lment du tableau typ qui est suprieur 10.

js
function suprieur10(lment, index, array) {
  return lment > 10;
}
new Uint8Array([2, 5, 8, 1, 4]).some(suprieur10); // false
new Uint8Array([12, 5, 8, 1, 4]).some(suprieur10); // true

Tester la valeur des lments avec les fonctions flches

Les fonctions flches permettent d'utiliser une syntaxe plus concise pour arriver au mme rsultat :

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

Prothse d'mulation (polyfill)

Il n'existe pas d'objet global intitul TypedArray, la prothse doit donc uniquement tre employe si ncessaire :

js
// https://tc39.github.io/ecma262/#sec-%typedarray%.prototype.slice
if (!Uint8Array.prototype.some) {
  Object.defineProperty(Uint8Array.prototype, "some", {
    value: Array.prototype.some,
  });
}

S'il faut galement prendre en charge les moteurs JavaScript qui ne prennent pas en charge la mthode Object.defineProperty, mieux vaut ne pas ajouter de prothse du tout pour TypedArray.prototype car on ne peut pas les rendre non-numrables.

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-%typedarray%.prototype.some

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page