JavaScript Array find()

Definición y uso

find() La función devuelve el valor del primer elemento que pasa la prueba en el array (como función proporcionada).

find() La función 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, find() devuelve el valor del elemento del array (sin verificar los valores restantes)
  • De lo contrario, devuelve undefined

Notas:find() No ejecutar la función en un array vacío.

Notas:find() No cambia el array original.

Ejemplo

Ejemplo 1

Obtener el valor del primer elemento del array que es 18 o mayor:

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

Prueba por tu cuenta

Ejemplo 2

Obtener el valor del primer elemento del array cuyos valores son superiores a un número específico:

<p>Edad mínima: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Probar</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.find(checkAdult);
}
</script>

Prueba por tu cuenta

Sintaxis

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

valor de los parámetros

Parámetros Descripción
function(currentValue, index, arr) Obligatorio. Función que se ejecuta para cada elemento del array.

Parámetros de la función:

Parámetros Descripción
currentValue Obligatorio. Valor del elemento actual.
index Opcional. Índice del array del elemento actual.
arr Opcional. Objeto de array al que pertenece el elemento actual.
thisValue

Opcional. Valor a transmitir a la función para usarlo como su valor "this".

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

Detalles técnicos

Valor devuelto: Si cualquier elemento del array pasa la prueba, se devuelve el valor del elemento del array, de lo contrario, se devuelve undefined.
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 find() Métodos.

Páginas relacionadas

Tutoriales:Arrays en JavaScript

Tutoriales:Const de arrays en JavaScript

Tutoriales:Métodos de arrays en JavaScript

Tutoriales:Ordenación de arrays en JavaScript

Tutoriales:Iteración de arrays en JavaScript