CKTIS / JavaScript
requestIdleCallback — práce během nečinnosti
requestIdleCallback plánuje méně naléhavou práci na dobu, kdy je prohlížeč nečinný. Callback dostane odhadovaný časový rozpočet, ale práci musí sám rozdělit a předat řízení dál.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const handle = window.requestIdleCallback(callback, { timeout: 1000 });
// callback receives an IdleDeadline: deadline.timeRemaining(), deadline.didTimeout
window.cancelIdleCallback(handle);window.requestIdleCallback(callback, options) naplánuje jednorázově méně naléhavou práci ve smyčce událostí stránky, nikoli v samostatném vlákně. Vrácený identifikátor umožňuje zrušit čekající volání pomocí window.cancelIdleCallback(handle).
Callback obdrží IdleDeadline: timeRemaining() uvádí odhad zbývajícího času v milisekundách, nikdy méně než nula. Rozdělte práci na malé části a zbytek naplánujte znovu; prohlížeč dlouhou operaci automaticky nepřeruší.
Bez timeout může čekání trvat neomezeně dlouho. Kladný timeout v milisekundách zařadí úlohu po uplynutí tohoto intervalu do fronty, ale nezaručuje přesný čas provedení. didTimeout označuje spuštění touto cestou; v takovém případě je timeRemaining() nula. Příklad tehdy zpracuje při jednom volání pouze jednu položku.
Jde o Web API rozhraní Window, nikoli o funkci ECMAScriptu; přítomnost Node 24 nedokazuje podporu. Ověřte dostupnost v cílovém prohlížeči. Zdrojem je návrh W3C, nikoli tabulka kompatibility prohlížečů.
Příklady
(() => {
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 });
})();Výsledek
10
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.