ExpertiDict

JavaScript · Essencial · Português · Técnico

método find

/ˈmɛtodu faɪnd/substantivo

Método de array que devolve o primeiro item para o qual a função retorna truthy, ou undefined se nenhum servir. Para na primeira ocorrência, sem percorrer o resto.

Onde usar

Usado para localizar um registro por id numa lista. Em code review, a checagem do undefined é cobrada, pois ler uma propriedade do resultado quebra quando nada é encontrado.

Em código

const users = [{ id: 1 }, { id: 2 }];
const u = users.find((x) => x.id === 2);
console.log(u); // { id: 2 }
console.log(users.find((x) => x.id === 9));
// undefined

Exemplos

Usei find para achar o usuário pelo id.

O find devolveu undefined e a tela quebrou ao ler o nome.

Cuidado

Confundir com findIndex, que devolve a posição do item, e -1 quando não acha.

Sinônimos

Array.prototype.find

Veja também

Todos os termos de JavaScript