Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes