JavaScript findIndex()Méthode
Exemple
Obtenir la position d'index du premier élément du tableau ayant un âge supérieur ou égal à 18
var ages = [3, 10, 18, 20];
function checkAdult(age) {
return age >= 18;
}
function myFunction() {
document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}
fruitsRésultat de sortie :
2
Essayez-le vous-même »
Définition et utilisation
La méthode findIndex() renvoie la position du premier élément d'un tableau qui réussit une condition de test (fonction).
La méthode findIndex() exécute une fonction une fois pour chaque élément du tableau :
- Lorsqu'un élément du tableau renvoie true sous la condition de testtruealors findIndex() renvoie la position d'index de l'élément correspondant, et les valeurs suivantes n'appelleront plus la fonction d'exécution.
- S'il n'y a aucun élément correspondant, elle renvoie -1.
Remarque :Pour un tableau vide, findIndex() n'exécutera pas la fonction.
Remarque :findIndex() ne modifie pas le tableau d'origine.
Prise en charge des navigateurs
Les nombres dans le tableau indiquent la première version du navigateur qui prend en charge la méthode.
| Méthode | |||||
|---|---|---|---|---|---|
| findIndex() | 45.0 | 12.0 | 25.0 | 7.1 | 32.0 |
Remarque :IE 11 et les versions antérieures ne prennent pas en charge la méthode findIndex().
Syntaxe
array.findIndex(function(currentValue, index, arr), thisValue)
Parameters
| Paramètre | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| function(currentValue, index,arr) | Obligatoire. La fonction à exécuter pour chaque élément du tableau. Paramètres de fonction :
|
||||||||
| thisValue | Facultatif. Une valeur à transmettre à la fonction, généralement utilisée comme valeur "this". Si ce paramètre est vide, "undefined" sera transmis à la valeur "this". |
Détails techniques
| Valeur de retour : | Renvoie l'index du premier élément du tableau qui réussit le test ; si aucun élément ne correspond, renvoie -1. |
|---|---|
| Version JavaScript : | ECMAScript 6 |
Plus d’exemples
Exemple
Renvoie l'index dans le tableau de l'élément qui est supérieur au nombre dans la zone de saisie :
var ages = [4, 12, 16, 20];
function checkAdult(age) {
return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}
Essayez-le vous-même »
Autres extensions
Objet Array JavaScript