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

CKTIS / JavaScript

IdleDeadline — orçamento de tempo de uma chamada idle

IdleDeadline é o objeto passado a uma função de retorno de chamada de requestIdleCallback(). Expõe o tempo restante estimado e indica se a chamada foi executada devido à expiração do tempo limite.

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

window.requestIdleCallback((deadline) => { deadline.didTimeout; deadline.timeRemaining(); }, { timeout: 1000 });

IdleDeadline é uma interface da Web API exposta em Window, não faz parte de ECMAScript. O navegador fornece-a a uma função de retorno de chamada de requestIdleCallback(); não a cries com new IdleDeadline(). Verifica se a API está disponível; o Node 24 não demonstra suporte nos navegadores.

IdleDeadline.timeRemaining() devolve o tempo restante estimado em milissegundos como um DOMHighResTimeStamp não negativo, possivelmente fracionário. Quando o prazo é atingido, devolve 0. Verifica o valor entre pequenas unidades de trabalho: o prazo não interrompe o código que está a ser executado.

IdleDeadline.didTimeout é uma propriedade booleana só de leitura. true significa que a chamada ocorreu devido à expiração da opção timeout; nesse caso, timeRemaining() devolve 0. O simples esgotamento do orçamento não altera didTimeout para true. timeout não garante um momento exato de execução.

O exemplo soma números em blocos e agenda novamente o trabalho por concluir. O percurso didTimeout permite uma pequena operação, não um ciclo sem limites. O trabalho partilha cooperativamente a thread principal; não é executado numa thread separada.

Exemplos

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

  const values = [1, 2, 3, 4];
  let index = 0;
  let total = 0;

  function work(deadline) {
    let processed = 0;
    while (
      index < values.length &&
      (deadline.timeRemaining() > 1 ||
        (deadline.didTimeout && processed === 0))
    ) {
      total += values[index++];
      processed++;
    }

    if (index < values.length) {
      window.requestIdleCallback(work, { timeout: 1000 });
    } else {
      console.log(total);
    }
  }

  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