Metóda flatMap

Metóda flatMap vracia nové pole vytvorené po tom, ako na každý prvok pôvodného poľa bol aplikovaný spätné volanie, špecifikované v parametri metódy. Na prvý pohľad je metóda flatMap podobná metóde map, ale jej hlavný rozdiel spočíva v tom, že vždy vracia jednorozmerné pole.

Syntax

let newArray = pole.flatMap(funkcia);

Príklad

Získajme nové pole použitím metódy flatMap:

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

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

console.log(res);

Výsledok vykonania kódu:

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

Príklad

Získajme nové pole z pôvodného poľa pozostávajúceho z čísel:

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

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

console.log(res);

Výsledok vykonania kódu:

[3, 4, 5, 6, 7]

Príklad

Skúsme použiť metódu flatMap na pole s prvou úrovňou vnorenia:

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

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

console.log(res);

Po vykonaní kódu uvidíme, že podmienky funkcie boli aplikované na podpole, pričom bolo považované za jeden prvok. Preto volanie tejto metódy na vnorené polia nemá zmysel:

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

Príklad

Ak nechceme riešiť úroveň vnorenia, ale chceme spojiť celé pole, použijeme parameter Infinity:

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

let res = arr.flatMap(Infinity);

console.log(res);

Výsledok vykonania kódu:

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

Príklad

Aplikujme na pole dve metódy: flatMap a map, pričom v parametri oboch metód bude špecifikovaná funkcia, ktorá robí pole dvojrozmerným:

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

console.log('metóda map', res1);
console.log('metóda flatMap', res2);

Výsledok vykonania kódu:

'metóda map' [[3], [6], [9], [12], [15], [18]]
'metóda flatMap' [3, 6, 9, 12, 15, 18]

Pozri tiež

metóda flat,
ktorá vracia pole z podpolí