Справочник JavaScript

Array.prototype.flat

Раскрывает вложенные массивы в один.

Доступно с: ES2019

Синтаксис

array.flat(depth)

Параметр	Тип	Описание
depth	number	Необязательный. На сколько уровней раскрывать вложенность. По умолчанию 1.

ArrayНовый «плоский» массив.

Один уровень вложенности:

console.log([[1, 2], [3, 4]].flat().join(', '));

Результат:

1, 2, 3, 4

Глубокая вложенность — depth или Infinity:

const nested = [1, [2, [3, [4]]]];
 
console.log(nested.flat().length);
console.log(nested.flat(Infinity).join(', '));

Результат:

3
1, 2, 3, 4

Пустые места в массиве (например [1, , 3]) при этом удаляются. Исходный массив не меняется.

Array.prototype.flatMap — Применяет функцию к каждому элементу и раскрывает результат на один уровень.
Array.prototype.concat — Объединяет массивы в новый массив.

Методы массивов — Как добавлять и удалять элементы массива в JavaScript: push, pop, shift, unshift, slice, splice, concat и join.