CKTIS / JavaScript
queueMicrotask — планиране на микрозадача
queueMicrotask(callback) поставя кратка функция в опашката за микрозадачи. Тя се изпълнява след приключване на текущия синхронен код, без да планира отделна задача на таймер и без да предоставя време на браузъра за визуализация.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
queueMicrotask(callback)queueMicrotask(callback) е уеб API, дефиниран в HTML Living Standard, а не функция, обвързана с конкретно издание на ECMAScript. Достъпно е в контексти на прозорци и worker-и. Приема функция, която се извиква без аргументи, и връща undefined, а не Promise. Проверете typeof queueMicrotask === 'function' в целевата среда; версията на Node, използвана в дадено хранилище, не доказва поддръжка в браузъра.
Callback-ът не прекъсва текущия синхронен код. Изпълнява се в контролна точка за микрозадачи, когато стекът на изпълнение е празен. Опашката се изпразва по реда на добавяне, включително микрозадачите, добавени по време на обработката ѝ. В примера microtask:3 се добавя след вече чакащата microtask:2.
За разлика от setTimeout(callback, 0), това не планира отделна задача на таймер. Подходящо е за подреждане на кратки актуализации след синхронен код. Не премества работата в друга нишка: дългите callback-и или непрекъснатото добавяне на микрозадачи могат да блокират визуализацията и обработката на следващите задачи.
Изключение, хвърлено от callback-а, се съобщава като грешка, вместо да се превърне в отхвърляне на promise, както при callback на Promise.then. Външен try...catch около самото извикване на queueMicrotask не може да улови това по-късно изключение; при нужда го обработете вътре в callback-а.
Примери
(() => {
const order = [];
order.push('sync:start');
queueMicrotask(() => {
order.push('microtask:1');
queueMicrotask(() => {
order.push('microtask:3');
console.log(order.join(' -> '));
});
});
queueMicrotask(() => order.push('microtask:2'));
order.push('sync:end');
})();Резултат
sync:start -> sync:end -> microtask:1 -> microtask:2 -> microtask:3
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.