Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.find: pierwsza wartość spełniająca warunek

find zwraca pierwszą wartość, dla której callback jest truthy, albo undefined, gdy nie ma dopasowania.

Wersja: ECMAScript 2026 draft; example target: Node.js 24.22.2

Składnia

array.find(callbackFn[, thisArg])

array.find(callbackFn[, thisArg]) wywołuje callbackFn(value, index, array) od indeksu 0 i kończy po pierwszym wyniku truthy, zwracając badaną wartość, nie wynik callbacku. Gdy nic nie pasuje, zwraca undefined; dlatego nie da się po samym wyniku odróżnić braku dopasowania od znalezionego elementu undefined.

Długość jest zapamiętywana na początku. Każdy indeks w tym zakresie jest odwiedzany, a dziura jest odczytywana jako undefined. Zmiana późniejszego elementu przed wizytą jest widoczna, ale dopisanie poza początkową długością nie. Callback niebędący funkcją lub odbiorca null/undefined powoduje TypeError, a wyjątek callbacku jest przekazywany. Przykład pokazuje wczesne zatrzymanie oraz odwiedzenie dziury.

Przykłady

const values = [, 4, 8, 12];
const visited = [];
const found = values.find((value, index) => { visited.push(`${index}:${value}`); return value >= 8; });
console.log(found);
console.log(visited.join("|"));

Wynik

8
0:undefined|1:4|2:8

Źródła