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.