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/flat/index.md | 115 ++++++++++----------- 1 file changed, 53 insertions(+), 62 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/array/flat') diff --git a/files/fr/web/javascript/reference/global_objects/array/flat/index.md b/files/fr/web/javascript/reference/global_objects/array/flat/index.md index 160e1c350b..e9ee2df63b 100644 --- a/files/fr/web/javascript/reference/global_objects/array/flat/index.md +++ b/files/fr/web/javascript/reference/global_objects/array/flat/index.md @@ -10,30 +10,29 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Array/flat original_slug: Web/JavaScript/Reference/Objets_globaux/Array/flat --- -
{{JSRef}}
+{{JSRef}} -

La méthode flat() permet de créer un nouveau tableau contenant les éléments des sous-tableaux du tableau passé en argument, qui sont concaténés récursivement pour atteindre une profondeur donnée.

+La méthode **`flat()`** permet de créer un nouveau tableau contenant les éléments des sous-tableaux du tableau passé en argument, qui sont concaténés récursivement pour atteindre une profondeur donnée. -

Syntaxe

+## Syntaxe -
var nouveauTableau = monTableau.flat([profondeur]);
+ var nouveauTableau = monTableau.flat([profondeur]); -

Paramètres

+### Paramètres -
-
profondeur {{optional_inline}}
-
Le niveau de profondeur en termes d'imbrication de tableau. Autrement dit, jusqu'à quel niveau d'imbrication un tableau imbriqué doit il être aplati. La valeur par défaut est 1.
-
+- `profondeur` {{optional_inline}} + - : Le niveau de profondeur en termes d'imbrication de tableau. Autrement dit, jusqu'à quel niveau d'imbrication un tableau imbriqué doit il être aplati. La valeur par défaut est 1. -

Valeur de retour

+### Valeur de retour -

Un nouveau tableau qui contient la concaténation des éléments des sous-tableaux du tableau passé en argument.

+Un nouveau tableau qui contient la concaténation des éléments des sous-tableaux du tableau passé en argument. -

Exemples

+## Exemples -

Aplatir des tableaux imbriqués

+### Aplatir des tableaux imbriqués -
var arr1 = [1, 2, [3, 4]];
+```js
+var arr1 = [1, 2, [3, 4]];
 arr1.flat();
 // [1, 2, 3, 4]
 
@@ -44,49 +43,54 @@ arr2.flat();
 var arr3 = [1, 2, [3, 4, [5, 6]]];
 arr3.flat(2);
 // [1, 2, 3, 4, 5, 6]
-
+``` -

Aplatir et combler les trous

+### Aplatir et combler les trous -

La méthode flat() permet également de retirer les « trous » d'un tableau :

+La méthode `flat()` permet également de retirer les « trous » d'un tableau : -
var arr4 = [1, 2, , 4, 5];
+```js
+var arr4 = [1, 2, , 4, 5];
 arr4.flat();
-// [1, 2, 4, 5]
+// [1, 2, 4, 5] +``` -

Équivalent

+## Équivalent -

reduce et concat

+### `reduce` et `concat` -
var arr = [1, 2, [3, 4]];
+```js
+var arr = [1, 2, [3, 4]];
 
 // pour un tableau avec un seul niveau de profondeur
 arr.flat();
 // est équivalent à
-arr.reduce((acc, val) => acc.concat(val), []);
+arr.reduce((acc, val) => acc.concat(val), []);
 // [1, 2, 3, 4]
 
 // avec la décomposition et les compositions flechées, on peut écrire :
-const flat = arr => [].concat(...arr);
-
+const flat = arr => [].concat(...arr); +``` -

reduce + concat + isArray + récursivité

+### `reduce` + `concat` + `isArray` + récursivité -
var arr = [1, 2, [3, 4, [5, 6]]];
+```js
+var arr = [1, 2, [3, 4, [5, 6]]];
 
 // Pour gérer plusieurs niveaux, on pourra utiliser
 // une méthode récursive avec reduce et concat
 function flatDeep(arr) {
-   return arr.reduce((acc, val) => acc.concat(Array.isArray(val) ? flatDeep(val) : val), []);
+   return arr.reduce((acc, val) => acc.concat(Array.isArray(val) ? flatDeep(val) : val), []);
 };
 
 flatDeep(arr);
 // [1, 2, 3, 4, 5, 6]
-
+``` -

Utiliser une pile

+### Utiliser une pile -
var arr = [1, 2, [3, 4]];
+```js
+var arr = [1, 2, [3, 4]];
 
 // Version non récursive utilisant une pile
 function flatStack(input) {
@@ -110,34 +114,21 @@ function flatStack(input) {
 
 flatStack(arr);
 // [1, 2, 3, 4]
-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
ECMAScript 2019FinaliséProposition initiale
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------- | -------- | -------------------- | +| [ECMAScript 2019](https://www.ecma-international.org/ecma-262/10.0/index.html#sec-array.prototype.flat) | Finalisé | Proposition initiale | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Array.flat")}} + +## Voir aussi + +- {{jsxref("Array.prototype.flatMap()")}} +- {{jsxref("Array.prototype.map()")}} +- {{jsxref("Array.prototype.reduce()")}} +- {{jsxref("Array.prototype.concat()")}} -- cgit v1.2.3-54-g00ecf