JavaScript Array findLastIndex()
- Página anterior findLast()
- Próxima página flat()
- Voltar à página anterior Manual de Referência Array JavaScript
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; }
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>
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 |
- Página anterior findLast()
- Próxima página flat()
- Voltar à página anterior Manual de Referência Array JavaScript