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

← →
↑
en ru