Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes