Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Array.prototype.find: první hodnota splňující podmínku

find vrátí první hodnotu s truthy výsledkem callbacku nebo undefined, pokud nic neodpovídá.

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

Syntaxe

array.find(callbackFn[, thisArg])

array.find(callbackFn[, thisArg]) volá callbackFn(value, index, array) od indexu 0 a skončí při prvním truthy výsledku. Vrací testovanou hodnotu, nikoli výsledek callbacku. Bez shody vrátí undefined, což samotné nelze odlišit od nalezeného prvku undefined.

Délka se uloží na začátku. Každý index se navštíví a díra se čte jako undefined. Změna pozdějšího prvku před návštěvou je vidět, přidání za počáteční délku ne. Nevolatelný callback nebo příjemce null/undefined vyvolá TypeError; výjimky se šíří. Příklad ukazuje předčasné zastavení a navštívenou díru.

Příklady

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("|"));

Výsledek

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

Zdroje