Гайды

Как разбить массив на части в JavaScript — и не словить 429 от API

Иллюстрация: длинный конвейер коробок раскладывают по ящикам по три и отправляют тележками по очереди

У тебя 500 товаров. Нужно, чтобы ИИ написал к каждому описание. ИИ-помощник предлагает код в одну строку:

const results = await Promise.all(products.map(p => generateDescription(p)))

Ты запускаешь. Первые десятки описаний приходят. А потом — стена ошибок 429 Too Many Requests. Ты отправил 500 запросов за одну секунду, и API тебя притормозил. Это называется лимит запросов, и он есть почти у любого сервиса.

Лечится это одним приёмом: разбить массив на пачки и отправлять их по очереди. Давай соберём это по шагам.

Шаг 1. Напиши функцию chunk

В JavaScript нет встроенного метода, который режет массив на куски. Но пишется он в три строки:

function chunk(items, size) {
  const parts = []
  for (let i = 0; i < items.length; i += size) {
    parts.push(items.slice(i, i + size))
  }
  return parts
}

Как это работает:

  1. Счётчик i прыгает не на 1, а сразу на size: 0, 3, 6, 9…
  2. slice(i, i + size) вырезает кусок от i до следующего прыжка.
  3. Если в конце элементов меньше, slice просто отдаёт сколько есть — ошибки не будет.

Проверь:

chunk([1, 2, 3, 4, 5, 6, 7], 3)
// [[1, 2, 3], [4, 5, 6], [7]]

chunk([], 3)
// []

Мы прогнали это в Node 22 — результат именно такой. Последняя пачка короче, пустой массив даёт пустой список пачек.

Шаг 2. Отправляй пачки по очереди

Теперь главное. Внутри пачки запросы идут параллельно, а сами пачки — строго одна за другой:

const results = []

for (const part of chunk(products, 10)) {
  const done = await Promise.all(part.map(p => generateDescription(p)))
  results.push(...done)
}

Тут работает пара for...of + await. Цикл не переходит к следующей пачке, пока не закончилась текущая. В каждый момент в полёте не больше 10 запросов.

⚠ Не заменяй for...of на forEach. forEach не ждёт await внутри — и все пачки снова улетят разом.

Шаг 3. Добавь паузу между пачками

Многие API считают лимит «в минуту». Тогда мало ограничить одновременные запросы — нужно ещё дать серверу выдохнуть:

const sleep = ms => new Promise(resolve => setTimeout(resolve, ms))

for (const part of chunk(products, 10)) {
  const done = await Promise.all(part.map(p => generateDescription(p)))
  results.push(...done)
  await sleep(1000)
}

Как выбрать числа: открой документацию API и найди лимит. Например, 60 запросов в минуту — это пачки по 10 и пауза около 10 секунд. Лучше начать осторожно и ускорять, чем упираться в 429.

Шаг 4. Не теряй всю пачку из-за одной ошибки

Promise.all падает целиком, если упал хотя бы один запрос. Девять готовых описаний пропадут из-за десятого. Возьми Promise.allSettled — он дождётся всех и скажет, кто как закончил:

for (const part of chunk(products, 10)) {
  const settled = await Promise.allSettled(part.map(p => generateDescription(p)))
  settled.forEach((r, i) => {
    if (r.status === 'fulfilled') results.push(r.value)
    else failed.push(part[i])
  })
  await sleep(1000)
}

Мы проверили: в пачке из трёх, где второй запрос бросил ошибку, allSettled вернул fulfilled, rejected, fulfilled. Остальные результаты целы. Упавшие товары лежат в failed — их можно прогнать ещё раз.

Что получится

  • 500 товаров уходят пачками по 10.
  • Ни одной ошибки 429, потому что ты укладываешься в лимит.
  • Одна неудача не ломает остальное — у тебя есть список, что перезапустить.
  • Скорость предсказуема: 50 пачек по секунде паузы — около минуты плюс время ответов.

Тот же chunk пригодится и без API: разложить карточки по рядам из трёх, показать список страницами, записать в базу порциями по 100 строк.

Две ловушки в коде от ИИ

Размер 0 вешает вкладку. chunk(items, 0): счётчик прибавляет ноль и никогда не дорастает до конца. Это бесконечный цикл. Добавь в начало функции защиту: if (size < 1) throw new Error('size должен быть больше 0').

splice опустошает исходный массив. Иногда ИИ режет так:

while (items.length) parts.push(items.splice(0, 10))

Пачки получатся правильные. Но splice вырезает элементы из items — и после цикла исходный список пуст. Мы проверили: массив из пяти элементов после такого цикла стал []. Если дальше в коде ты снова обращаешься к items — вот откуда пустой массив. Используй slice, он ничего не трогает.

Есть ли готовый chunk в JavaScript?

Встроенного нет. Есть _.chunk в библиотеке lodash — он делает то же самое. Но ради одной функции из трёх строк тянуть зависимость не обязательно.

Какой размер пачки выбрать?

Смотри на лимит API. Нет лимита — начни с 5–10 одновременных запросов. Больше редко ускоряет: сервер всё равно обрабатывает их с ограниченной скоростью.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

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

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

Все статьи →