HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
All web technology
Learn web development
Discover our tools
Get to know MDN better
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
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éthode every() des instances de Array retourne false si elle trouve un élément du tableau qui ne satisfait pas la fonction de test fournie. Sinon, elle retourne true.
every()
Array
false
true
const isBelowThreshold = (currentValue) => currentValue < 40; const array = [1, 30, 39, 29, 10, 13]; console.log(array.every(isBelowThreshold)); // Sortie attendue : true
every(callbackFn) every(callbackFn, thisArg)
callbackFn
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 lequel every() a été appelée.
thisArg
Une valeur à utiliser comme this lors de l'exécution de callbackFn. Voir méthodes itératives.
this
true sauf si callbackFn retourne une valeur équivalente à faux pour un élément du tableau, auquel cas false est immédiatement retourné.
La méthode every() est une méthode itérative. Elle appelle la fonction callbackFn fournie une fois pour chaque élément du tableau, jusqu'à ce que callbackFn retourne une valeur équivalente à faux. Si un tel élément est trouvé, every() retourne immédiatement false et arrête l'itération. Sinon, si callbackFn retourne une valeur équivalente à vrai pour tous les éléments, every() retourne true. Consultez la section mé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 retourne true. (Il est trivialement vrai (angl.) que tous les éléments d'un ensemble vide respectent n'importe quelle condition.)
every
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 les tableaux creux.
La méthode every() est générique. Elle attend seulement que la valeur de this possède une propriété length et des propriétés à clés entières.
length
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
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])); // true console.log(estSousEnsemble([1, 2, 3, 4, 5, 6, 7], [5, 8, 7])); // false
L'argument array est utile si vous souhaitez accéder à un autre élément du tableau. L'exemple suivant utilise d'abord filter() pour extraire les valeurs positives puis utilise every() pour vérifier si le tableau est strictement croissant.
filter()
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
every() n'exécutera pas son prédicat sur les cases vides.
console.log([1, , 3].every((x) => x !== undefined)); // true console.log([2, , 2].every((x) => x === 2)); // true
La méthode every() lit la propriété length de this 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 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
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Array.prototype.forEach()
Array.prototype.some()
Array.prototype.find()
TypedArray.prototype.every()
Array.prototype.every
core-js