База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.prototype.find: първата стойност, която изпълнява условието

find връща първата стойност с truthy callback резултат или undefined, когато няма съвпадение.

Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2

Синтаксис

array.find(callbackFn[, thisArg])

array.find(callbackFn[, thisArg]) извиква callbackFn(value, index, array) от индекс 0 и спира при първия truthy резултат. Връща проверяваната стойност, не callback резултата. Без съвпадение връща undefined, което само по резултата не се различава от намерен елемент undefined.

Дължината се запомня в началото. Всеки индекс се посещава, а дупка се чете като undefined. Промяна на по-късен елемент преди посещението се вижда, добавяне след началната дължина — не. Неизвикваем callback или получател null/undefined хвърля TypeError; изключенията се разпространяват. Примерът показва ранно спиране и посетена дупка.

Примери

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

Резултат

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

Източници