Array : méthode find() - JavaScript | MDN

Basculer la barre latérale

Thème

Automatique
Clair
Sombre

Français

Se souvenir de la langue En savoir plus

Array : méthode find()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2015.

La méthode find() des instances de Array retourne le premier élément du tableau fourni qui satisfait la fonction de test donnée. Si aucune valeur ne satisfait la fonction de test, undefined est retourné.

Si vous avez besoin de l'indice de l'élément trouvé dans le tableau, utilisez findIndex().
Si vous souhaitez trouver l'indice d'une valeur, utilisez indexOf(). (C'est similaire à findIndex(), mais chaque élément est comparé à la valeur pour l'égalité, au lieu d'utiliser une fonction de test.)
Si vous souhaitez savoir si une valeur existe dans un tableau, utilisez includes(). Là encore, chaque élément est comparé à la valeur pour l'égalité, au lieu d'utiliser une fonction de test.
Si vous souhaitez savoir si au moins un élément satisfait la fonction de test, utilisez some().
Si vous souhaitez obtenir tous les éléments qui satisfont la fonction de test, utilisez filter().

Dans cet article

Exemple interactif

const array = [5, 12, 8, 130, 44];

const found = array.find((element) => element > 10);

console.log(found);
// Résultat attendu : 12

Syntaxe

js
find(callbackFn)
find(callbackFn, thisArg)

Paramètres

callbackFn

Une fonction à exécuter pour chaque élément du tableau. Elle doit retourner une valeur vraie pour indiquer qu'un élément correspondant a été trouvé, et une valeur fausse sinon. La fonction est appelée avec les arguments suivants :

element

L'élément actuellement traité dans le tableau.

index

L'indice de l'élément actuellement traité dans le tableau.

array

Le tableau sur lequel la méthode find() a été appelée.

thisArg Facultatif

Une valeur à utiliser comme this lors de l'exécution de callbackFn. Voir méthodes itératives.

Valeur de retour

Le premier élément du tableau qui satisfait la fonction de test fournie. Sinon, undefined est retourné.

Description

La méthode find() est une méthode itérative. Elle appelle la fonction callbackFn fournie une fois pour chaque élément du tableau, dans l'ordre croissant des indices, jusqu'à ce que callbackFn retourne une valeur vraie. find() retourne alors cet élément et arrête l'itération. Si callbackFn ne retourne jamais de valeur vraie, find() retourne undefined. Consultez la section méthodes itératives pour plus d'informations sur le fonctionnement général de ces méthodes.

callbackFn est appelée pour chaque indice du tableau, pas seulement ceux qui ont une valeur assignée. Les cases vides dans les tableaux creux se comportent comme si leur valeur était undefined.

La méthode find() est générique. Elle attend seulement que la valeur de this possède une propriété length et des propriétés à clé entière.

Exemples

Trouver un objet dans un tableau grâce à une de ses propriétés

js
const inventaire = [
  { nom: "pommes", quantité: 2 },
  { nom: "bananes", quantité: 0 },
  { nom: "cerises", quantité: 5 },
];

function estCerises(fruit) {
  return fruit.nom === "cerises";
}

console.log(inventaire.find(estCerises));
// { nom: 'cerises', quantité: 5}

Utiliser les fonctions fléchées ES6/ES2015

js
const inventaire = [
  { nom: "pommes", quantité: 2 },
  { nom: "bananes", quantité: 0 },
  { nom: "cerises", quantité: 5 },
];

const resultat = inventaire.find((fruit) => fruit.nom === "cerises");
console.log(resultat);
// { nom: 'cerises', quantité: 5}

Trouver un nombre premier dans un tableau

L'exemple suivant retourne le premier élément du tableau qui est un nombre premier, ou undefined s'il n'y en a pas.

js
function estPremier(n) {
  if (n < 2) {
    return false;
  }
  if (n % 2 === 0) {
    return n === 2;
  }
  for (let facteur = 3; facteur * facteur <= n; facteur += 2) {
    if (n % facteur === 0) {
      return false;
    }
  }
  return true;
}

console.log([4, 6, 8, 12].find(estPremier)); // undefined, rien trouvé
console.log([4, 5, 8, 12].find(estPremier)); // 5

Note : L'implémentation de estPremier() est uniquement destinée à la démonstration. Pour une utilisation réelle, il est préférable d'utiliser un algorithme fortement mémoïsé, comme le crible d'Ératosthène, afin d'éviter des calculs répétés.

Utiliser le troisième argument de callbackFn

L'argument array est utile si vous souhaitez accéder à un autre élément du tableau, en particulier lorsque vous n'avez pas de variable existante qui fait référence au tableau. L'exemple suivant utilise d'abord filter() pour extraire les valeurs positives, puis find() pour trouver le premier élément qui est inférieur à ses voisins.

js
const nombres = [3, -1, 1, 4, 1, 5, 9, 2, 6];
const premierCreux = nombres
  .filter((num) => num > 0)
  .find((num, idx, arr) => {
    // Sans l'argument arr, il n'y a aucun moyen simple d'accéder
    // au tableau intermédiaire sans le stocker dans une variable.
    if (idx > 0 && num >= arr[idx - 1]) return false;
    if (idx < arr.length - 1 && num >= arr[idx + 1]) return false;
    return true;
  });
console.log(premierCreux); // 1

Utiliser find() sur des tableaux creux

Les cases vides dans les tableaux creux sont parcourues et sont traitées comme si leur valeur était undefined.

js
// Déclare un tableau sans éléments aux indices 2, 3 et 4
const array = [0, 1, , , , 5, 6];

// Affiche tous les indices, pas seulement ceux avec une valeur assignée
array.find((value, index) => {
  console.log("Indice visité", index, "avec la valeur", value);
  return false;
});
// Indice visité 0 avec la valeur 0
// Indice visité 1 avec la valeur 1
// Indice visité 2 avec la valeur undefined
// Indice visité 3 avec la valeur undefined
// Indice visité 4 avec la valeur undefined
// Indice visité 5 avec la valeur 5
// Indice visité 6 avec la valeur 6

// Affiche tous les indices, y compris ceux supprimés
array.find((value, index) => {
  // Supprime l'élément 5 lors de la première itération
  if (index === 0) {
    console.log("Suppression de array[5] avec la valeur", array[5]);
    delete array[5];
  }
  // L'élément 5 est tout de même visité même après suppression
  console.log("Indice visité", index, "avec la valeur", value);
  return false;
});
// Suppression de array[5] avec la valeur 5
// Indice visité 0 avec la valeur 0
// Indice visité 1 avec la valeur 1
// Indice visité 2 avec la valeur undefined
// Indice visité 3 avec la valeur undefined
// Indice visité 4 avec la valeur undefined
// Indice visité 5 avec la valeur undefined
// Indice visité 6 avec la valeur 6

Appeler find() sur des objets qui ne sont pas des tableaux

La méthode find() lit la propriété length de this puis accède à chaque propriété dont la clé est un entier non négatif inférieur à length.

js
const objetSimilaireTableau = {
  length: 3,
  "-1": 0.1, // ignoré par find() car -1 < 0
  0: 2,
  1: 7.3,
  2: 4,
};
console.log(
  Array.prototype.find.call(objetSimilaireTableau, (x) => !Number.isInteger(x)),
);
// 7.3

Guide des collections indexées
L'objet global Array
La méthode Array.prototype.findIndex()
La méthode Array.prototype.findLast()
La méthode Array.prototype.findLastIndex()
La méthode Array.prototype.includes()
La méthode Array.prototype.filter()
La méthode Array.prototype.every()
La méthode Array.prototype.some()
La méthode TypedArray.prototype.find()
Prothèse d'émulation core-js pour Array.prototype.find (angl.)
Prothèse d'émulation es-shims pour Array.prototype.find (angl.)

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 6 nov. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Array
Constructeur
1. Array()
Méthodes statiques
Propriétés statiques
1. [Symbol.species]
Méthodes d'instance
Propriétés d'instance
1. length
2. [Symbol.unscopables]
Héritage
Object/Function
Méthodes statiques
Propriétés statiques
Méthodes d'instance
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor