Méthode flatMap

La méthode flatMap renvoie un nouveau tableau, créé après application à chaque élément du tableau initial d'une fonction de rappel, spécifiée en paramètre de la méthode. À première vue, la méthode flatMap ressemble à la méthode map, mais sa principale différence réside dans le fait qu'elle renvoie toujours un tableau unidimensionnel.

Syntaxe

let newArray = tableau.flatMap(fonction);

Exemple

Obtenons un nouveau tableau, en utilisant la méthode flatMap :

let arr = ['a', 'b', 'c'];

let res = arr.flatMap(function(elem) {
	return elem + '!';
});

console.log(res);

Résultat de l'exécution du code :

['a!', 'b!', 'c!']

Exemple

Obtenons un nouveau tableau à partir d'un tableau initial composé de nombres :

let arr = [1, 2, 3, 4, 5];

let res = arr.flatMap(function(elem) {
	return elem + 2;
});

console.log(res);

Résultat de l'exécution du code :

[3, 4, 5, 6, 7]

Exemple

Essayons d'appliquer la méthode flatMap à un tableau avec un premier niveau d'imbrication :

let arr = [1, 2, 3, [4, 5]];

let res = arr.flatMap(function getElem(elem){
	return elem + 2;
});

console.log(res);

Après exécution du code nous verrons que les conditions de la fonction ont été appliquées au sous-tableau, le considérant comme un seul élément. C'est pourquoi l'appel de cette méthode sur des tableaux imbriqués n'a pas de sens :

[3, 4, 5, '4,52']

Exemple

Si nous ne voulons pas nous préoccuper du niveau d'imbrication, mais fusionner tout le tableau, alors utilisons le paramètre Infinity :

let arr = ['a', 'b', ['c', 'd', ['e', 'f', ['g', 'h', ['i']]]]];

let res = arr.flatMap(Infinity);

console.log(res);

Résultat de l'exécution du code :

[
	'a', 'b', 'c',
	'd', 'e', 'f',
	'g', 'h', 'i'
]

Exemple

Appliquons deux méthodes au tableau : flatMap et map, sachant que le paramètre des deux méthodes sera une fonction rendant le tableau bidimensionnel :

let arr = [1, 2, 3, 4, 5, 6];
let res1 = arr.map(elem => [elem * 3]);
let res2 = arr.flatMap(elem => [elem * 3]);

console.log('méthode map', res1);
console.log('méthode flatMap', res2);

Résultat de l'exécution du code :

'méthode map' [[3], [6], [9], [12], [15], [18]]
'méthode flatMap' [3, 6, 9, 12, 15, 18]

Voir aussi

la méthode flat,
qui renvoie un tableau à partir de sous-tableaux