CKTIS / JavaScript
requestIdleCallback — Arbeit in Leerlaufzeiten
requestIdleCallback plant nicht dringende Arbeit für Leerlaufzeiten des Browsers ein. Der Callback erhält ein geschätztes Zeitbudget, muss die Arbeit aber selbst aufteilen und die Kontrolle abgeben.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const handle = window.requestIdleCallback(callback, { timeout: 1000 });
// callback receives an IdleDeadline: deadline.timeRemaining(), deadline.didTimeout
window.cancelIdleCallback(handle);window.requestIdleCallback(callback, options) plant nicht dringende Arbeit einmalig in der Ereignisschleife der Seite ein, nicht in einem separaten Thread. Mit dem zurückgegebenen Handle kann ein noch ausstehender Aufruf durch window.cancelIdleCallback(handle) abgebrochen werden.
Der Callback erhält ein IdleDeadline: timeRemaining() gibt die geschätzte verbleibende Zeit in Millisekunden an, jedoch nie weniger als null. Teile die Arbeit in kleine Einheiten auf und plane den Rest erneut ein; der Browser unterbricht einen langen Vorgang nicht automatisch.
Ohne timeout kann die Wartezeit unbegrenzt sein. Ein positiver timeout in Millisekunden stellt nach diesem Zeitraum eine Aufgabe in die Warteschlange, garantiert aber keinen genauen Ausführungszeitpunkt. didTimeout kennzeichnet die Ausführung über diesen Weg; dann ist timeRemaining() null. In diesem Fall verarbeitet das Beispiel pro Aufruf nur ein Element.
Dies ist eine Web-API von Window, keine ECMAScript-Funktion; Node 24 zu haben, belegt keine Unterstützung. Prüfe die Verfügbarkeit im Zielbrowser. Die Quelle ist ein W3C-Entwurf, keine Browser-Kompatibilitätstabelle.
Beispiele
(() => {
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 });
})();Ergebnis
10
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.