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

CKTIS / JavaScript

Array.prototype.find: primeiro valor que satisfaz a condição

find devolve o primeiro valor cujo callback é truthy, ou undefined quando não existe correspondência.

Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxe

array.find(callbackFn[, thisArg])

array.find(callbackFn[, thisArg]) chama callbackFn(value, index, array) desde o índice 0 e termina no primeiro resultado truthy. Devolve o valor testado, não o resultado do callback. Sem correspondência devolve undefined, indistinguível apenas pelo resultado de encontrar um elemento undefined.

O comprimento é guardado no início. Cada índice é visitado e uma posição vazia é lida como undefined. Uma alteração posterior antes da visita é visível, mas um acréscimo além do comprimento inicial não. Callback não invocável ou recetor null/undefined lança TypeError; exceções propagam-se. O exemplo mostra paragem antecipada e posição vazia visitada.

Exemplos

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

Resultado

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

Fontes