Array : mthode every()

Exemple interactif

const isBelowThreshold = (currentValue) => currentValue < 40;

const array = [1, 30, 39, 29, 10, 13];

console.log(array.every(isBelowThreshold));
// Sortie attendue : true

Syntaxe

every(callbackFn)
every(callbackFn, thisArg)

Paramtres

callbackFn

La fonction excuter pour chaque lment du tableau. Elle doit retourner une valeur quivalente vrai pour indiquer que l'lment passe le test, et une valeur quivalente faux sinon. La fonction est appele avec les arguments suivants :

element

L'lment en cours de traitement dans le tableau.

index

L'indice de l'lment en cours de traitement dans le tableau.

array

Le tableau sur lequel every() a t appele.

thisArg Facultatif

Une valeur utiliser comme this lors de l'excution de callbackFn. Voir mthodes itratives.

Valeur de retour

true sauf si callbackFn retourne une valeur quivalente faux pour un lment du tableau, auquel cas false est immdiatement retourn.

Description

La mthode every() est une mthode itrative. Elle appelle la fonction callbackFn fournie une fois pour chaque lment du tableau, jusqu' ce que callbackFn retourne une valeur quivalente faux. Si un tel lment est trouv, every() retourne immdiatement false et arrte l'itration. Sinon, si callbackFn retourne une valeur quivalente vrai pour tous les lments, every() retourne true. Consultez la section mthodes itratives pour plus d'informations sur le fonctionnement gnral de ces mthodes.

every agit comme le quantificateur  pour tout  en mathmatiques. En particulier, pour un tableau vide, elle retourne true. (Il est trivialement vrai (angl.) que tous les lments d'un ensemble vide respectent n'importe quelle condition.)

callbackFn n'est appele que pour les indices du tableau qui ont des valeurs affectes. Elle n'est pas appele pour les cases vides dans les tableaux creux.

La mthode every() est gnrique. Elle attend seulement que la valeur de this possde une proprit length et des proprits cls entires.

Exemples

Tester la valeur des lments d'un tableau

Dans l'exemple suivant, on teste si tous les lments du tableau sont suprieurs 10.

function estAssezGrand(element, index, array) {
  return element >= 10;
}
[12, 5, 8, 130, 44].every(estAssezGrand); // false
[12, 54, 18, 130, 44].every(estAssezGrand); // true

Vrifier si un tableau est un sous-ensemble d'un autre tableau

L'exemple suivant teste si tous les lments d'un tableau sont prsents dans un autre tableau.

const estSousEnsemble = (tableau1, tableau2) =>
  tableau2.every((element) => tableau1.includes(element));

console.log(estSousEnsemble([1, 2, 3, 4, 5, 6, 7], [5, 7, 6])); // true
console.log(estSousEnsemble([1, 2, 3, 4, 5, 6, 7], [5, 8, 7])); // false

Utiliser le troisime argument de callbackFn

L'argument array est utile si vous souhaitez accder un autre lment du tableau. L'exemple suivant utilise d'abord filter() pour extraire les valeurs positives puis utilise every() pour vrifier si le tableau est strictement croissant.

const nombres = [-2, 4, -8, 16, -32];
const estCroissant = nombres
  .filter((num) => num > 0)
  .every((num, idx, arr) => {
    // Sans l'argument arr, il n'y a pas de moyen simple d'accder
    // au tableau intermdiaire sans le stocker dans une variable.
    if (idx === 0) return true;
    return num > arr[idx - 1];
  });
console.log(estCroissant); // true

Utiliser every() sur des tableaux creux

every() n'excutera pas son prdicat sur les cases vides.

console.log([1, , 3].every((x) => x !== undefined)); // true
console.log([2, , 2].every((x) => x === 2)); // true

Appeler every() sur des objets qui ne sont pas des tableaux

La mthode every() lit la proprit length de this puis accde chaque proprit dont la cl est un entier non ngatif infrieur length jusqu' ce qu'elles aient toutes t traites ou que callbackFn retourne false.

const objetSimilaireTableau = {
  length: 3,
  0: "a",
  1: "b",
  2: "c",
  3: 345, // ignor par every() car length vaut 3
};
console.log(
  Array.prototype.every.call(
    objetSimilaireTableau,
    (x) => typeof x === "string",
  ),
); // true

Spcifications

Compatibilit des navigateurs

Voir aussi

• Guide des collections indexes
• L'objet global Array
• La mthode Array.prototype.forEach()
• La mthode Array.prototype.some()
• La mthode Array.prototype.find()
• La mthode TypedArray.prototype.every()
• Prothse d'mulation de Array.prototype.every dans core-js(angl.)
• Prothse d'mulation es-shims de Array.prototype.every(angl.)