JavaScript Array.flat: развернуть вложенные массивы
Array.prototype.flat создаёт новый массив, разворачивая вложенные массивы на заданную глубину. По умолчанию глубина равна 1; flat(Infinity) разворачивает все уровни. Метод появился в ES2019 и не мутирует исходный массив.
Развернуть на разную глубину
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"] останется строкой, а не массивом символов. Исходный массив не меняется.
Преобразовать и развернуть за один проход
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.