JavaScript flatMap()Méthode

Array 对象参考手册Objet Array JavaScript

Exemple

Transformez chaque élément à l'aide d'une fonction de mappage, puis aplatissez le résultat dans un nouveau tableau :

const arr1 = [1, 2, [3], [4, 5], 6, []]; const flattened = arr1.flatMap(num => num); document.getElementById("demo").innerHTML = flattened;

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,

currentValue

L'élément actuel en cours de traitement dans le tableau

indexOptional

Facultatif. L'indice de l'élément actuel en cours de traitement dans le tableau.

arrayOptional

Facultatif. L'appelémaparray

thisArgFacultatif. 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

var arr1 = [1, 2, 3, 4];

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

let arr1 = ["it's Sunny in", "", "California"];

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

// Supposons que nous voulons supprimer tous les nombres négatifs et diviser les nombres impairs en un nombre pair et un 1
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

var arr = [1, 2, 3, 4];

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.



Array 对象参考手册Objet Array JavaScript

Autres extensions