Metoda flatMap

Metoda flatMap vrne novo polje, ustvarjeno po tem, ko je bil za vsak element izvornega polja uporabljen povratni klic, določen v parametru metode. Na prvi pogled je metoda flatMap podobna metodi map, vendar je njena glavna razlika v tem, da vedno vrne enodimenzionalno polje.

Sintaksa

let newArray = polje.flatMap(funkcija);

Primer

Pridobimo novo polje, z uporabo metode flatMap:

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

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

console.log(res);

Rezultat izvajanja kode:

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

Primer

Pridobimo novo polje iz izvornega, sestavljenega iz števil:

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

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

console.log(res);

Rezultat izvajanja kode:

[3, 4, 5, 6, 7]

Primer

Poskusimo uporabiti metodo flatMap na polju s prvo stopnjo gnezditve:

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

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

console.log(res);

Po izvajanju kode vidimo, da so se pogoji funkcije uporabili za podpolje, ga obravnavali kot en element. Zato uporaba te metode pri gnezdeneh poljih nima smisla:

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

Primer

Če ne želimo ukvarjati s stopnjo gnezditve, ampak želimo združiti celotno polje, uporabimo parameter Infinity:

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

let res = arr.flatMap(Infinity);

console.log(res);

Rezultat izvajanja kode:

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

Primer

Uporabimo dve metodi na polju: flatMap in map, pri čemer bo v parametru obeh metod določena funkcija, ki naredi polje dvodimenzionalno:

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);

Rezultat izvajanja kode:

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

Glejte tudi

metodo flat,
ki vrne polje iz podpolj