Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.findIndex: indice della prima corrispondenza

findIndex restituisce il primo indice con callback truthy, o -1, e visita i vuoti come undefined.

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

Sintassi

array.findIndex(callbackFn[, thisArg])

array.findIndex(callbackFn[, thisArg]) chiama callbackFn(value, index, array) in ordine crescente e restituisce l’indice intero al primo risultato truthy, non il valore. Senza corrispondenza restituisce l’inequivocabile -1, quindi un undefined trovato non si confonde.

La lunghezza è fissata all’inizio, ma ogni indice viene visitato, incluso un vuoto letto come undefined. Le modifiche prima della visita sono visibili; indici aggiunti dopo no. Callback non invocabile o ricevente nullish genera TypeError; un’eccezione interrompe il metodo. L’esempio trova volutamente un vuoto e mostra separatamente -1.

Esempi

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

Risultato

1
-1

Fonti