English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Método find() do array JavaScript

 Objeto Array do JavaScript

O método find() retorna o valor do primeiro elemento do array que satisfaça a função de teste fornecida.

O método find() executa a função de callback para cada índice do array:

  • Se a função encontrar retornarverdadeirodo elemento do array de valores, entãofind()Retorna imediatamente o valor do elemento encontrado

  • Caso contrário, ele retornaundefinedindica que nenhum elemento passou pelo teste

Atenção: O método find() não altera o array original.

Sintaxe:

array.find(callback, thisArg)
var num = [1, 30, 39, 29, 10, 13];
var val = num.find(myFunc);
function myFunc(element) {
return element >= 18;
}
Teste para ver‹/›

Por favor, consulte tambémfindIndex()Método, que retorna o índice do elemento encontrado no array em vez de seu valor.

Compatibilidade do navegador

Os números na tabela especificam a primeira versão do navegador que suporta completamente o método find():

Método
find()452532812

Valor do parâmetro

ParâmetroDescrição
callback
Função executada para cada elemento do array
Parâmetros da função:
  • element(Obrigatório)-Elemento atual que está sendo tratado no array

  • index(Opcional)-Índice do elemento atual que está sendo tratado no array

  • array(Opcional)- Objeto de array ao qual o elemento atual pertence

thisArg

(Opcional)Executarcallbackusado comothisObjeto

Os valores passados para a função geralmente são usados como valor de "this"
Se este parâmetro estiver vazio, "undefined" será passado para o valor de "this"

Detalhes Técnicos

Retorno:Retorna o valor do primeiro elemento do array que atende aos critérios de teste, se não houver nenhum elemento que atenda, retornaundefined
Versão do JavaScript:ECMAScript 6

 Objeto Array do JavaScript