Matriz JavaScript findIndex()
Exemplo 1
Encontre o primeiro elemento com um valor maior que 18:
const ages = [3, 10, 18, 20];
ages.findIndex(checkAge);
function checkAge(age) {
return age > 18;
}
Definição e uso
O findIndex()
método executa uma função para cada elemento do array.
O findIndex()
método retorna o índice (posição) do primeiro elemento que passa em um teste.
O findIndex()
método retorna -1 se nenhuma correspondência for encontrada.
O findIndex()
método não executa a função para elementos de array vazios.
O findIndex()
método não altera a matriz original.
Sintaxe
array.findIndex(function(currentValue, index, arr), thisValue)
Parâmetros
Parameter | Description |
function() | Required. A function to be run for each array element. |
currentValue | Required. The value of the current element. |
index | Optional. The index of the current element. |
arr | Optional. The array of the current element. |
thisValue | Optional. Default undefined .A value passed to the function as its this value. |
Valor de retorno
Modelo | Descrição |
Um número |
O índice do primeiro elemento que passa no teste. Caso contrário -1. |
Suporte ao navegador
findIndex()
é um recurso ECMAScript6 (ES6).
O ES6 (JavaScript 2015) é compatível com todos os navegadores modernos:
Chrome | Edge | Firefox | Safari | Opera |
Yes | Yes | Yes | Yes | Yes |
findIndex()
não é compatível com o Internet Explorer 11 (ou anterior).
Mais exemplos
Encontre o primeiro elemento com um valor acima de um valor de entrada:
<p><input type="number" id="toCheck" value="18"></p>
<button onclick="myFunction()">Test</button>
<p>Any values above: <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.findIndex(checkValue);
}
</script>