CKTIS / JavaScript
queueMicrotask — agendar uma microtarefa
queueMicrotask(callback) coloca uma função curta na fila de microtarefas. Esta é executada quando termina o código síncrono atual, sem agendar uma tarefa de temporizador separada nem dar tempo ao navegador para efetuar a renderização.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
queueMicrotask(callback)queueMicrotask(callback) é uma API Web definida pelo HTML Living Standard, não uma função associada a uma edição específica do ECMAScript. Está disponível em contextos de janela e de worker. Recebe uma função chamada sem argumentos e devolve undefined, não uma Promise. Verifique typeof queueMicrotask === 'function' no ambiente de destino; a versão do Node usada num repositório não comprova o suporte nos navegadores.
O callback não interrompe o código síncrono atual. É executado num ponto de controlo das microtarefas, quando a pilha de execução está vazia. A fila é esvaziada pela ordem de inserção, incluindo as microtarefas adicionadas durante o processamento. No exemplo, microtask:3 é adicionada depois de microtask:2, que já estava à espera.
Ao contrário de setTimeout(callback, 0), isto não agenda uma tarefa de temporizador separada. É adequado para ordenar atualizações curtas após código síncrono. Não transfere o trabalho para outra thread: callbacks longos ou a adição contínua de microtarefas podem bloquear a renderização e o processamento de tarefas seguintes.
Uma exceção lançada pelo callback é comunicada como erro, em vez de ser transformada numa rejeição de promise, como acontece num callback Promise.then. Um try...catch externo em torno da própria chamada a queueMicrotask não consegue capturar essa exceção posterior; se necessário, trate-a dentro do callback.
Exemplos
(() => {
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');
})();Resultado
sync:start -> sync:end -> microtask:1 -> microtask:2 -> microtask:3
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.