JavaScript Array find()

Määrittely ja käyttö

find() Metodi palauttaa ensimmäisen testin läpivietävän elementin arvon (annettuna funktiona).

find() Metodi suorittaa annetun funktion kerran jokaiselle taulukon elementille:

  • Jos find() löytää taulukosta elementin, jolle funktio palauttaa true-arvon, find() palauttaa kyseisen elementin arvon (ei tarkista jäljellä olevia arvoja)
  • Muussa tapauksessa palauta undefined

Huomautus:find() Älä suorita tätä funktiota tyhjällä taulukolla.

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

Esimerkki

Esimerkki 1

Hae arvon, joka on 18 tai suurempi ensimmäisestä elementistä taulukossa:

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

Kokeile itse

Esimerkki 2

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

<p>Minimiikä: <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.find(checkAdult);
}
</script>

Kokeile itse

Syntaksi

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

Parametrien arvot

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

Funktioparametrit:

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

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

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

Tekninen yksityiskohta

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

Selaimen tuki

Taulukossa olevat numerot mainitsevat 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 find() menetelmät.

Liittyvät sivut

Ohje:JavaScript-taulukko

Ohje:JavaScript-taulukon Const

Ohje:JavaScript-taulukon menetelmät

Ohje:JavaScript-taulukon järjestäminen

Ohje:JavaScript-taulukon iteraatio