.flat() и .flatMap(): новые методы для работы с массивами в ECMAScript
2026-02-26 14:59 Diff
https://ru.hexlet.io/blog/posts/flat-i-flatmap-novye-metody-dlya-raboty-s-massivami-v-ecmascript

Несколько месяцев назад в ECMAScript появились два новых метода для работы с массивами: Array.prototype.flat() и Array.prototype.flatMap(). В справочнике MDN на русском языке они отмечены как экспериментальные, а в англоязычной версии справочника предупреждения об особом статусе нет. Давайте посмотрим на .flat() и .flatMap() поближе.

Содержание

Метод Array.prototype.flat()

Метод Array.prototype.flat() позволяет работать с вложенными массивами. Обратите внимание на код.

Здесь есть массив array, в который вложен ещё один массив, в котором в свою очередь находится ещё один массив.

Метод Array.prototype.flat() достаёт вложенные массивы и переносит их на уровень, который определяет разработчик. Дефолтный уровень — 1.

Если глубина вложенности неизвестна, достать вложенные массивы можно с помощью аргумента Infinity. В этом случае метод рекурсивно обходит массив и достает все вложенные элементы независимо от глубины.

Метод Array.prototype.flatMap()

В качестве примера рассмотрим функцию duplicate, которая принимает значение и возвращает массив из двух элементов, каждый из которых повторяет значение. Если применить функцию duplicate к массиву, получим вложенный массив.

Извлечь вложенные массивы можно с помощью flat.

В функциональном программировании подобные операции с массивами встречаются часто. Поэтому в ECMAScript появился метод .flatMap(), который упрощает код.

Использовать .flatMap() для преобразования массива эффективнее, чем последовательно использовать .flat() и .map(). Поддержку методов Array.prototype.flat() и Array.prototype.flatMap() в браузерах можно проверить по ссылке.

Это перевод заметки Mathias Bynens.