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

CKTIS / JavaScript

Ciclo de eventos: pontos de controlo de microtarefas e tarefas de temporizador

No navegador, `queueMicrotask()` e as reações das promessas partilham uma fila de microtarefas. `setTimeout()` agenda uma tarefa separada, mesmo com um atraso de `0`.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

queueMicrotask(callback);
promise.then(onFulfilled, onRejected);
const timerId = setTimeout(callback, delayMs, ...args);
clearTimeout(timerId);

O ciclo de eventos do navegador distingue tarefas de microtarefas. Pode ter várias filas de tarefas, pelo que as tarefas de origens diferentes não formam uma única fila FIFO global. O ciclo executa um ponto de controlo de microtarefas depois de executar uma tarefa. O navegador também o pode fazer ao terminar a execução de um script, quando a pilha de contextos de execução JavaScript estiver vazia. Um retorno normal à função chamadora não desencadeia um ponto de controlo.

Num ponto de controlo, as microtarefas são executadas pela ordem em que entraram na fila, até esta ficar vazia, incluindo as que forem acrescentadas entretanto. queueMicrotask() coloca diretamente uma função de retorno na fila. O ECMAScript 2024 define os trabalhos de reação das promessas (jobs); na Web, o anfitrião coloca-os na mesma fila. Se a promessa já tiver sido cumprida ou rejeitada, .then() coloca logo a reação correspondente na fila, sem a executar de forma síncrona. Se estiver pendente, a reação entra na fila quando a promessa for cumprida ou rejeitada.

Após a espera, setTimeout(callback, delayMs) coloca na fila uma tarefa separada, proveniente da origem de tarefas dos temporizadores. 0 não significa execução imediata nem garante o momento da execução: o trabalho em curso e as microtarefas pendentes podem atrasar a chamada. clearTimeout(timerId) cancela o temporizador se a respetiva função ainda não tiver começado. Os temporizadores e queueMicrotask() são API do anfitrião, não do ECMAScript 2024. Verifica a disponibilidade e as regras de agendamento noutros ambientes de execução.

Usa uma microtarefa para uma operação breve após o código síncrono. Acrescentar continuamente microtarefas pode bloquear outras tarefas e a renderização. Uma exceção lançada pela função passada a queueMicrotask() é comunicada como não capturada; uma exceção lançada por um gestor de .then() rejeita a promessa devolvida por .then().

Exemplos

(() => {
  const order = ["sync:start"];

  setTimeout(() => {
    order.push("timer");
    queueMicrotask(() => {
      order.push("timer:microtask");
      console.log(order.join(" -> "));
    });
  }, 0);

  queueMicrotask(() => {
    order.push("microtask");
    queueMicrotask(() => order.push("nested"));
  });

  Promise.resolve().then(() => order.push("promise"));
  order.push("sync:end");
})();

Resultado

sync:start -> sync:end -> microtask -> promise -> nested -> timer -> timer:microtask

`nested` vai para o fim da fila, atrás de `promise`, que já lá estava, mas é executada antes de `timer`. A tarefa do temporizador acrescenta depois a sua própria microtarefa, `timer:microtask`, que apresenta toda a sequência esperada.

Lições relacionadas

  • JavaScript · Lição 16 · Intermédio · Versão: 3

Fontes