JavaScript Array find()
- Edellinen sivu filter()
- Seuraava sivu findIndex()
- Palaa ylös JavaScript Array viittausopas
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); }
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>
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:
|
||||||||
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
- Edellinen sivu filter()
- Seuraava sivu findIndex()
- Palaa ylös JavaScript Array viittausopas