CKTIS / JavaScript
queueMicrotask — pianificare una microtask
queueMicrotask(callback) inserisce una funzione breve nella coda delle microtask. La funzione viene eseguita al termine del codice sincrono corrente, senza pianificare un’attività separata del timer né concedere al browser tempo per il rendering.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
queueMicrotask(callback)queueMicrotask(callback) è una Web API definita dall’HTML Living Standard, non una funzione associata a una specifica edizione di ECMAScript. È disponibile nei contesti window e worker. Accetta una funzione chiamata senza argomenti e restituisce undefined, non una Promise. Nell’ambiente di destinazione, verifica typeof queueMicrotask === 'function'; la versione di Node usata in un repository non dimostra il supporto nei browser.
Il callback non interrompe il codice sincrono corrente. Viene eseguito a un checkpoint delle microtask, quando lo stack di esecuzione è vuoto. La coda viene svuotata nell’ordine di inserimento, comprese le microtask aggiunte durante l’elaborazione. Nell’esempio, microtask:3 viene aggiunta dopo microtask:2, già in attesa.
A differenza di setTimeout(callback, 0), non pianifica un’attività separata del timer. È utile per ordinare brevi aggiornamenti dopo il codice sincrono. Non sposta il lavoro su un altro thread: callback lunghi o l’aggiunta continua di microtask possono bloccare il rendering e l’elaborazione delle attività successive.
Un’eccezione generata dal callback viene segnalata come errore, anziché trasformata in un rifiuto della promise come accade con un callback Promise.then. Un try...catch esterno attorno alla chiamata stessa a queueMicrotask non può intercettare quell’eccezione successiva; se necessario, gestiscila all’interno del callback.
Esempi
(() => {
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');
})();Risultato
sync:start -> sync:end -> microtask:1 -> microtask:2 -> microtask:3
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.