CKTIS / JavaScript
queueMicrotask — naplánování mikrotasku
queueMicrotask(callback) zařadí krátkou funkci do fronty mikrotasků. Spustí se po dokončení aktuálního synchronního kódu, aniž by naplánovala samostatný úkol časovače nebo poskytla prohlížeči čas na vykreslování.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
queueMicrotask(callback)queueMicrotask(callback) je webové API definované standardem HTML Living Standard, nikoli funkce přiřazená ke konkrétní edici ECMAScriptu. Je dostupné v kontextech okna a workeru. Přijímá funkci, která se volá bez argumentů, a vrací undefined, nikoli Promise. V cílovém prostředí ověřte typeof queueMicrotask === 'function'; verze Node používaná v repozitáři nedokazuje podporu v prohlížeči.
Callback nepřeruší právě probíhající synchronní kód. Spustí se při kontrolním bodu mikrotasků, když je zásobník vykonávání prázdný. Fronta se vyprazdňuje v pořadí přidávání, včetně mikrotasků přidaných během jejího zpracování. V příkladu se microtask:3 zařadí za již čekající microtask:2.
Na rozdíl od setTimeout(callback, 0) se tím neplánuje samostatný úkol časovače. Hodí se k uspořádání krátkých aktualizací po synchronním kódu. Nepřesouvá práci do jiného vlákna: dlouhé callbacky nebo průběžné přidávání mikrotasků mohou blokovat vykreslování i zpracování dalších úkolů.
Výjimka vyvolaná callbackem se ohlásí jako chyba, místo aby se změnila na odmítnutí promise jako u callbacku Promise.then. Vnější try...catch kolem samotného volání queueMicrotask tuto pozdější výjimku nezachytí; v případě potřeby ji ošetřete uvnitř callbacku.
Příklady
(() => {
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');
})();Výsledek
sync:start -> sync:end -> microtask:1 -> microtask:2 -> microtask:3
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.