Array : méthode indexOf()

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éthodeindexOf() des instances deArray retourne le premier indice auquel un élément donné peut être trouvé dans le tableau, ou -1 s'il n'est pas présent.

Exemple interactif

const beasts = ["fourmi", "bison", "chameau", "canard", "bison"];console.log(beasts.indexOf("bison"));// Résultat attendu : 1// À partir de l'indice 2console.log(beasts.indexOf("bison", 2));// Résultat attendu : 4console.log(beasts.indexOf("girafe"));// Résultat attendu : -1

Syntaxe

indexOf(searchElement)indexOf(searchElement, fromIndex)

Paramètres

searchElement

L'élément à rechercher dans le tableau.

fromIndexFacultatif

L'indice à partir duquel commencer la recherche,converti en entier.

Un indice négatif compte à rebours depuis la fin du tableau — si-array.length <= fromIndex < 0,fromIndex + array.length est utilisé. À noter : le tableau est toujours parcouru de l'avant vers l'arrière dans ce cas.
SifromIndex < -array.length ou sifromIndex est omis,0 est utilisé, ce qui fait que tout le tableau est parcouru.
SifromIndex >= array.length, le tableau n'est pas parcouru et-1 est retourné.

Valeur de retour

Le premier indice desearchElement dans le tableau ;-1 si la valeur n'est pas trouvée.

La méthodeindexOf() comparesearchElement aux éléments du tableau en utilisant uneégalité stricte (le même algorithme que celui utilisé par l'opérateur===). Les valeursNaN ne sont jamais considérées comme égales, doncindexOf() retourne toujours-1 lorsquesearchElement vautNaN.

La méthodeindexOf() ignore les emplacements vides dans lestableaux creux.

La méthodeindexOf() 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

Utiliser`indexOf()`

L'exemple suivant utiliseindexOf() pour localiser des valeurs dans un tableau.

const tableau = [2, 9, 9];tableau.indexOf(2); // 0tableau.indexOf(7); // -1tableau.indexOf(9, 2); // 2tableau.indexOf(2, -1); // -1tableau.indexOf(2, -3); // 0

Vous ne pouvez pas utiliserindexOf() pour rechercherNaN.

const tableau = [NaN];tableau.indexOf(NaN); // -1

Trouver toutes les occurences d'un élément

const indices = [];const tableau = ["a", "b", "a", "c", "a", "d"];const element = "a";let idx = tableau.indexOf(element);while (idx !== -1) {  indices.push(idx);  idx = tableau.indexOf(element, idx + 1);}console.log(indices);// [0, 2, 4]

Trouver si un élément existe et l'ajouter dans le tableau si ce n'est pas le cas

function mettreAJourLegumes(legumes, legume) {  if (legumes.indexOf(legume) === -1) {    legumes.push(legume);    console.log("Le nouveau tableau est : " + legumes);  } else if (legumes.indexOf(legume) > -1) {    console.log(legume + " existe déjà dans le tableau.");  }}const legumes = ["pomme de terre", "tomate", "poivron"];mettreAJourLegumes(legumes, "épinard");// Le nouveau tableau est : pomme de terre,tomate,poivron,épinardmettreAJourLegumes(legumes, "épinard");// épinard existe déjà dans le tableau.

Utiliser`indexOf()` sur des tableaux creux

Vous ne pouvez pas utiliserindexOf() pour rechercher des emplacements vides dans des tableaux creux.

console.log([1, , 3].indexOf(undefined)); // -1

Appeler`indexOf()` sur des objets ressemblant à des tableaux

La méthodeindexOf() lit la propriétélength dethis puis accède à chaque propriété dont la clé est un entier non négatif inférieur àlength.

const objetSimilaireTableau = {  length: 3,  0: 2,  1: 3,  2: 4,  3: 5, // ignoré par indexOf() car length vaut 3};console.log(Array.prototype.indexOf.call(objetSimilaireTableau, 2));// 0console.log(Array.prototype.indexOf.call(objetSimilaireTableau, 5));// -1