Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje