JavaScript Array findLast()
- Página anterior findIndex()
- Próxima página findLastIndex()
- Voltar para a camada superior Manual de Referência Array JavaScript
Definição e uso
findLast()
O método retorna o valor do último elemento que passou no teste.
findLast()
O método executa uma função para cada elemento do array.
Se nenhum elemento for encontrado:findLast()
O método retorna undefined.
findLast()
O método não executa a função para elementos de array vazios.
findLast()
O método não altera o array original.
Métodos de busca em arrays:
Método | Conteúdo de busca |
---|---|
indexOf() | Índice do primeiro elemento com o valor especificado. |
lastIndexOf() | Índice do último elemento com o valor especificado. |
find() | Valor do primeiro elemento que passou no teste. |
findIndex() | Índice do primeiro elemento que passou no teste. |
findLast() | O valor do último elemento testado. |
findLastIndex() | Índice do último elemento que passou no teste. |
Exemplo
Exemplo 1
Encontrar o último 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.findLast(checkAge); }
Exemplo 2
Encontrar o último elemento com um valor maior que o número especificado:
<p><input type="number" id="ageToCheck" value="18"></p> <button onclick="myFunction()">Tente isso</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.findLast(checkAge); } </script>
Sintaxe
array.findLast(function(currentValue, index, arr), thisValue)
Parâmetros
Parâmetros | Descrição |
---|---|
function() | Obrigatório. A função executada para cada elemento do array. |
currentValue | Obrigatório. O valor do elemento atual. |
index | Opcional. O índice do elemento atual. |
arr | Opcional. O array ao qual o elemento atual pertence. |
thisValue |
Opcional. O valor padrão é undefined. Valor de this passado para a função. |
Valor de retorno
Tipo | Descrição |
---|---|
O valor do último elemento testado. Se não encontrar, retorna undefined. |
Suporte do navegador
findLast()
É uma característica do ES2023.
A partir de julho de 2023, todos os navegadores modernos suportam este método:
Chrome | Edge | Firefox | Safari | Opera |
---|---|---|---|---|
Chrome 110 | Edge 110 | Firefox 115 | Safari 16.4 | Opera 96 |
Fevereiro de 2023 | Fevereiro de 2023 | Julho de 2023 | Março de 2023 | Maio de 2023 |
- Página anterior findIndex()
- Próxima página findLastIndex()
- Voltar para a camada superior Manual de Referência Array JavaScript