JavaScript Array find()

Definizione e uso

find() La funzione restituisce il valore del primo elemento dell'array che supera il test (fornito come funzione)

find() La funzione esegue una volta la funzione su ogni elemento esistente dell'array:

  • Se trova un elemento dell'array per il quale la funzione restituisce true, find() restituisce il valore di quell'elemento dell'array (senza controllare i valori rimanenti)
  • Altrimenti restituisce undefined

Nota:find() Non eseguire la funzione su un array vuoto.

Nota:find() Non cambia l'array originale.

Esempio

Esempio 1

Ottieni il valore dell'elemento della matrice che è 18 o maggiore:

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

Prova da solo

Esempio 2

Ottieni il valore dell'elemento della matrice che ha un valore superiore a un numero specifico:

<p>Età minima: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Prova</button>
<p>Età superiori 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>

Prova da solo

Sintassi

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

Valore del parametro

Parametro Descrizione
function(currentValue, index, arr) Obbligatorio. La funzione eseguita per ogni elemento dell'array.

Parametri della funzione:

Parametro Descrizione
currentValue Obbligatorio. Il valore dell'elemento corrente.
index Opzionale. L'indice dell'array dell'elemento corrente.
arr Opzionale. L'oggetto array di appartenenza dell'elemento corrente.
thisValue

Opzionale. Il valore da passare alla funzione come valore "this".

Se questo parametro è vuoto, il valore "undefined" viene passato come valore "this".

Dettagli tecnici

Valore di ritorno: Se qualsiasi elemento dell'array supera il test, restituisce il valore dell'elemento dell'array, altrimenti restituisce undefined.
Versione di JavaScript: ECMAScript 6

Supporto del browser

I numeri nella tabella indicano la versione del browser che supporta completamente questo metodo.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
Settembre 2015 Luglio 2015 Luglio 2014 Settembre 2014 Settembre 2015

Nota:Internet Explorer non supporta find() Metodo.

Pagine correlate

Tutorial:Array JavaScript

Tutorial:Array Const JavaScript

Tutorial:Metodi degli array JavaScript

Tutorial:Ordinamento degli array JavaScript

Tutorial:Iterazione degli array JavaScript