JavaScript Array find()

Definition und Verwendung

find() Diese Methode gibt den Wert des ersten Elements im Array zurück, das den Test besteht (als von der Funktion bereitgestellte Werte)

find() Diese Methode führt die Funktion für jedes vorhandene Element im Array einmal aus:

  • Wenn ein Arrayelement gefunden wird, das den Wert true zurückgibt, gibt find() den Wert dieses Arrayelements zurück (und überprüft keine restlichen Werte)
  • Ansonsten wird undefined zurückgegeben

Anmerkung:find() Führen Sie diese Funktion nicht auf einem leeren Array aus.

Anmerkung:find() Verändert das ursprüngliche Array nicht.

Beispiel

Beispiel 1

Erhalten Sie den Wert des ersten Elements im Array, das 18 oder größer ist:

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

Versuchen Sie es selbst

Beispiel 2

Erhalten Sie den Wert des ersten Elements im Array, dessen Wert höher als eine bestimmte Zahl ist:

<p>Mindestalter: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Versuchen Sie es</button>
<p>Alle Altersgruppen über: <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>

Versuchen Sie es selbst

Syntax

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

Wert der Parameter

Parameter Beschreibung
function(currentValue, index, arr) Erforderlich. Die Funktion, die für jedes Element im Array ausgeführt wird.

Funktionparameter:

Parameter Beschreibung
currentValue Erforderlich. Der Wert des aktuellen Elements.
index Optional. Der Array-Index des aktuellen Elements.
arr Optional. Das Arrayobjekt, dem das aktuelle Element angehört.
thisValue

Optional. Der Wert, der an die Funktion übergeben wird, um als "this"-Wert zu dienen.

Wenn dieser Parameter leer ist, wird der Wert "undefined" als sein "this"-Wert übergeben.

Technische Details

Rückgabewert: Wenn irgendeines der Elemente im Array den Test besteht, wird der Wert des Array-Elements zurückgegeben, sonst undefined.
JavaScript-Version: ECMAScript 6

Browser-Unterstützung

Die Zahlen in der Tabelle weisen auf die erste Browserversion hin, die diesen Methoden vollständige Unterstützung bietet.

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

Anmerkung:Internet Explorer unterstützt nicht find() Methode.

Verwandte Seiten

Tutorium:JavaScript-Array

Tutorium:JavaScript-Array-Const

Tutorium:JavaScript-Array-Methode

Tutorium:JavaScript-Array-Sortierung

Tutorium:JavaScript-Array-Iteration