From bf8e099b9c8b3c60d60b3712b4fc97b052c39887 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:23 +0200 Subject: convert content to md --- .../reference/global_objects/array/find/index.md | 146 +++++++++------------ 1 file changed, 65 insertions(+), 81 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/array/find') diff --git a/files/fr/web/javascript/reference/global_objects/array/find/index.md b/files/fr/web/javascript/reference/global_objects/array/find/index.md index 19ef805ebd..c66c0ac9db 100644 --- a/files/fr/web/javascript/reference/global_objects/array/find/index.md +++ b/files/fr/web/javascript/reference/global_objects/array/find/index.md @@ -12,59 +12,56 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Array/find original_slug: Web/JavaScript/Reference/Objets_globaux/Array/find --- -
{{JSRef}}
+{{JSRef}} -

La méthode find() renvoie la valeur du premier élément trouvé dans le tableau qui respecte la condition donnée par la fonction de test passée en argument. Sinon, la valeur {{jsxref("undefined")}} est renvoyée.

+La méthode **`find()`** renvoie la **valeur** du **premier élément trouvé** dans le tableau qui respecte la condition donnée par la fonction de test passée en argument. Sinon, la valeur {{jsxref("undefined")}} est renvoyée. -
{{EmbedInteractiveExample("pages/js/array-find.html")}}
+{{EmbedInteractiveExample("pages/js/array-find.html")}} +Voir aussi la méthode {{jsxref("Array.findIndex", "findIndex()")}} qui renvoie l'**index** de l'élément trouvé et non sa valeur. Si on souhaite repérer la position d'un élément donné dans le tableau, on pourra utiliser {{jsxref("Array.prototype.indexOf()")}}. Si on souhaite déterminer si un tableau contient un élément donné, on pourra utiliser la méthode {{jsxref("Array.prototype.includes()")}}. +## Syntaxe -

Voir aussi la méthode {{jsxref("Array.findIndex", "findIndex()")}} qui renvoie l'index de l'élément trouvé et non sa valeur. Si on souhaite repérer la position d'un élément donné dans le tableau, on pourra utiliser {{jsxref("Array.prototype.indexOf()")}}. Si on souhaite déterminer si un tableau contient un élément donné, on pourra utiliser la méthode {{jsxref("Array.prototype.includes()")}}.

+ arr.find(callback(element[, index[, tableau]])[, thisArg]) -

Syntaxe

+### Paramètres -
arr.find(callback(element[, index[, tableau]])[, thisArg])
+- `callback` -

Paramètres

+ - : Fonction à exécuter sur chaque valeur du tableau, elle prend 3 arguments : -
-
callback
-
Fonction à exécuter sur chaque valeur du tableau, elle prend 3 arguments : -
-
element
-
L'élément actuellement traité dans le tableau.
-
index{{optional_inline}}
-
L'index de l'élément actuellement traité dans le tableau
-
array{{optional_inline}}
-
Le tableau pour lequel la méthode find a été appelée.
-
-
-
thisArg {{optional_inline}}
-
Ce paramètre est optionnel. Objet à utiliser en tant que this lorsque la fonction callback est exécutée.
-
+ - `element` + - : L'élément actuellement traité dans le tableau. + - `index`{{optional_inline}} + - : L'index de l'élément actuellement traité dans le tableau + - `array`{{optional_inline}} + - : Le tableau pour lequel la méthode `find` a été appelée. -

Valeur de retour

+- `thisArg` {{optional_inline}} + - : Ce paramètre est optionnel. Objet à utiliser en tant que `this` lorsque la fonction `callback` est exécutée. -

La valeur du premier élément du tableau qui réussit le test, sinon {{jsxref("undefined")}}.

+### Valeur de retour -

Description

+La valeur du premier élément du tableau qui réussit le test, sinon {{jsxref("undefined")}}. -

La méthode find exécute la fonction callback une fois pour chaque élément présent dans le tableau jusqu'à ce qu'elle retourne une valeur vraie (qui peut être convertie en true). Si un élément est trouvé, find retourne immédiatement la valeur de l'élément. Autrement, find retourne undefined. La méthode callback est seulement appelée pour les index du tableau pour lesquels on dispose d'une valeur. Elle n'est pas appelée pour les index supprimés ou pour ceux qui n'ont pas de valeur.

+## Description -

La méthode callback est appelée avec trois arguments : la valeur de l'élément, l'index de l'élément, et l'objet correspondant au tableau traversé.

+La méthode `find` exécute la fonction `callback` une fois pour chaque élément présent dans le tableau jusqu'à ce qu'elle retourne une valeur vraie (qui peut être convertie en `true`). Si un élément est trouvé, `find` retourne immédiatement la valeur de l'élément. Autrement, `find` retourne `undefined`. La méthode `callback` est seulement appelée pour les index du tableau pour lesquels on dispose d'une valeur. Elle n'est pas appelée pour les index supprimés ou pour ceux qui n'ont pas de valeur. -

Si le paramètre thisArg est fourni à find, il sera utilisé comme le this pour chaque exécution de la fonction callback. S'il n'est pas fourni, alors {{jsxref("undefined")}} sera utilisé.

+La méthode `callback` est appelée avec trois arguments : la valeur de l'élément, l'index de l'élément, et l'objet correspondant au tableau traversé. -

find ne modifie pas le tableau à partir duquel elle est appelée.

+Si le paramètre `thisArg` est fourni à `find`, il sera utilisé comme le `this` pour chaque exécution de la fonction `callback`. S'il n'est pas fourni, alors {{jsxref("undefined")}} sera utilisé. -

L'intervalle des éléments inspectés par find est défini avant la première exécution de callback. Les éléments ajoutés au tableau après l'appel à find ne seront pas inspectés par la fonction callback. Si un élément existant est modifié avant le passage du callback, alors la valeur traitée par le callback sera celle présente lors du passage de find sur son index. Les éléments supprimés ne seront pas traités.

+`find` ne modifie pas le tableau à partir duquel elle est appelée. -

Exemples

+L'intervalle des éléments inspectés par `find` est défini avant la première exécution de `callback`. Les éléments ajoutés au tableau après l'appel à `find` ne seront pas inspectés par la fonction `callback`. Si un élément existant est modifié avant le passage du `callback`, alors la valeur traitée par le `callback` sera celle présente lors du passage de `find` sur son index. Les éléments supprimés ne seront pas traités. -

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

+## Exemples -
const inventaire = [
+### 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}
@@ -75,68 +72,55 @@ function estCerises(fruit) {
 }
 
 console.log(inventaire.find(estCerises));
-// { nom: 'cerises', quantité: 5}
+// { nom: 'cerises', quantité: 5} +``` -

Utiliser les fonctions fléchées ES6/ES2015

+#### Utiliser les fonctions fléchées ES6/ES2015 -
const inventaire = [
+```js
+const inventaire = [
                      {nom: 'pommes', quantité: 2},
                      {nom: 'bananes', quantité: 0},
                      {nom: 'cerises', quantité: 5}
                    ];
 
-const resultat = inventaire.find( fruit => fruit.nom === 'cerises');
+const resultat = inventaire.find( fruit => fruit.nom === 'cerises');
 console.log(resultat);
-// { nom: 'cerises', quantité: 5}
+// { nom: 'cerises', quantité: 5} +``` -

Trouver un nombre premier dans un tableau

+### Trouver un nombre premier dans un tableau -

Dans l'exemple suivant, on cherche un nombre premier parmi les éléments d'un tableau (ou retourne undefined s'il n'y en a pas ).

+Dans l'exemple suivant, on cherche un nombre premier parmi les éléments d'un tableau (ou retourne `undefined` s'il n'y en a pas ). -
function estPremier(element, index, array) {
+```js
+function estPremier(element, index, array) {
     let début = 2;
-    while (début <= Math.sqrt(element)) {
-        if (element % début ++ < 1) return false;
+    while (début <= Math.sqrt(element)) {
+        if (element % début ++ < 1) return false;
     }
-    return (element > 1);
+    return (element > 1);
 }
 
 console.log( [4, 6, 8, 12].find(estPremier) ); // undefined, rien trouvé
 console.log( [4, 5, 8, 12].find(estPremier) ); // 5
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-array.prototype.find', 'Array.prototype.find')}}{{Spec2('ES2015')}}Définition initiale
{{SpecName('ESDraft', '#sec-array.prototype.find', 'Array.prototype.find')}}{{Spec2('ESDraft')}}
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Array.find")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------- | ---------------------------- | ------------------- | +| {{SpecName('ES2015', '#sec-array.prototype.find', 'Array.prototype.find')}} | {{Spec2('ES2015')}} | Définition initiale | +| {{SpecName('ESDraft', '#sec-array.prototype.find', 'Array.prototype.find')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Array.find")}} + +## Voir aussi + +- {{jsxref("Array.prototype.findIndex()")}} – trouver et renvoyer un index +- {{jsxref("Array.prototype.includes()")}} – tester si une valeur existe dans le tableau +- {{jsxref("Array.prototype.filter()")}} – trouver tous les éléments correspondants +- {{jsxref("Array.prototype.every()")}} – tester l'ensemble des éléments d'un tableau +- {{jsxref("Array.prototype.some()")}} – tester si au moins un élément du tableau respecte un critère -- cgit v1.2.3-54-g00ecf