Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

requestIdleCallback — lavoro durante i periodi di inattività

requestIdleCallback pianifica il lavoro non urgente durante i periodi di inattività del browser. Il callback riceve un budget di tempo stimato, ma deve suddividere il lavoro e cedere il controllo autonomamente.

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

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

window.requestIdleCallback(callback, options) pianifica una sola volta il lavoro non urgente nel ciclo di eventi della pagina, non in un thread separato. L’handle restituito consente di annullare un’invocazione in attesa con window.cancelIdleCallback(handle).

Il callback riceve un IdleDeadline: timeRemaining() indica i millisecondi rimanenti stimati, mai meno di zero. Suddividi il lavoro in unità piccole e pianifica di nuovo ciò che resta; il browser non interrompe automaticamente un’operazione lunga.

Senza timeout, l’attesa può essere illimitata. Un timeout positivo, espresso in millisecondi, accoda un’attività dopo quell’intervallo, ma non garantisce un momento preciso di esecuzione. didTimeout indica che l’esecuzione è avvenuta tramite questo percorso; in tal caso timeRemaining() vale zero. In questa situazione l’esempio elabora un solo elemento per invocazione.

È una Web API di Window, non una funzionalità ECMAScript; la presenza di Node 24 non ne dimostra il supporto. Verifica la disponibilità nel browser di destinazione. La fonte è una bozza W3C, non una tabella di compatibilità dei browser.

Esempi

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

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