Как сделать массив плоским — и почему flat() не справляется с первого раза

Знакомая сцена. Ты попросил ИИ загрузить товары со всех пяти страниц каталога. Он написал код, ты выводишь количество — и видишь 5. Не 500 товаров, а пять.
Товары никуда не пропали. Они просто лежат в коробках внутри коробки: массив из пяти массивов по сто товаров. Тебе нужен один плоский список. Это называется «сделать массив плоским» — по-английски flatten. Разберём по шагам, с ловушкой, на которой спотыкаются почти все.
Шаг за шагом: от коробок к ровному ряду
-
Посмотри, что у тебя на самом деле. Не гадай — выведи первый элемент:
console.log(pages.length); // 5 console.log(Array.isArray(pages[0])); // true — внутри массивыЕсли первый элемент — массив, значит, у тебя вложенность. Если объект — шаг 4.
-
Убери один уровень вложенности —
flat().const products = pages.flat(); console.log(products.length); // 500Вот и всё для самого частого случая.
flat()берёт содержимое каждой внутренней коробки и выкладывает в один ряд. -
Если внутри ещё коробки — укажи глубину. И вот тут ловушка:
flat()без аргумента снимает ровно один уровень.const nested = [1, [2, [3, [4]]]]; nested.flat(); // [1, 2, [3, [4]]] — внутри ещё массивы! nested.flat(Infinity); // [1, 2, 3, 4]Число в скобках — сколько уровней снять.
Infinity— «до самого дна». Используй его, когда не знаешь глубину заранее. -
Если массивы лежат внутри объектов —
flatMap(). Типичный случай: у тебя список заказов, а в каждом заказе список позиций. Нужны все позиции разом:const items = orders.flatMap((order) => order.items);flatMap— этоmapиflat()в одном шаге. Для каждого заказа достаётitems, а потом раскладывает всё в один ряд. -
Не потеряй, откуда что пришло. После раскладки позиция не знает, из какого она заказа. Если это важно — прихвати нужное поле с собой:
const items = orders.flatMap((order) => order.items.map((item) => ({ ...item, orderId: order.id })) );Теперь у каждой позиции есть
orderId. Без этого шага потом не получится показать «товар из заказа №42».
Что получится
Было: массив из пяти массивов, length равен 5, вывести товары в списке не выходит.
Стало: один ровный массив из 500 товаров. Его можно фильтровать, сортировать, рисовать карточками. А если делал шаг 5 — у каждого элемента есть ссылка на «родителя».
Как проверить, что всё разложилось
Не верь на глаз — один вложенный массив в середине списка легко пропустить. Проверь одной строкой:
console.log(products.some(Array.isArray)); // false — внутри нет массивов
some пробегает по списку и отвечает true, если хоть один элемент — массив. Получил false — данные плоские, можно рисовать карточки. Получил true — вернись к шагу 3 и увеличь глубину.
Вторая проверка — сумма. Если на каждой странице сто товаров, а страниц пять, в итоге должно быть 500. Меньше — какая-то страница пришла пустой или с ошибкой. Больше — ты, скорее всего, загрузил одну страницу дважды.
Три подвоха, о которых молчат
flat()выкидывает дырки.[1, , 3].flat()даёт[1, 3]. Если ты считал позиции по номерам — номера сдвинутся.- Строки не разбиваются.
["a b", "c"].flat()останется как есть. Чтобы разбить строки на слова, нуженflatMap((s) => s.split(" ")). - Старый трюк с
concatснимает только один уровень. ИИ иногда пишет[].concat(...arr). Это то же самое, чтоflat()без аргумента, только менее понятно. Глубокие массивы так не раскрыть.
Как попросить ИИ
Чтобы не ловить «5 вместо 500», опиши форму данных прямо в задаче:
Загрузи товары со всех страниц.Загрузи товары со всех 5 страниц API параллельно. Каждая страница возвращает массив товаров. В итоге мне нужен ОДИН плоский массив всех товаров, а не массив массивов. Добавь console.log с итоговым количеством.Когда ты называешь форму результата — «один плоский массив» — ИИ сам допишет .flat(). Если хочешь понять, когда вместо цепочки методов лучше обычный цикл, загляни в разбор цикл или map.
Чем flat отличается от flatMap?
flat() только раскладывает готовый вложенный массив. flatMap() сначала превращает каждый элемент функцией, а потом раскладывает результат на один уровень.
flat(Infinity) не опасен?
Для обычных данных — нет. Опасен только массив, который содержит сам себя: такой код упадёт с ошибкой «Maximum call stack size exceeded». В данных из API так не бывает.
Работает ли flat во всех браузерах?
Да. flat и flatMap поддерживают все современные браузеры и Node.js уже несколько лет. Полифилы не нужны.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





