JavaScript Array find()

Definição e uso

find() A função retorna o valor do primeiro elemento que passa no teste (como função fornecida).

find() A função é executada uma vez para cada elemento existente no array:

  • Se encontrar um elemento do array cujo valor retorna true para a função fornecida, o find() retorna o valor do elemento do array (e não verifica os valores restantes)
  • Caso contrário, retorna undefined

Notas:find() Não executar a função em um array vazio.

Notas:find() Não altera o array original.

Exemplo

Exemplo 1

Obter o valor do primeiro elemento do array que é 18 ou maior:

var idades = [3, 10, 18, 20];
function checkAdult(age) {
  return age >= 18;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.find(checkAdult);
}

Experimente você mesmo

Exemplo 2

Obter o valor do primeiro elemento do array cujo valor é maior que um número específico:

<p>Idade mínima: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Experimente</button>
<p>Qualquer idade acima de: <span id="demo"></span></p>
<script>
var ages = [4, 12, 16, 20];
function checkAdult(age) {
  return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.find(checkAdult);
}
</script>

Experimente você mesmo

Sintaxe

array.find(function(currentValue, index, arr) thisValue)

Valor do parâmetro

Parâmetros Descrição
function(currentValue, index, arr) Obrigatório. A função executada para cada elemento do array.

Parâmetros da função:

Parâmetros Descrição
currentValue Obrigatório. O valor do elemento atual.
index Opcional. O índice do elemento atual no array.
arr Opcional. O objeto de array ao qual o elemento atual pertence.
thisValue

Opcional. O valor a ser passado para a função para ser usado como seu valor "this".

Opcional. O valor a ser passado para a função como seu valor "this".

Detalhes técnicos

Valor de retorno: Se qualquer elemento do array passar no teste, retorna o valor do elemento do array, caso contrário, retorna undefined.
Versão do JavaScript: ECMAScript 6

Suporte do navegador

Os números na tabela indicam a primeira versão do navegador que suporta completamente este método.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
Setembro de 2015 Julho de 2015 Julho de 2014 Setembro de 2014 Setembro de 2015

Notas:Internet Explorer não é compatível find() Métodos.

Páginas relacionadas

Tutorial:Array do JavaScript

Tutorial:Const do Array do JavaScript

Tutorial:Métodos de Array do JavaScript

Tutorial:Ordenação de Array do JavaScript

Tutorial:Iteração de Array do JavaScript