Метад flatMap

Метад flatMap вяртае новы масіў, створаны пасля таго як да кожнага элемента зыходнага масіва прымяніўся колбэк, паказаны ў параметры метаду. На першы погляд метад flatMap падобны на метад map, але яго галоўная адрозненне ў тым, што ён заўсёды вяртае аднамерны масіў.

Сінтаксіс

let newArray = масіў.flatMap(функцыя);

Прыклад

Давайце зробім новы масіў, выкарыстоўваючы метад flatMap:

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

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

console.log(res);

Вынік выканання кода:

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

Прыклад

Давайце зробім новы масіў з зыходнага, які складаецца з лікаў:

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

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

console.log(res);

Вынік выканання кода:

[3, 4, 5, 6, 7]

Прыклад

Давайце паспрабуем прымяніць метад flatMap да масіву з першым узроўнем укладзенасці:

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

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

console.log(res);

Пасля выканання кода мы ўбачым, што ўмовы функцыі прымяніліся да падмасіву, палічыўшы яго за адзін элемент. Таму выклік дадзенага метаду ва ўкладзеных масівах не мае сэнсу:

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

Прыклад

Калі мы хочам не замарачвацца з узроўнем укладзенасці, а аб'яднаць ўвесь масіў, то выкарыстоўваем параметр Infinity:

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

let res = arr.flatMap(Infinity);

console.log(res);

Вынік выканання кода:

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

Прыклад

Давайце прымянім да масіву два метады: flatMap і map, прычым у параметры абодвух метадаў будзе паказана функцыя, якая робіць масіў двухмерным:

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', res1);
console.log('метад flatMap', res2);

Вынік выканання кода:

'метад map' [[3], [6], [9], [12], [15], [18]]
'метад flatMap' [3, 6, 9, 12, 15, 18]

Глядзіце таксама

метад flat,
які вяртае масіў з падмасіваў