JavaScript Array findLast()

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);
}

Experimente você mesmo

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>

Experimente você mesmo

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