JavaScript Array find()

Definition og brug

find() Funktionen returnerer værdien af det første element i arrayet, der passer til testkriterierne (som funktionen leveres)

find() Funktionen udfører funktionen én gang for hver element i arrayet, der findes:

  • Hvis find() finder en arrayelement, der returnerer true fra funktionen, returnerer find() værdien af det arrayelement (og tjekker ikke de resterende værdier)
  • Retur undefined ellers

Kommentar:find() Kører ikke funktionen på et tomt array.

Kommentar:find() Ændrer ikke det oprindelige array.

Eksempel

Eksempel 1

Få værdien af det første element i arrayet, der er 18 eller større:

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

Prøv selv

Eksempel 2

Få verdien til det første elementet i arrayet som har en verdi høyere enn en bestemt tallverdi:

<p>Minimumsalder: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Prøv det</button>
<p>Eventuelle aldre over: <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>

Prøv selv

Syntaks

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

Parameterverdi

Parameter Beskrivelse
function(currentValue, index, arr) Obligatorisk. Funksjonen som kjører for hvert element i arrayet.

Funksjonsparametere:

Parameter Beskrivelse
currentValue Obligatorisk. Den nåværende elementets verdi.
index Valgfri. Den nåværende elementets arrayindeks.
arr Valgfri. Den nåværende elementets arrayobjekt.
thisValue

Valgfri. Verdien som skal passes til funksjonen som brukes som dens "this"-verdi.

Hvis dette parameteret er tomt, brukes verdien "undefined" som dens "this"-verdi.

Tekniske detaljer

Returverdi: Hvis noen element i arrayet passerer testen, returneres verdien av arrayelementet, ellers returneres undefined.
JavaScript versjon: ECMAScript 6

Nettleserstøtte

Tallene i tabellen angiver den første nettleseren som fullt ut støtter denne metoden.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
2015 år 9 måned 2015 år 7 måned 2014 år 7 måned 2014 år 9 måned 2015 år 9 måned

Kommentar:Internet Explorer ikke understøttet find() metoder.

Relaterede sider

Tutorial:JavaScript array

Tutorial:JavaScript array Const

Tutorial:JavaScript array metoder

Tutorial:JavaScript sortér array

Tutorial:JavaScript array iteration