Несколько месяцев назад в ECMAScript появились два новых метода для работы с массивами: Array.prototype.flat() и Array.prototype.flatMap(). В справочнике MDN на русском языке они отмечены как экспериментальные, а в англоязычной версии справочника предупреждения об особом статусе нет. Давайте посмотрим на .flat() и .flatMap() поближе.
Метод Array.prototype.flat() позволяет работать с вложенными массивами. Обратите внимание на код.
const array = [1, [2, [3]]];
Здесь есть массив array, в который вложен ещё один массив, в котором в свою очередь находится ещё один массив.
Метод Array.prototype.flat() достаёт вложенные массивы и переносит их на уровень, который определяет разработчик. Дефолтный уровень — 1.
array.flat();
// [1, 2, [3]]
// равнозначно:
array.flat(1);
// [1, 2, [3]]
Если глубина вложенности неизвестна, достать вложенные массивы можно с помощью аргумента Infinity. В этом случае метод рекурсивно обходит массив и достает все вложенные элементы независимо от глубины.
// Достаём все вложенные массивы:
array.flat(Infinity);
// [1, 2, 3]
В качестве примера рассмотрим функцию duplicate, которая принимает значение и возвращает массив из двух элементов, каждый из которых повторяет значение. Если применить функцию duplicate к массиву, получим вложенный массив.
const duplicate = x => [x, x];
[2, 3, 4].map(duplicate);
// [[2, 2], [3, 3], [4, 4]]
Извлечь вложенные массивы можно с помощью flat.
[2, 3, 4].map(duplicate).flat();
// [2, 2, 3, 3, 4, 4]
В функциональном программировании подобные операции с массивами встречаются часто. Поэтому в ECMAScript появился метод .flatMap(), который упрощает код.
[2, 3, 4].flatMap(duplicate);
// [2, 2, 3, 3, 4, 4]
Использовать .flatMap() для преобразования массива эффективнее, чем последовательно использовать .flat() и .map(). Поддержку методов Array.prototype.flat() и Array.prototype.flatMap() в браузерах можно проверить по ссылке.
Это перевод заметки Mathias Bynens.