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

CKTIS / JavaScript

Array.prototype.findIndex: индекс на първото съвпадение

findIndex връща първия индекс с truthy callback или -1 и посещава дупките като undefined.

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

Синтаксис

array.findIndex(callbackFn[, thisArg])

array.findIndex(callbackFn[, thisArg]) извиква callbackFn(value, index, array) във възходящ ред и при първия truthy резултат връща целочисления индекс, не стойността. Без съвпадение връща еднозначното -1, затова намерено undefined не се бърка с неуспех.

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

Примери

const values = ["A", , "C"];
console.log(values.findIndex(value => value === undefined));
console.log(values.findIndex(value => value === "missing"));

Резултат

1
-1

Източници