JavaScript Array.flat: развернуть вложенные массивы

Категория: JavaScript · Язык: JavaScript · Обновлено:

Array.prototype.flat создаёт новый массив, разворачивая вложенные массивы на заданную глубину. По умолчанию глубина равна 1; flat(Infinity) разворачивает все уровни. Метод появился в ES2019 и не мутирует исходный массив.

Развернуть на разную глубину

JavaScript
const nested = [1, [2, [3, [4]]]];

console.log(JSON.stringify(nested.flat()));         // [1,2,[3,[4]]]
console.log(JSON.stringify(nested.flat(2)));        // [1,2,3,[4]]
console.log(JSON.stringify(nested.flat(Infinity))); // [1,2,3,4]

flat() убирает один уровень вложенности, flat(2) — два, Infinity — все. Пустые ячейки (holes) удаляются. Строки и объекты не разворачиваются: ["ab"] останется строкой, а не массивом символов. Исходный массив не меняется.

Преобразовать и развернуть за один проход

JavaScript
const words = ["hello world", "foo bar"];
console.log(JSON.stringify(words.flatMap((text) => text.split(" ")))); // ["hello","world","foo","bar"]

flatMap сначала применяет callback, затем разворачивает результат на один уровень. Это удобно, когда функция возвращает массив или пустой массив (последний просто исчезает). В отличие от map(...).flat(), flatMap не создаёт промежуточный массив.

Глубина должна быть неотрицательным целым; дробное значение усекается, отрицательное считается нулём. Для очень глубоких структур flat(Infinity) может быть дорогим и привести к переполнению стека на огромных данных. Для объектов с произвольной вложенностью нужна собственная рекурсивная функция.

Метод поддерживается в Chrome 69+, Firefox 62+, Safari 12+ и Node.js 11+. flatMap появился в тех же версиях. Для старых окружений используйте reduce/concat или полифил. Не используйте flat для удаления undefined: он удаляет только пустые ячейки, а явные undefined остаются.

Документация: Array.flat, Array.flatMap.