Гайды

Как сделать паузу в JavaScript — и почему await внутри forEach не ждёт

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

В Python пишешь time.sleep(1) — и программа ждёт секунду. В JavaScript такой команды просто нет. Ищешь «sleep», не находишь и пишешь цикл, который крутится секунду вхолостую. Страница замирает целиком: кнопки не жмутся, анимации стоят.

Хорошая новость: настоящая пауза в JS делается одной строкой. Плохая: есть место, где она молча не работает. Разберём оба.

Почему в JavaScript нет sleep

У страницы в браузере один поток. Он и рисует, и обрабатывает клики, и выполняет твой код. Если код «спит», спит всё. Поэтому JS устроен иначе: не «остановись», а «напомни мне через секунду, а пока делай другое».

Этим «напомни» занимается setTimeout. А чтобы код читался как обычная пауза, его заворачивают в промис и используют await. Если слово async пока звучит туманно — загляни в разбор, тут хватит общей идеи.

Пошагово: пауза, которая работает

  1. Заведи функцию задержки. Одна строка, которую можно копировать в любой проект:

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

    Она возвращает промис, который выполнится через ms миллисекунд.

  2. Сделай функцию, где нужна пауза, асинхронной. Поставь async перед ней:

    async function greet() {
      console.log("Привет");
      await sleep(1000);
      console.log("…прошла секунда");
    }
    

    await работает только внутри async-функции (или на верхнем уровне модуля).

  3. Для паузы в цикле используй for...of. Например, отправить три запроса с интервалом в секунду, чтобы не упереться в лимит запросов:

    for (const id of ids) {
      await fetch("/api/items/" + id);
      await sleep(1000);
    }
    

    Каждый шаг цикла честно ждёт предыдущий.

  4. Проверь, что пауза случилась. Замерь время до и после — Date.now(). Три итерации по секунде должны дать около трёх секунд.

Ловушка: forEach не ждёт

Вот та самая неочевидная штука. ИИ часто пишет так:

ids.forEach(async (id) => {
  await sleep(1000);
  await fetch("/api/items/" + id);
});
console.log("всё отправлено");

Выглядит логично. Но «всё отправлено» печатается сразу, а все запросы улетают одновременно через секунду. Пауза не между ними, а одна общая.

Почему? forEach вызывает функцию для каждого элемента и не смотрит, что она вернула. А async-функция возвращает промис — forEach его просто выбрасывает. Мы проверили в Node 22: сразу после такого forEach массив результатов пуст, прошло 0 мс.

Отсюда правило:

  • Нужно по очереди — for...of с await. Три запроса по 100 мс — около 300 мс.
  • Нужно параллельно, но дождаться всех — await Promise.all(ids.map(...)). Те же три запроса — около 100 мс.
  • forEach с async — почти всегда ошибка.
Слабый промптДобавь задержку между запросами
Сильный промптВ функции sendAll я перебираю массив ids и для каждого вызываю fetch. Нужно отправлять запросы строго по очереди с паузой 1 секунда между ними, а после последнего вывести в консоль «готово». Используй функцию sleep на setTimeout и цикл for...of с await, не forEach. Покажи финальный код целиком.

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

Сообщения в консоли появляются с паузами, страница при этом живая: кнопки жмутся, скролл работает. Запросы уходят по одному, и сервер не отвечает ошибкой 429. А «готово» печатается в самом конце, а не в начале.

Как ждать не дольше заданного — таймаут для запроса

Обратная задача: не «подожди секунду», а «не жди больше пяти секунд». Например, сервер завис, а пользователь смотрит на крутилку. Для fetch есть готовое решение:

const res = await fetch("/api/report", {
  signal: AbortSignal.timeout(5000),
});

Через пять секунд запрос отменится, и await выбросит ошибку. Её стоит поймать через try/catch и показать понятное сообщение. А если хочешь повторить запрос — делай паузу между попытками и увеличивай её: 1, 2, 4 секунды. Так сервер успевает прийти в себя.

Почему пауза в фоновой вкладке длиннее?

Браузеры экономят батарею и притормаживают таймеры в неактивных вкладках — обычно не чаще раза в секунду. Твой sleep(100) в фоне может стать секундой. Для точного времени сверяйся с Date.now(), а не считай тики.

setTimeout с нулём — это мгновенно?

Нет. setTimeout(fn, 0) значит «как только освободишься», а не «прямо сейчас». Сначала доработает текущий код, и только потом выполнится fn.

Стоит ли ставить паузы в тестах?

Лучше нет. sleep(2000) «чтобы страница успела загрузиться» делает тесты медленными и капризными: на быстром компьютере пауза лишняя, на медленном её не хватит. Надёжнее ждать конкретного события — появления кнопки или ответа сервера. Инструменты для тестов умеют это из коробки.

Можно ли сделать паузу без async?

Можно передать в setTimeout колбэк — код, который выполнится позже. Но для цепочки пауз это быстро превращается в лесенку вложенных функций. С await читается проще.

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

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

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

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

Все статьи →