flatMap-metodi

flatMap-metodi palauttaa uuden taulukon, joka on luotu sen jälkeen kun jokaista lähdetaulukon elementtiä on sovellettu takaisinkutsufunktioon, joka on määritelty metodin parametrissa. Ensiluonteisesti flatMap-metodi muistuttaa map-metodia, mutta sen pääero on siinä, että se palauttaa aina yksiulotteisen taulukon.

Syntaksi

let newArray = taulukko.flatMap(funktio);

Esimerkki

Saadaanpa uusi taulukko, käyttämällä flatMap-metodia:

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

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

console.log(res);

Koodin suorituksen tulos:

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

Esimerkki

Saadaanpa uusi taulukko lähdetaulukosta, joka koostuu luvuista:

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

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

console.log(res);

Koodin suorituksen tulos:

[3, 4, 5, 6, 7]

Esimerkki

Kokeillaan soveltaa flatMap-metodia taulukkoon, jossa on ensimmäinen sisäkkäisyystaso:

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

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

console.log(res);

Koodin suorituksen jälkeen näemme, että funktion ehdot sovellettiin alitaulukkoon, laskien sen yhdeksi elementiksi. Siksi tämän metodin kutsumisella sisäkkäisissä taulukoissa ei ole järkeä:

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

Esimerkki

Jos emme halua vaivautua sisäkkäisyystason kanssa, vaan yhdistää koko taulukon, käytämme parametria Infinity:

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

let res = arr.flatMap(Infinity);

console.log(res);

Koodin suorituksen tulos:

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

Esimerkki

Käytetään taulukkoon kahta metodia: flatMap ja map, ja molempien metodien parametrissa on määritelty funktio, joka tekee taulukosta kaksiulotteisen:

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

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

Koodin suorituksen tulos:

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

Katso myös

flat-metodi,
joka palauttaa taulukon alitaulukoista