Array.
Vérifie si un tableau contient la valeur donnée.
- Renvoie
trueoufalse.- Modifie l’original
- Non
Exemple
#const languages = ['HTML', 'CSS', 'JavaScript']
console.log(languages.includes('CSS'))
console.log(languages.includes('css'))
console.log([1, NaN].includes(NaN))Définition et utilisation
#La méthode includes() renvoie true si le tableau contient une valeur égale à celle donnée, et false sinon. C’est la façon la plus simple de répondre à « cet élément est-il dans la liste ? ».
La comparaison fonctionne comme ===, à une exception près : includes() sait trouver NaN, ce que indexOf() ne sait pas faire. Les objets sont comparés par référence, donc [{ a: 1 }].includes({ a: 1 }) renverra false.
Le second argument, optionnel, permet de commencer la recherche à partir d’un indice donné.
Syntaxe
#array.includes(searchElement)
array.includes(searchElement, fromIndex)Paramètres
#searchElement
valeur quelconque
Valeur recherchée.fromIndex
optionnel
Indice à partir duquel commencer. Une valeur négative compte depuis la fin.
Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- La casse compte. Pour comparer un texte saisi par l’utilisateur, normalisez-le d’abord, par exemple avec
toLowerCase(). - Pour des vérifications très fréquentes sur un grand ensemble, un
Setet sa méthodehas()sont plus rapides.
Entrées associées
#- Array.prototype.indexOf()Renvoie l’indice de la première occurrence d’une valeur, ou -1.
- Array.prototype.some()Vérifie si au moins un élément remplit la condition.
- String.prototype.includes()Vérifie si une chaîne contient le fragment de texte donné. Renvoie true ou false et distingue majuscules et minuscules.
- SetUne collection de valeurs uniques : chaque valeur ne peut apparaître qu’une fois dans l’ensemble.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.