CKTIS / JavaScript
Array.prototype.findIndex: índice da primeira correspondência
findIndex devolve o primeiro índice com callback truthy, ou -1, e visita posições vazias como undefined.
Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintaxe
array.findIndex(callbackFn[, thisArg])array.findIndex(callbackFn[, thisArg]) chama callbackFn(value, index, array) por ordem crescente e devolve o índice inteiro no primeiro resultado truthy, não o valor. Sem correspondência devolve o inequívoco -1, logo um undefined encontrado não se confunde.
O comprimento é fixado no início, mas cada índice é visitado, incluindo uma posição vazia lida como undefined. Alterações antes da visita são visíveis; índices acrescentados depois não. Callback não invocável ou recetor nullish lança TypeError; uma exceção interrompe o método. O exemplo encontra deliberadamente uma posição vazia e mostra -1 em separado.
Exemplos
const values = ["A", , "C"];
console.log(values.findIndex(value => value === undefined));
console.log(values.findIndex(value => value === "missing"));Resultado
1 -1