CKTIS / JavaScript
requestIdleCallback — praca w czasie bezczynności
requestIdleCallback planuje niepilną pracę na czas bezczynności przeglądarki. Callback otrzymuje szacowany budżet czasu, ale sam musi dzielić pracę i oddawać sterowanie.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const handle = window.requestIdleCallback(callback, { timeout: 1000 });
// callback receives an IdleDeadline: deadline.timeRemaining(), deadline.didTimeout
window.cancelIdleCallback(handle);window.requestIdleCallback(callback, options) zleca jednorazowe wykonanie niepilnej pracy w pętli zdarzeń strony, nie w osobnym wątku. Zwrócony uchwyt pozwala anulować oczekujące wywołanie przez window.cancelIdleCallback(handle).
Callback otrzymuje IdleDeadline: timeRemaining() podaje szacowany pozostały czas w milisekundach, co najmniej zero. Dziel pracę na małe porcje i ponownie planuj resztę; przeglądarka nie przerywa automatycznie długiej operacji.
Bez timeout oczekiwanie może być nieograniczone. Dodatni timeout w milisekundach powoduje zakolejkowanie zadania po upływie tego czasu, nie gwarantuje dokładnej chwili wykonania. didTimeout oznacza uruchomienie tą ścieżką; wtedy timeRemaining() wynosi zero. Przykład przetwarza w takim przypadku tylko jeden element na wywołanie.
To Web API interfejsu Window, nie funkcja ECMAScript; obecność Node 24 nie dowodzi obsługi. Sprawdzaj dostępność w docelowej przeglądarce. Źródłem jest projekt W3C, a nie tabela zgodności przeglądarek.
Przykłady
(() => {
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 });
})();Wynik
10
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.