Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła