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

CKTIS / JavaScript

requestIdleCallback — trabalho durante períodos de inatividade

requestIdleCallback agenda trabalho não urgente durante os períodos de inatividade do navegador. O callback recebe um orçamento de tempo estimado, mas tem de dividir o trabalho e ceder o controlo por si próprio.

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

const handle = window.requestIdleCallback(callback, { timeout: 1000 });
// callback receives an IdleDeadline: deadline.timeRemaining(), deadline.didTimeout
window.cancelIdleCallback(handle);

window.requestIdleCallback(callback, options) agenda uma única vez trabalho não urgente no ciclo de eventos da página, e não num thread separado. O identificador devolvido permite cancelar uma chamada pendente através de window.cancelIdleCallback(handle).

O callback recebe um IdleDeadline: timeRemaining() indica os milissegundos restantes estimados, nunca abaixo de zero. Divide o trabalho em unidades pequenas e volta a agendar o que faltar; o navegador não interrompe automaticamente uma operação demorada.

Sem timeout, a espera pode ser ilimitada. Um timeout positivo, em milissegundos, coloca uma tarefa na fila após esse intervalo, mas não garante uma hora exata de execução. didTimeout indica uma execução por esta via; nesse caso, timeRemaining() é zero. Nessa situação, o exemplo processa apenas um elemento por chamada.

Esta é uma Web API de Window, não uma funcionalidade de ECMAScript; ter Node 24 não comprova que exista suporte. Verifica a disponibilidade no navegador de destino. A fonte é um rascunho do W3C, não uma tabela de compatibilidade dos navegadores.

Exemplos

(() => {
  if (typeof window.requestIdleCallback !== "function") {
    console.log("requestIdleCallback unavailable");
    return;
  }

  const items = [1, 2, 3, 4];
  let index = 0;
  let sum = 0;

  function work(deadline) {
    let processed = 0;
    while (index < items.length &&
           (deadline.timeRemaining() > 0 ||
            (deadline.didTimeout && processed === 0))) {
      sum += items[index++];
      processed++;
    }
    if (index < items.length) {
      window.requestIdleCallback(work, { timeout: 1000 });
    } else {
      console.log(sum);
    }
  }

  window.requestIdleCallback(work, { timeout: 1000 });
})();

Resultado

10

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