Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

IdleDeadline — budget di tempo di una callback idle

IdleDeadline è l’oggetto passato a una callback di requestIdleCallback(). Espone il tempo residuo stimato e indica se la callback è stata eseguita perché è scaduto il timeout.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

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

IdleDeadline è un’interfaccia della Web API esposta su Window, non fa parte di ECMAScript. Il browser la fornisce a una callback di requestIdleCallback(); non crearla con new IdleDeadline(). Verifica la disponibilità dell’API; Node 24 non dimostra il supporto nei browser.

IdleDeadline.timeRemaining() restituisce il tempo residuo stimato in millisecondi come DOMHighResTimeStamp non negativo, eventualmente frazionario. Una volta raggiunta la scadenza, restituisce 0. Controllalo tra piccole unità di lavoro: la scadenza non interrompe il codice in esecuzione.

IdleDeadline.didTimeout è una proprietà booleana di sola lettura. true significa che la chiamata è avvenuta perché è scaduta l’opzione timeout; in tal caso, timeRemaining() restituisce 0. Il semplice esaurimento del budget non imposta didTimeout su true. timeout non garantisce un momento preciso di esecuzione.

L’esempio somma i numeri in blocchi e riprogramma il lavoro non completato. Il percorso didTimeout consente una piccola operazione, non un ciclo senza limiti. Il lavoro condivide in modo cooperativo il thread principale; non viene eseguito in un thread separato.

Esempi

(() => {
  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 });
})();

Risultato

10

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti