JavaScript flatMap()Méthode
Exemple
Transformez chaque élément à l'aide d'une fonction de mappage, puis aplatissez le résultat dans un nouveau tableau :
Essayez-le »
Définition et utilisation
La méthode flatMap() applique d'abord une fonction de mappage à chaque élément, puis aplatit le résultat dans un nouveau tableau. Elle est presque identique à map suivi de flat avec une valeur de profondeur de 1, mais flatMap est généralement légèrement plus efficace lorsqu'elle est combinée en une seule méthode.
La méthode flatMap() renvoie un nouveau tableau, où chaque élément est le résultat de la fonction de rappel, et la valeur de profondeur de la structure est 1.
Prise en charge des navigateurs
Les nombres dans le tableau indiquent la première version du navigateur qui prend en charge la méthode.
| Méthode | |||||
|---|---|---|---|---|---|
| flatMap() | 45.0 | 12.0 | 32.0 | 9 | 25.0 |
Syntaxe
// 箭头函数
flatMap((currentValue) => { /* … */ } )
flatMap((currentValue, index) => { /* … */ } )
flatMap((currentValue, index, array) => { /* … */ } )
// 回调函数
flatMap(callbackFn)
flatMap(callbackFn, thisArg)
// 行内回调函数
flatMap(function(currentValue) { /* … */ })
flatMap(function(currentValue, index) { /* … */ })
flatMap(function(currentValue, index, array){ /* … */ })
flatMap(function(currentValue, index, array) { /* … */ }, thisArg)
Parameters
| Parameters | Description |
| callback | Une fonction qui peut mapper des éléments dans un nouveau tableau ; elle peut accepter trois paramètres,
|
| thisArg | Facultatif. La valeur de this à utiliser lors de l'exécution de la fonction de rappel. |
Détails techniques
| Valeur de retour : | Un tableau. |
| Version JavaScript : | ECMAScript 6 |
Plus d’exemples
map() et flatMap()
Exemple
arr1.map(x => [x * 2]);
// [[2], [4], [6], [8]]
arr1.flatMap(x => [x * 2]);
// [2, 4, 6, 8]
// un seul niveau est aplati
arr1.flatMap(x => [[x * 2]]);
// [[2], [4], [6], [8]]
Bien que le code ci-dessus semble fonctionner avec map et flatMap, cela montre seulement comment utiliser flatMap.
Ainsi, pour mieux démontrer le rôle de flatMap, ci-dessous nous divisons un tableau contenant plusieurs phrases en un nouveau tableau composé de mots individuels.
Exemple
arr1.map(x => x.split(" "));
// [["it's","Sunny","in"],[""],["California"]]
arr1.flatMap(x => x.split(" "));
// ["it's","Sunny","in", "", "California"]
Notez que la longueur de la liste de sortie peut être différente de la longueur de la liste d'entrée.
Ajouter ou supprimer certains éléments lors d'un map()
flatMap peut être utilisé pour ajouter ou supprimer des éléments lors d'un map (c'est-à-dire pour modifier le nombre d'éléments). En d'autres termes, il vous permet de parcourir de nombreux éléments et de les transformer en d'autres éléments (en les traitant individuellement), plutôt que d'être toujours un à un. En ce sens, sa fonction est similaire à l'opposé de filter. Il suffit de renvoyer un tableau de 1 élément pour conserver l'élément, de renvoyer un tableau à plusieurs éléments pour ajouter des éléments, ou de renvoyer un tableau de 0 élément pour supprimer l'élément.
Exemple
let a = [5, 4, -3, 20, 17, -33, -4, 18]
// |\ \ x | | \ x x |
// [4,1, 4, 20, 16, 1, 18]
a.flatMap( (n) =>
(n < 0) ? [] :
(n % 2 == 0) ? [n] :
[n-1, 1]
)
// sortie attendue : [4, 1, 4, 20, 16, 1, 18]
Alternatives
reduce() et concat()
Exemple
arr.flatMap(x => [x, x * 2]);
// équivaut à
arr.reduce((acc, x) => acc.concat([x, x * 2]), []);
// [1, 2, 2, 4, 3, 6, 4, 8]
Notez que ceci est inefficace et doit être évité pour les grands tableaux : à chaque itération, il crée un nouveau tableau temporaire qui doit être collecté par le ramasse-miettes, et il copie les éléments du tableau accumulateur actuel dans un nouveau tableau au lieu d'ajouter de nouveaux éléments à un tableau existant.
Autres extensions
Objet Array JavaScript