JavaScript Array find()
Exemplo 1
Encontre o valor do primeiro elemento com um valor maior que 18:
const ages = [3, 10, 18, 20];
function checkAge(age) {
return age > 18;
}
function myFunction() {
document.getElementById("demo").innerHTML = ages.find(checkAge);
}
Definição e uso
O find()
método retorna o valor do primeiro elemento que passa em um teste.
O find()
método executa uma função para cada elemento do array.
O find()
método retorna undefined
se nenhum elemento for encontrado.
O find()
método não executa a função para elementos vazios.
O find()
método não altera a matriz original.
Sintaxe
array.find(function(currentValue, index, arr),thisValue)
Parâmetros
function() | Required. A function to run for each array element. |
currentValue | Required. The value of the current element. |
index | Optional. The index of the current element. |
arr | Optional. The array of the current element. |
thisValue | Optional. Default undefined .A value passed to the function as its this value. |
Valor de retorno
Modelo | Descrição |
Um valor |
O valor do primeiro elemento que passa no teste. Caso contrário, ele retorna undefined . |
Suporte ao navegador
find()
é um recurso ECMAScript6 (ES6).
O ES6 (JavaScript 2015) é compatível com todos os navegadores modernos:
Chrome | Edge | Firefox | Safari | Opera |
Yes | Yes | Yes | Yes | Yes |
find()
não é compatível com o Internet Explorer 11 (ou anterior).
Exemplo 2
Encontre o valor do primeiro elemento que tem um valor acima de um número específico:
<p><input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Try it</button>
<p id="demo"></p>
<script>
const ages = [4, 12, 16, 20];
function checkAge(age) {
return age > document.getElementById("ageToCheck").value;
}
function myFunction() {
document.getElementById("demo").innerHTML = ages.find(checkAge);
}
</script>