CKTIS / JavaScript
queueMicrotask — načrtovanje mikronaloge
queueMicrotask(callback) doda kratko funkcijo v čakalno vrsto mikronalog. Izvede se, ko se trenutna sinhrona koda konča, ne da bi načrtovala ločeno nalogo časovnika ali brskalniku prepustila čas za izris.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
queueMicrotask(callback)queueMicrotask(callback) je spletni API, določen v HTML Living Standard, in ne funkcija, vezana na določeno izdajo ECMAScript. Na voljo je v kontekstih okna in workerja. Sprejme funkcijo, ki se pokliče brez argumentov, in vrne undefined, ne Promise. V ciljnem okolju preverite typeof queueMicrotask === 'function'; različica Node, uporabljena v repozitoriju, ne dokazuje podpore v brskalniku.
Callback ne prekine trenutne sinhrone kode. Izvede se na kontrolni točki mikronalog, ko je izvajalni sklad prazen. Čakalna vrsta se izprazni v vrstnem redu dodajanja, vključno z mikronalogami, dodanimi med obdelavo. V primeru se microtask:3 doda za že čakajočo microtask:2.
Za razliko od setTimeout(callback, 0) to ne načrtuje ločene naloge časovnika. Primerno je za razvrščanje kratkih posodobitev po sinhroni kodi. Dela ne premakne v drugo nit: dolgi callbacki ali stalno dodajanje mikronalog lahko blokirajo izris in obdelavo naslednjih nalog.
Izjema, ki jo sproži callback, se sporoči kot napaka, namesto da bi se spremenila v zavrnitev obljube, kot pri callbacku Promise.then. Zunanji try...catch okoli samega klica queueMicrotask te poznejše izjeme ne more prestreči; po potrebi jo obravnavajte znotraj callbacka.
Primeri
(() => {
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');
})();Rezultat
sync:start -> sync:end -> microtask:1 -> microtask:2 -> microtask:3
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.