Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

queueMicrotask — naplánovanie mikrotasku

queueMicrotask(callback) zaradí krátku funkciu do frontu mikrotaskov. Spustí sa po dokončení aktuálneho synchrónneho kódu, bez naplánovania samostatnej úlohy časovača alebo poskytnutia času prehliadaču na vykresľovanie.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

queueMicrotask(callback)

queueMicrotask(callback) je webové API definované štandardom HTML Living Standard, nie funkcia priradená ku konkrétnej edícii ECMAScriptu. Je dostupné v kontextoch okna a workera. Prijíma funkciu volanú bez argumentov a vracia undefined, nie Promise. V cieľovom prostredí skontrolujte typeof queueMicrotask === 'function'; verzia Node použitá v repozitári nedokazuje podporu v prehliadači.

Callback nepreruší aktuálny synchrónny kód. Spustí sa pri kontrolnom bode mikrotaskov, keď je zásobník vykonávania prázdny. Front sa vyprázdňuje v poradí pridania vrátane mikrotaskov pridaných počas jeho spracovania. V príklade sa microtask:3 zaradí za už čakajúci microtask:2.

Na rozdiel od setTimeout(callback, 0) sa tým neplánuje samostatná úloha časovača. Hodí sa na usporiadanie krátkych aktualizácií po synchrónnom kóde. Nepresúva prácu do iného vlákna: dlhé callbacky alebo neustále pridávanie mikrotaskov môžu blokovať vykresľovanie a spracovanie nasledujúcich úloh.

Výnimka vyvolaná callbackom sa oznámi ako chyba, namiesto toho, aby sa zmenila na odmietnutie promise ako pri callbacku Promise.then. Vonkajší try...catch okolo samotného volania queueMicrotask túto neskoršiu výnimku nezachytí; v prípade potreby ju ošetrite vnútri callbacku.

Prí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ýsledok

sync:start -> sync:end -> microtask:1 -> microtask:2 -> microtask:3

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje