JavaScript Array findIndex()

Définition et utilisation

findIndex() La méthode retourne l'index du premier élément du tableau qui passe le test (fourni comme fonction).

findIndex() La méthode exécute une fois la fonction pour chaque élément existant du tableau :

  • Si findIndex() trouve un élément du tableau pour lequel la fonction retourne true, alors findIndex() retourne l'index de cet élément du tableau (et ne vérifie pas les valeurs restantes)
  • Sinon, retourner -1

Remarque :findIndex() Ne pas exécuter la fonction pour les éléments du tableau sans valeur.

Remarque :findIndex() Ne pas changer l'array original.

Instance

Exemple 1

Trouver l'index de l'élément du tableau qui est égal ou supérieur à 18 :

var ages = [3, 10, 18, 20];
function checkAdult(age) {
  return age >= 18;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}

Essayez-le vous-même

Exemple 2

Obtenir l'index de l'élément de l'array dont la valeur est supérieure à un nombre spécifique :

<p>Minimum age: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Essayer</button>
<p>Any ages above: <span id="demo"></span></p>
<script>
var ages = [4, 12, 16, 20];
function checkAdult(age) {
  return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}
</script>

Essayez-le vous-même

Syntaxe

array.findIndex(function(currentValue, index, arr), thisValue)

valeur de paramètre

Paramètres Description
function(currentValue, index, arr) Requis. La fonction à exécuter pour chaque élément de l'array.

Paramètres de la fonction :

Paramètres Description
currentValue Requis. La valeur de l'élément courant
index Optionnel. L'index de l'array de l'élément courant
arr Optionnel. L'objet d'array auquel appartient l'élément courant
thisValue

Optionnel. La valeur à passer à la fonction pour utiliser comme valeur "this".

Si ce paramètre est vide, la valeur "undefined" est passée comme valeur "this".

Détails techniques

Valeur de retour : Si tout élément de l'array passe le test, retourne l'index de l'élément de l'array, sinon retourne -1.
Version JavaScript : ECMAScript 6

Prise en charge du navigateur

Les numéros dans le tableau indiquent la première version du navigateur qui prend en charge cette méthode en totalité.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
septembre 2015 juillet 2015 juillet 2014 septembre 2014 septembre 2015

Remarque :Internet Explorer n'est pas pris en charge findIndex() Méthode.

Pages liées

Tutoriel :Tableau JavaScript

Tutoriel :Const du tableau JavaScript

Tutoriel :Méthodes de tableau JavaScript

Tutoriel :Triage des tableaux JavaScript

Tutoriel :Itération des tableaux JavaScript