JavaScript Array findIndex()

Definición y uso

findIndex() El método devuelve el índice del primer elemento que pasa la prueba en el array (como función proporcionada).

findIndex() El método ejecuta la función una vez para cada elemento existente en el array:

  • Si encuentra un elemento del array que devuelva el valor true de la función, findIndex() devuelve el índice de ese elemento del array (y no verifica los valores restantes)
  • En caso contrario, devuelve -1

Notas:findIndex() No ejecutará la función para los elementos del array sin valor.

Notas:findIndex() No cambiará el array original.

Ejemplo

Ejemplo 1

Obtener el índice del elemento en el array que es igual o mayor a 18:

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

Prueba por tu cuenta

Ejemplo 2

Obtener el índice del primer elemento del array que tiene un valor superior a un número específico:

<p>Edad mínima: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Prueba</button>
<p>Edades superiores a: <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>

Prueba por tu cuenta

Sintaxis

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

Valor de los parámetros

Parámetros Descripción
function(currentValue, index, arr) Requerido. La función que se ejecutará en cada elemento del array.

Parámetros de la función:

Parámetros Descripción
currentValue Requerido. El valor del elemento actual.
index Opcional. El índice del array del elemento actual.
arr Opcional. El objeto de array al que pertenece el elemento actual.
thisValue

Opcional. El valor que se pasará a la función para usarse como su valor "this".

Si este parámetro está vacío, el valor "undefined" se transmitirá como su valor "this".

Detalles técnicos

Valor de retorno: Si cualquier elemento del array pasa la prueba, se devuelve la posición del elemento del array, de lo contrario se devuelve -1.
Versión de JavaScript: ECMAScript 6

Compatibilidad del navegador

Los números en la tabla indican la primera versión del navegador que admite completamente este método.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
septiembre de 2015 julio de 2015 julio de 2014 septiembre de 2014 septiembre de 2015

Notas:Internet Explorer no es compatible findIndex() Métodos.

Páginas relacionadas

Tutoriales:Arrays en JavaScript

Tutoriales:Const de arrays en JavaScript

Tutoriales:Métodos de arrays en JavaScript

Tutoriales:Ordenar arrays en JavaScript

Tutoriales:Iteración de arrays en JavaScript