JavaScript Array findLastIndex()

Definição e uso

findLastIndex() O método executa uma função para cada elemento do array.

findLastIndex() O método retorna o índice (posição) do último elemento que passou no teste.

Se não encontrar um elemento correspondente:findLastIndex() O método retorna -1.

findLastIndex() O método não executa a função para elementos de array vazio.

findLastIndex() O método não altera o array original.

Método Procurar conteúdo
indexOf() O índice do primeiro elemento com o valor especificado.
lastIndexOf() O índice do último elemento com o valor especificado.
find() O valor do primeiro elemento que passou no teste.
findIndex() O índice do primeiro elemento que passou no teste.
findLast() O valor do último elemento que passou no teste.
findLastIndex() Índice do último elemento testado.

Exemplo

Exemplo 1

Procurar o índice do último elemento cujo valor é maior que 18:

const ages = [3, 10, 18, 20];
ages.findLastIndex(checkAge);
function checkAge(age) {
  return age > 18;
}

Experimente você mesmo

Exemplo 2

Procurar o índice do último elemento cujo valor é maior que o valor de entrada:

<p><input type="number" id="toCheck" value="18"></p>
<button onclick="myFunction()">Test</button>
<p>Qualquer valor acima de: <span id="demo"></span></p>
<script>
const numbers = [4, 12, 16, 20];
function checkValue(x) {
  return x > document.getElementById("toCheck").value;
}
function myFunction() {
  document.getElementById("demo").innerHTML = numbers.findLastIndex(checkValue);
}
</script>

Experimente você mesmo

Sintaxe

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

Parâmetros

Parâmetros Descrição
function() Obrigatório. Função executada para cada elemento do array.
currentValue Obrigatório. Valor do elemento atual.
index Opcional. Índice do elemento atual.
arr Opcional. Array ao qual o elemento atual pertence.
thisValue

Opcional. Valor this passado para a função.

O valor padrão é undefined.

Valor de retorno

Tipo Descrição
Number

Índice do último elemento testado.

Se não encontrar, retorna -1.

Suporte do navegador

findLastIndex() É 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