setTimeout, setImmediate и microtasks - порядок выполнения
На этой странице
setTimeout() планирует callback после минимальной задержки в фазе timers, а setImmediate() планирует callback в фазе check текущего или следующего цикла event loop.
Timers, immediates и microtasks - разные очереди асинхронного выполнения. setTimeout планирует timer, setImmediate - callback на фазу check, а Promise microtasks и queueMicrotask выполняются между macrotask-этапами.
Вопрос
Чем отличаются setTimeout, setImmediate и microtasks и в каком порядке они выполняются?
Главное
setTimeout(() => {
console.log("timeout");
}, 0);
setImmediate(() => {
console.log("immediate");
});Порядок между ними не всегда стоит считать надежным, если они запланированы из главного модуля.
setTimeout
setTimeout(callback, delay);delay - минимальная задержка, а не точное время выполнения. Если event loop занят, callback выполнится позже.
setImmediate
setImmediate(callback);setImmediate выполняется в check-фазе, после poll-фазы.
Внутри I/O callback
Внутри I/O callback setImmediate часто выполняется раньше setTimeout(..., 0).
import { readFile } from "node:fs";
readFile("file.txt", () => {
setTimeout(() => console.log("timeout"), 0);
setImmediate(() => console.log("immediate"));
});Что выбрать
- Нужна задержка по времени:
setTimeout. - Нужно выполнить callback после текущего I/O turn:
setImmediate. - Нужна promise-микрозадача:
queueMicrotaskилиPromise.resolve().then(...).
Timers, immediates и microtasks
| API | Что делает |
|---|---|
setTimeout(fn, ms) | выполнить не раньше указанной задержки |
setInterval(fn, ms) | повторять с интервалом |
setImmediate(fn) | выполнить на фазе check event loop |
queueMicrotask(fn) | поставить microtask |
Promise.then(fn) | тоже microtask |
Пример порядка
console.log('sync');
setTimeout(() => console.log('timeout'), 0);
setImmediate(() => console.log('immediate'));
Promise.resolve().then(() => console.log('promise'));
queueMicrotask(() => console.log('microtask'));
console.log('sync end');Синхронный код выполнится первым, microtasks - после него, а порядок setTimeout(0) и setImmediate зависит от контекста запуска.
Не блокировать таймеры
setTimeout(() => {
console.log('timer');
}, 0);
const end = Date.now() + 3000;
while (Date.now() < end) {}Таймер не выполнится, пока синхронный цикл не освободит JS-поток.
Что важно помнить
- Порядок: синхронный код →
process.nextTick→ Promise microtasks → фазы event loop. - Порядок
setTimeout(fn, 0)иsetImmediateв главном модуле не гарантирован; внутри I/O callbacksetImmediateвыполнится первым. - Задержка таймера — минимальная, а не точная; долгий синхронный код задерживает все очереди.
- Для пауз в async-коде удобен
node:timers/promises:await setTimeout(1000).
Мини-шпаргалка
setTimeoutработает через timers.setImmediateработает через check phase.delayу timeout - минимальная задержка.- Порядок может зависеть от контекста.
- В I/O callback
setImmediateобычно предсказуемее для "после I/O". - Таймеры не гарантируют точное время, только минимум задержки.
- Microtasks выполняются раньше следующего macrotask-этапа.
setImmediateсвязан с фазой check.- Долгий синхронный код задерживает все очереди.
- Для пауз в async-коде удобно использовать
node:timers/promises.