JavaScript Array findIndex()

Definição e uso

findIndex() O método retorna o índice do primeiro elemento que passar no teste (como função fornecida).

findIndex() O método executa a função para cada elemento existente no array:

  • Se encontrar um elemento do array cujo valor retornar true pela função, o findIndex() retorna o índice do elemento (e não verifica os valores restantes)
  • Caso contrário, retorna -1

Notas:findIndex() Não executa a função para elementos do array sem valor.

Notas:findIndex() Não altera o array original.

Exemplo

Exemplo 1

Obter o índice do primeiro elemento do array que é igual ou maior que 18:

var idades = [3, 10, 18, 20];
function checkAdult(age) {
  return age >= 18;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}

Experimente você mesmo

Exemplo 2

Obter o índice do primeiro elemento do array cujo valor é maior que um número específico:

<p>Idade mínima: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Experimente</button>
<p>Qualquer idade acima de: <span id="demo"></span></p>
<script>
var ages = [4, 12, 16, 20];
function checkAdult(age) {
  return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}
</script>

Experimente você mesmo

Sintaxe

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

Valor do parâmetro

Parâmetros Descrição
function(currentValue, index, arr) Obrigatório. A função executada para cada elemento do array.

Parâmetros da função:

Parâmetros Descrição
currentValue Obrigatório. O valor do elemento atual.
index Opcional. O índice do elemento atual no array.
arr Opcional. O objeto de array ao qual o elemento atual pertence.
thisValue

Opcional. O valor a ser passado para a função para usar como seu valor "this".

Se este parâmetro estiver vazio, o valor "undefined" será passado como seu valor "this".

Detalhes técnicos

Retorno: Se qualquer elemento do array passar no teste, retorna o índice do elemento do array, caso contrário, retorna -1.
Versão do JavaScript: ECMAScript 6

Suporte do navegador

Os números na tabela indicam a primeira versão do navegador que suporta completamente este método.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
Setembro de 2015 Julho de 2015 Julho de 2014 Setembro de 2014 Setembro de 2015

Notas:Internet Explorer não é compatível findIndex() Métodos.

Páginas relacionadas

Tutorial:Array do JavaScript

Tutorial:Const do Array do JavaScript

Tutorial:Métodos de Array do JavaScript

Tutorial:Ordenação de Array do JavaScript

Tutorial:Iteração de Array do JavaScript