Array : méthode every()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

La méthodeevery() des instances deArray retournefalse si elle trouve un élément du tableau qui ne satisfait pas la fonction de test fournie. Sinon, elle retournetrue.

Exemple interactif

const isBelowThreshold = (currentValue) => currentValue < 40;const array = [1, 30, 39, 29, 10, 13];console.log(array.every(isBelowThreshold));// Sortie attendue : true

La fonction à exécuter pour chaque élément du tableau. Elle doit retourner une valeuréquivalente à vrai pour indiquer que l'élément passe le test, et une valeuréquivalente à faux sinon. La fonction est appelée avec les arguments suivants :

element: L'élément en cours de traitement dans le tableau.
index: L'indice de l'élément en cours de traitement dans le tableau.
array: Le tableau sur lequelevery() a été appelée.

thisArgFacultatif

Une valeur à utiliser commethis lors de l'exécution decallbackFn. Voirméthodes itératives.

Valeur de retour

true sauf sicallbackFn retourne une valeuréquivalente à faux pour un élément du tableau, auquel casfalse est immédiatement retourné.

Description

La méthodeevery() est uneméthode itérative. Elle appelle la fonctioncallbackFn fournie une fois pour chaque élément du tableau, jusqu'à ce quecallbackFn retourne une valeuréquivalente à faux. Si un tel élément est trouvé,every() retourne immédiatementfalse et arrête l'itération. Sinon, sicallbackFn retourne une valeuréquivalente à vrai pour tous les éléments,every() retournetrue. Consultez la sectionméthodes itératives pour plus d'informations sur le fonctionnement général de ces méthodes.

every agit comme le quantificateur « pour tout » en mathématiques. En particulier, pour un tableau vide, elle retournetrue. (Il esttrivialement vrai^(angl.) que tous les éléments d'unensemble vide respectent n'importe quelle condition.)

callbackFn n'est appelée que pour les indices du tableau qui ont des valeurs affectées. Elle n'est pas appelée pour les cases vides dans lestableaux creux.

La méthodeevery() estgénérique. Elle attend seulement que la valeur dethis possède une propriétélength et des propriétés à clés entières.

Exemples

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

Dans l'exemple suivant, on teste si tous les éléments du tableau sont supérieurs à 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

Vérifier si un tableau est un sous-ensemble d'un autre tableau

L'exemple suivant teste si tous les éléments d'un tableau sont présents 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])); // trueconsole.log(estSousEnsemble([1, 2, 3, 4, 5, 6, 7], [5, 8, 7])); // false

Utiliser le troisième argument de`callbackFn`

L'argumentarray est utile si vous souhaitez accéder à un autre élément du tableau. L'exemple suivant utilise d'abordfilter() pour extraire les valeurs positives puis utiliseevery() pour vérifier 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'accéder    // au tableau intermédiaire 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'exécutera pas son prédicat sur les cases vides.

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

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

La méthodeevery() lit la propriétélength dethis puis accède à chaque propriété dont la clé est un entier non négatif inférieur àlength jusqu'à ce qu'elles aient toutes été traitées ou quecallbackFn retournefalse.

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