JavaScript Array find()

Definicja i użycie

find() Metoda zwraca wartość pierwszego elementu tablicy, który przeszło test (jako funkcję dostarczoną)

find() Metoda wykonuje funkcję dla każdego istniejącego elementu w tablicy:

  • Jeśli znajdziesz element tablicy, dla którego funkcja zwraca wartość true, funkcja find() zwróci wartość tego elementu tablicy (i nie sprawdzi reszty wartości)
  • W przeciwnym razie zwróć undefined

Komentarz:find() Nie wykonuj tej funkcji na pustej tablicy.

Komentarz:find() Nie zmienia oryginalnej tablicy.

Przykład

Przykład 1

Pobierz wartość pierwszego elementu tablicy, który jest równy lub większy niż 18:

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

Spróbuj sam

Przykład 2

Pobierz wartość elementu z tablicy, który ma wartość wyższą niż określona liczba:

<p>Minimalny wiek: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Spróbuj</button>
<p>Wszystkie wieki powyżej: <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>

Spróbuj sam

Gramatyka

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

wartość parametru

Parametry Opis
function(currentValue, index, arr) Wymagane. Funkcja do uruchomienia dla każdego elementu tablicy.

Parametry funkcji:

Parametry Opis
currentValue Wymagane. Wartość bieżącego elementu.
index Opcjonalnie. Indeks tablicy bieżącego elementu.
arr Opcjonalnie. Obiekt tablicy, do którego należy bieżący element.
thisValue

Opcjonalnie. Wartość do przekazania funkcji jako wartość "this".

Jeśli ten parametr jest pusty, wartość "undefined" zostanie przekazana jako jej wartość "this".

Szczegółowe informacje techniczne

Zwracana wartość: Jeśli którykolwiek element tablicy przejdzie test, zwróci wartość elementu tablicy, w przeciwnym razie zwróci undefined.
Wersja JavaScript: ECMAScript 6

Obsługa przeglądarek

Liczby w tabeli wskazują na pierwszą wersję przeglądarki, która w pełni obsługuje tę metodę.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
wrzesień 2015 roku lipiec 2015 roku lipiec 2014 roku wrzesień 2014 roku wrzesień 2015 roku

Komentarz:Internet Explorer nie obsługuje find() Metoda.

Strony związane

Tutorial:Tablice JavaScript

Tutorial:Tablice Const JavaScript

Tutorial:Metody tablicy JavaScript

Tutorial:Sortowanie tablicy JavaScript

Tutorial:Iteracja tablicy JavaScript