re:re:actable
Урок 082 минуты чтения

flatMap() vs map()

На этой странице
Кратко

map() преобразует элементы и возвращает массив результатов. flatMap() делает map(), а затем сплющивает результат на один уровень.

Вопрос

Чем отличается arr.flatMap() от arr.map()? Когда использовать flatMap()?

map

const words = ["hello world", "js"];
 
const result = words.map((text) => text.split(" "));
 
console.log(result); // [["hello", "world"], ["js"]]

map возвращает то, что вернул callback. Если callback вернул массивы, получится массив массивов.

flatMap

const result = words.flatMap((text) => text.split(" "));
 
console.log(result); // ["hello", "world", "js"]

Формула:

arr.flatMap(fn);
// примерно то же, что:
arr.map(fn).flat(1);

Сплющивает только на один уровень

const result = [1, 2].flatMap((n) => [[n, n * 2]]);
 
console.log(result); // [[1, 2], [2, 4]]

Один уровень снялся, вложенные массивы остались.

Можно удалять элементы

Если вернуть пустой массив, элемент исчезнет.

const numbers = [1, 2, 3, 4];
 
const evenDoubled = numbers.flatMap((number) => {
  return number % 2 === 0 ? [number * 2] : [];
});
 
console.log(evenDoubled); // [4, 8]

Когда использовать

  • разбить строки на слова;
  • один элемент превратить в 0, 1 или несколько элементов;
  • избежать map(...).flat(1);
  • собрать плоский список из вложенных данных.

Что важно помнить

  • flatMap = map + flat(1): разворачивает только один уровень.
  • flatMap удобен, чтобы одновременно отфильтровать и преобразовать: верните [], чтобы пропустить элемент.
  • Для более глубокой вложенности нужен map + flat(depth).
  • flatMap эффективнее, чем отдельные map и flat: создается один массив.

Мини-шпаргалка

МетодРезультат
map(fn)массив результатов
map(fn).flat(1)преобразование + flatten
flatMap(fn)то же короче
flatMap глубинатолько 1 уровень

Документация

MDN: Array.prototype.flatMap().

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам