Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

IdleDeadline — budżet czasu zadania bezczynności

IdleDeadline to obiekt przekazywany do funkcji zwrotnej requestIdleCallback(). Udostępnia szacowany pozostały czas i informację, czy wywołanie nastąpiło z powodu timeout.

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

window.requestIdleCallback((deadline) => { deadline.didTimeout; deadline.timeRemaining(); }, { timeout: 1000 });

IdleDeadline jest interfejsem Web API dla Window, a nie częścią ECMAScript. Obiekt dostarcza przeglądarka do funkcji zwrotnej requestIdleCallback(); nie twórz go przez new IdleDeadline(). Wykrywaj dostępność API; Node 24 nie dowodzi obsługi w przeglądarce.

IdleDeadline.timeRemaining() zwraca szacowany pozostały czas w milisekundach jako nieujemny DOMHighResTimeStamp, potencjalnie ułamkowy. Po osiągnięciu terminu zwraca 0. Sprawdzaj go między małymi porcjami pracy: termin nie przerywa wykonywanego kodu.

IdleDeadline.didTimeout to właściwość logiczna tylko do odczytu. Wartość true oznacza wywołanie wskutek przekroczenia opcji timeout; wtedy timeRemaining() zwraca 0. Samo wyczerpanie budżetu nie zmienia didTimeout na true. timeout nie gwarantuje dokładnej chwili uruchomienia.

Przykład sumuje liczby porcjami i ponownie planuje niedokończoną pracę. Ścieżka didTimeout dopuszcza jedną małą operację, nie nieograniczoną pętlę. To współdzielenie głównego wątku, nie praca w osobnym wątku.

Przykłady

(() => {
  if (typeof window.requestIdleCallback !== "function") {
    console.log("requestIdleCallback unavailable");
    return;
  }

  const values = [1, 2, 3, 4];
  let index = 0;
  let total = 0;

  function work(deadline) {
    let processed = 0;
    while (
      index < values.length &&
      (deadline.timeRemaining() > 1 ||
        (deadline.didTimeout && processed === 0))
    ) {
      total += values[index++];
      processed++;
    }

    if (index < values.length) {
      window.requestIdleCallback(work, { timeout: 1000 });
    } else {
      console.log(total);
    }
  }

  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