JavaScript Array findIndex()

Definitie en gebruik

findIndex() De methode retourneert de index van het eerste element in de array dat de test doorstaat (als functie aangeboden).

findIndex() De methode voert de functie eenmaal uit op elk bestaand element in de array:

  • Als de functie een waarde retourneert die true is voor het gevonden array-element, retourneert findIndex() de index van dat array-element (en controleert geen overige waarden)
  • Retourneert anders -1

Opmerking:findIndex() Voert de functie niet uit op array-elementen zonder waarde.

Opmerking:findIndex() Verandert het oorspronkelijke array niet.

Voorbeeld

Voorbeeld 1

Ophalen van de index van het eerste element in de array dat gelijk is aan of groter is dan 18:

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

Probeer het zelf

Voorbeeld 2

Verkrijg de index van het eerste element in het array dat een specifieke getal hoger is dan een bepaald getal:

<p>Minimumleeftijd: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Probeer het</button>
<p>Elke leeftijd boven: <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>

Probeer het zelf

Syntax

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

Waarde van de parameter

Parameters Beschrijving
function(currentValue, index, arr) Verplicht. De functie die voor elk element in het array wordt uitgevoerd.

Functieparameters:

Parameters Beschrijving
currentValue Verplicht. De waarde van het huidige element.
index Optioneel. De index van het huidige element in het array.
arr Optioneel. Het arrayobject waartoe het huidige element behoort.
thisValue

Optioneel. De waarde die moet worden doorgegeven aan de functie om diens "this"-waarde te gebruiken.

Indien dit parameter leeg is, wordt de waarde "undefined" doorgegeven als zijn "this"-waarde.

Technische details

Retournerende waarde: Retourneert de index van het element in het array als elk element door de test gaat, anders retourneert het -1.
JavaScript-versie: ECMAScript 6

Browserondersteuning

De cijfers in de tabel vermelden de eerste browserversie die deze methode volledig ondersteunt.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
September 2015 Juli 2015 Juli 2014 September 2014 September 2015

Opmerking:Internet Explorer wordt niet ondersteund findIndex() Methods.

Related pages

Tutorial:JavaScript array

Tutorial:JavaScript array Const

Tutorial:JavaScript array methods

Tutorial:JavaScript sorting array

Tutorial:JavaScript array iteration