JavaScript Array findIndex()

Määrittely ja käyttö

findIndex() Metodi palauttaa ensimmäisen testin läpäisevän taulukon elementin indeksin (joka toimii annettuna funktiona).

findIndex() Metodi suorittaa funktion kerran jokaiselle taulukon elementille:

  • Jos löytyy funktiosta true-arvon palauttavaa taulukon elementtiä, findIndex() palauttaa kyseisen taulukon elementin indeksin (ei tarkisteta jäljellä olevia arvoja)
  • Muussa tapauksessa palauta -1

Huomautus:findIndex() Ei suorita funktiota ilman arvoa olevaa taulukon elementtiä.

Huomautus:findIndex() Ei muuta alkuperäistä taulukkoa.

Esimerkki

Esimerkki 1

Hae ensimmäisen arvon indeksi, joka on tai suurempi kuin 18 taulukosta:

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

Kokeile itse

Esimerkki 2

Hanki taulukosta ensimmäisen arvon indeksi, joka on suurempi kuin tietty luku:

<p>Alin ikä: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Kokeile</button>
<p>Mikä tahansa ikä yli: <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>

Kokeile itse

Syntaksi

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

Argumenttiparit

Parametrit Kuvaus
function(currentValue, index, arr) Välttämätön. Suoritettava jokaiselle taulukon elementille.

Funktioargumentit:

Parametrit Kuvaus
currentValue Välttämätön. Nykyisen elementin arvo.
index Valinnainen. Nykyisen elementin taulukon indeksi.
arr Valinnainen. Nykyisen elementin kuuluvan taulukko-objekti
thisValue

Valinnainen. Arvo, joka toimitetaan funktiolle ja käytetään sen "this"-arvona.

Jos tämä parametri on tyhjä, arvona "undefined" toimitetaan sen "this"-arvona.

Tekninen yksityiskohta

Palautusarvo: Jos mikä tahansa taulukon elementti läpäisee testin, palautetaan taulukon elementin indeksi, muuten palautetaan -1.
JavaScript-versio: ECMAScript 6

Selaimen tuki

Taulukossa olevat numerot osoittavat ensimmäisen selaimen version, joka tukee tätä menetelmää täysin.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
Syyskuu 2015 Heinäkuu 2015 Heinäkuu 2014 Syyskuu 2014 Syyskuu 2015

Huomautus:Internet Explorer ei tue findIndex() menetelmät.

Liittyvät sivut

Oppitunti:JavaScript taulukko

Oppitunti:JavaScript taulukon Const

Oppitunti:JavaScript taulukon metodit

Oppitunti:JavaScript taulukon järjestäminen

Oppitunti:JavaScript taulukon iteraatio