Справочник JavaScript

Array.prototype.flatMap

Применяет функцию к каждому элементу и раскрывает результат на один уровень.

Доступно с: ES2019

Синтаксис

array.flatMap(callbackFn)

Параметр	Тип	Описание
callbackFn	Function	Функция, которая возвращает значение или массив значений для каждого элемента.

ArrayНовый массив, раскрытый на один уровень.

Все слова из нескольких фраз:

const phrases = ['hello world', 'good morning'];
 
console.log(phrases.flatMap((phrase) => phrase.split(' ')));

Результат:

[
  "hello",
  "world",
  "good",
  "morning"
]

Пустой массив убирает элемент, два элемента — удваивают его:

const numbers = [1, -2, 3];
 
console.log(numbers.flatMap((n) => (n < 0 ? [] : [n, n])).join(', '));

Результат:

1, 1, 3, 3

Это то же самое, что map() и потом flat(), но за один проход.

map, filter и reduce — Три главных метода обработки массивов в JavaScript: преобразование, отбор и сведение к одному значению.