A flatMap metódus

A flatMap metódus egy új tömböt ad vissza, amely azután jön létre, hogy a forrástömb minden elemére alkalmaztuk a metódus paraméterében megadott visszahívó függvényt. Első pillantásra a flatMap metódus hasonlít a map metódusra, de fő különbsége az, hogy mindig egydimenziós tömböt ad vissza.

Szintaxis

let newArray = array.flatMap(function);

Példa

Hozzunk létre egy új tömböt a flatMap metódus segítségével:

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

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

console.log(res);

A kód végrehajtásának eredménye:

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

Példa

Hozzunk létre egy új tömböt egy számokból álló forrástömbből:

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

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

console.log(res);

A kód végrehajtásának eredménye:

[3, 4, 5, 6, 7]

Példa

Próbáljuk meg alkalmazni a flatMap metódust egy első szintű beágyazással rendelkező tömbre:

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

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

console.log(res);

A kód végrehajtása után láthatjuk, hogy a függvény feltételeit az almás tömbre alkalmaztuk, egyetlen elemnek tekintve azt. Ezért ennek a metódusnak a hívása beágyazott tömbökben nincs értelme:

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

Példa

Ha nem akarunk a beágyazottsági szinttel bajlódni, hanem egyszerűen egyesíteni szeretnénk a teljes tömböt, akkor használjuk a Infinity paramétert:

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

let res = arr.flatMap(Infinity);

console.log(res);

A kód végrehajtásának eredménye:

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

Példa

Alkalmazzunk két metódust a tömbre: a flatMap-et és a map-et, ahol mindkét metódus paraméterében egy függvény lesz megadva, amely kétdimenzióssá teszi a tömböt:

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

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

A kód végrehajtásának eredménye:

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

Lásd még

a flat metódus,
amely tömböt ad vissza az al-tömbökből