Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.find: primo valore che soddisfa la condizione

find restituisce il primo valore con callback truthy, oppure undefined quando non esiste una corrispondenza.

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

Sintassi

array.find(callbackFn[, thisArg])

array.find(callbackFn[, thisArg]) chiama callbackFn(value, index, array) dall’indice 0 e si ferma al primo risultato truthy. Restituisce il valore esaminato, non il risultato del callback. Senza corrispondenza restituisce undefined, indistinguibile dal ritrovamento di un elemento undefined usando solo il risultato.

La lunghezza è acquisita all’inizio. Ogni indice viene visitato e un vuoto è letto come undefined. Una modifica a un elemento successivo prima della visita è visibile, un’aggiunta oltre la lunghezza iniziale no. Callback non invocabile o ricevente null/undefined genera TypeError; le eccezioni si propagano. L’esempio mostra arresto anticipato e vuoto visitato.

Esempi

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

Risultato

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

Fonti