JavaScript findIndex()Methode
JavaScript Array-ObjektBeispiel
Ermittle die Indexposition des ersten Elements im Array mit einem Alter größer oder gleich 18
var ages = [3, 10, 18, 20];
function checkAdult(age) {
return age >= 18;
}
function myFunction() {
document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}
fruitsAusgabeergebnis:
2
Selbst ausprobieren »
Definition und Verwendung
Die findIndex()-Methode gibt die Position des ersten Elements in einem Array zurück, das eine Testbedingung (Funktion) erfüllt.
Die findIndex()-Methode führt für jedes Element im Array einmal eine Funktion aus:
- Wenn ein Element im Array unter der Testbedingung true zurückgibttruedann gibt findIndex() die Indexposition des übereinstimmenden Elements zurück, und nachfolgende Werte rufen die Ausführungsfunktion nicht mehr auf.
- Wenn es kein übereinstimmendes Element gibt, wird -1 zurückgegeben.
Hinweis:Bei einem leeren Array führt findIndex() die Funktion nicht aus.
Hinweis:findIndex() ändert das ursprüngliche Array nicht.
Browser-Unterstützung
Die Zahlen in der Tabelle geben die erste Browserversion an, die die Methode unterstützt.
| Methode | |||||
|---|---|---|---|---|---|
| findIndex() | 45.0 | 12.0 | 25.0 | 7.1 | 32.0 |
Hinweis:IE 11 und frühere Versionen unterstützen die Methode findIndex() nicht.
Syntax
array.findIndex(function(currentValue, index, arr), thisValue)
Parameters
| Parameter | Beschreibung | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| function(currentValue, index,arr) | Erforderlich. Die Funktion, die für jedes Element des Arrays ausgeführt wird. Funktionsparameter:
|
||||||||
| thisValue | Optional. Ein Wert, der an die Funktion übergeben wird, der im Allgemeinen als "this"-Wert verwendet wird. Wenn dieser Parameter leer ist, wird "undefined" an den "this"-Wert übergeben. |
Technische Details
| Rückgabewert: | Gibt den Index des ersten Array-Elements zurück, das den Test erfüllt; wenn kein passendes Element vorhanden ist, wird -1 zurückgegeben. |
|---|---|
| JavaScript-Version: | ECMAScript 6 |
Weitere Beispiele
Beispiel
Gibt den Array-Index des Elements zurück, das größer als die Zahl im Eingabefeld ist:
var ages = [4, 12, 16, 20];
function checkAdult(age) {
return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}
Selbst ausprobieren »
Andere Erweiterungen