Metoda flatMap

Metoda flatMap zwraca nową tablicę, utworzoną po tym, jak do każdego elementu tablicy źródłowej zastosowano funkcję zwrotną (callback), określoną w parametrze metody. Na pierwszy rzut oka metoda flatMap przypomina metodę map, ale jej główna różnica polega na tym, że zawsze zwraca tablicę jednowymiarową.

Składnia

let newArray = array.flatMap(function);

Przykład

Otrzymajmy nową tablicę, używając metody flatMap:

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

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

console.log(res);

Wynik wykonania kodu:

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

Przykład

Otrzymajmy nową tablicę z tablicy źródłowej składającej się z liczb:

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

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

console.log(res);

Wynik wykonania kodu:

[3, 4, 5, 6, 7]

Przykład

Spróbujmy zastosować metodę flatMap do tablicy z pierwszym poziomem zagnieżdżenia:

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

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

console.log(res);

Po wykonaniu kodu zobaczymy, że warunki funkcji zastosowały się do podtablicy, traktując ją jako jeden element. Dlatego wywołanie tej metody w przypadku zagnieżdżonych tablic nie ma sensu:

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

Przykład

Jeśli chcemy, aby nie przejmować się poziomem zagnieżdżenia, a połączyć całą tablicę, używamy parametru Infinity:

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

let res = arr.flatMap(Infinity);

console.log(res);

Wynik wykonania kodu:

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

Przykład

Zastosujmy do tablicy dwie metody: flatMap i map, przy czym w parametrze obu metod będzie określona funkcja, która tworzy tablicę dwuwymiarową:

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

console.log('metoda map', res1);
console.log('metoda flatMap', res2);

Wynik wykonania kodu:

'metoda map' [[3], [6], [9], [12], [15], [18]]
'metoda flatMap' [3, 6, 9, 12, 15, 18]

Zobacz też

metoda flat,
która zwraca tablicę z podtablic