Array.
Renvoie l’indice de la première occurrence d’une valeur, ou -1.
- Renvoie
- L’indice de la première occurrence, ou
-1. - Modifie l’original
- Non
Exemple
#const colors = ['red', 'green', 'blue', 'green']
console.log(colors.indexOf('green'))
console.log(colors.lastIndexOf('green'))
console.log(colors.indexOf('pink'))Définition et utilisation
#La méthode indexOf() cherche la valeur donnée et renvoie l’indice de sa première occurrence. Si la valeur n’est pas dans le tableau, elle renvoie -1.
Elle compare strictement, comme ===. Elle ne trouvera donc pas le nombre 1 si vous cherchez la chaîne "1", et ne trouvera jamais NaN. Pour chercher selon une condition (par exemple un objet avec un id donné), utilisez findIndex().
Son équivalent lastIndexOf() cherche depuis la fin et renvoie l’indice de la dernière occurrence.
Syntaxe
#array.indexOf(searchElement)
array.indexOf(searchElement, fromIndex)Paramètres
#searchElement
valeur quelconque
Valeur recherchée.fromIndex
optionnel
Indice à partir duquel commencer la recherche.
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
#- Pour simplement vérifier une présence,
includes()est plus clair queindexOf(x) !== -1. - Pour les objets et les conditions complexes, utilisez
findIndex().
Entrées associées
#- Array.prototype.includes()Vérifie si un tableau contient la valeur donnée.
- Array.prototype.findIndex()Renvoie l’indice du premier élément qui remplit la condition, ou -1.
- String.prototype.indexOf()Renvoie l’indice de la première occurrence du texte donné dans une chaîne, ou -1 s’il est absent.
- Array.prototype.lastIndexOf()Renvoie l’indice de la dernière occurrence d’une valeur dans le tableau, ou -1 si elle n’y est pas.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.