Как разбить массив на части в 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
}
Как это работает:
- Счётчик
iпрыгает не на 1, а сразу наsize: 0, 3, 6, 9… slice(i, i + size)вырезает кусок отiдо следующего прыжка.- Если в конце элементов меньше,
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 коротких урока на телефоне.





