JavaScript Array find()

Définition et utilisation

find() La méthode retourne la valeur de l'élément du tableau premier qui passe le test (fourni en tant que fonction).

find() La méthode exécute la fonction une fois pour chaque élément existant du tableau :

  • Si la fonction renvoie true pour un élément du tableau, find() retourne la valeur de cet élément du tableau (et ne vérifie pas les valeurs restantes)
  • Sinon, retourner undefined

Remarque :find() Ne pas exécuter la fonction sur un tableau vide.

Remarque :find() Ne pas changer l'array original.

Exemple

Exemple 1

Obtenir la valeur de l'élément du tableau premier qui est 18 ou plus grand :

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

Essayez-le vous-même

Exemple 2

Récupère la valeur de l'élément du tableau dont la valeur est supérieure à un nombre spécifique :

<p>Minimum age: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Try it</button>
<p>Any ages above: <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>

Essayez-le vous-même

Syntaxe

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

valeur du paramètre

Paramètres Description
function(currentValue, index, arr) Obligatoire. La fonction à exécuter pour chaque élément de l'array.

Paramètres de la fonction :

Paramètres Description
currentValue Obligatoire. La valeur de l'élément courant
index Optionnel. L'index de l'élément courant dans l'array
arr Optionnel. L'objet d'array auquel appartient l'élément courant
thisValue

Optionnel. La valeur à transmettre à la fonction en tant que valeur "this".

Si ce paramètre est vide, la valeur "undefined" sera transmise comme sa valeur "this".

Détails techniques

Valeur de retour : Si tout élément de l'array passe le test, retourne la valeur de l'élément de l'array, sinon retourne undefined.
Version de JavaScript : ECMAScript 6

Support du navigateur

Les numéros dans le tableau indiquent la première version du navigateur qui prend en charge cette méthode.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
septembre 2015 juillet 2015 juillet 2014 septembre 2014 septembre 2015

Remarque :Internet Explorer ne supporte pas find() Méthode.

Pages associées

Tutoriel :Tableau JavaScript

Tutoriel :Const tableau JavaScript

Tutoriel :Méthodes de tableau JavaScript

Tutoriel :Triage des tableaux JavaScript

Tutoriel :Itération des tableaux JavaScript