Гайды

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

Иллюстрация: коробки в коробках раскладывают в один ровный ряд

Знакомая сцена. Ты попросил ИИ загрузить товары со всех пяти страниц каталога. Он написал код, ты выводишь количество — и видишь 5. Не 500 товаров, а пять.

Товары никуда не пропали. Они просто лежат в коробках внутри коробки: массив из пяти массивов по сто товаров. Тебе нужен один плоский список. Это называется «сделать массив плоским» — по-английски flatten. Разберём по шагам, с ловушкой, на которой спотыкаются почти все.

Шаг за шагом: от коробок к ровному ряду

  1. Посмотри, что у тебя на самом деле. Не гадай — выведи первый элемент:

    console.log(pages.length);        // 5
    console.log(Array.isArray(pages[0])); // true — внутри массивы
    

    Если первый элемент — массив, значит, у тебя вложенность. Если объект — шаг 4.

  2. Убери один уровень вложенности — flat().

    const products = pages.flat();
    console.log(products.length); // 500
    

    Вот и всё для самого частого случая. flat() берёт содержимое каждой внутренней коробки и выкладывает в один ряд.

  3. Если внутри ещё коробки — укажи глубину. И вот тут ловушка: flat() без аргумента снимает ровно один уровень.

    const nested = [1, [2, [3, [4]]]];
    nested.flat();          // [1, 2, [3, [4]]] — внутри ещё массивы!
    nested.flat(Infinity);  // [1, 2, 3, 4]
    

    Число в скобках — сколько уровней снять. Infinity — «до самого дна». Используй его, когда не знаешь глубину заранее.

  4. Если массивы лежат внутри объектов — flatMap(). Типичный случай: у тебя список заказов, а в каждом заказе список позиций. Нужны все позиции разом:

    const items = orders.flatMap((order) => order.items);
    

    flatMap — это map и flat() в одном шаге. Для каждого заказа достаёт items, а потом раскладывает всё в один ряд.

  5. Не потеряй, откуда что пришло. После раскладки позиция не знает, из какого она заказа. Если это важно — прихвати нужное поле с собой:

    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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →