Метод 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,
който връща масив от подмасиви