tutoriais mais recente desenvolvimento web
 

JavaScript find Array () Método

JavaScript Matriz de Referência JavaScript Matriz de Referência

Exemplo

Obter o valor do primeiro elemento da matriz que tem um valor de 18 ou mais:

var ages = [3, 10, 18, 20];

function checkAdult(age) {
    return age >= 18;
}

function myFunction() {
    document.getElementById("demo").innerHTML = ages.find(checkAdult);
}

O resultado será:

18
Tente você mesmo "

Mais "Tente você mesmo" exemplos abaixo.

Definição e Uso

O find() retorna o valor do primeiro elemento de uma matriz que passar por um teste (fornecido como uma função).

O find() método executa a função uma vez para cada elemento presente na matriz:

  • Se ele encontrar um elemento da matriz em que a função retorna um valor verdadeiro, find () retorna o valor desse elemento array (e não verifica os valores restantes)
  • Caso contrário, ele retorna indefinido

Nota: find () não executa a função de elementos do array sem valores.

Nota: find () não altera a matriz original.

Suporte a navegadores

Os números na tabela especificar a primeira versão do browser que suporta totalmente o método.

Método
find() 45,0 12.0 25,0 7.1 32,0

Sintaxe

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

Os valores dos parâmetros

Parameter Description
function(currentValue, index,arr) Required. A function to be run for each element in the array.
Function arguments:
Argument Description
currentValue Required. The value of the current element
index Optional. The array index of the current element
arr Optional. The array object the current element belongs to
thisValue Optional. A value to be passed to the function to be used as its "this" value.
If this parameter is empty, the value "undefined" will be passed as its "this" value

Detalhes técnicos

Valor de retorno: Retorna o valor do elemento da matriz, quando qualquer um dos elementos na matriz passar no teste, caso contrário, ele retorna indefinido
JavaScript Versão: ECMAScript 6
Exemplos

mais Exemplos

Exemplo

Obter o valor do primeiro elemento da matriz que tem um valor superior a um número específico:

<p>Minimum age: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Try it</button>

<p>Any ages above: <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>
Tente você mesmo "
JavaScript Matriz de Referência JavaScript Matriz de Referência