.flat() и .flatMap(): новые методы для работы с массивами в ECMAScript

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

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

Метод 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]

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

В качестве примера рассмотрим функцию 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.