Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

cancelIdleCallback(): anulowanie oczekującego wywołania

cancelIdleCallback(handle) anuluje oczekujący callback zaplanowany przez requestIdleCallback(). Wymaga identyfikatora żądania, nie samej funkcji.

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.cancelIdleCallback(handle)

window.cancelIdleCallback(handle) otrzymuje liczbowy identyfikator zwrócony przez requestIdleCallback() w tym samym oknie. Usuwa oczekujący callback, także gdy jest już gotowy do uruchomienia. Zwraca undefined.

Jeśli identyfikator nie odpowiada oczekującemu żądaniu, metoda nic nie robi. Nie przerywa rozpoczętego callbacku ani nie cofa jego efektów.

To Web API interfejsu Window, nie funkcja zdefiniowana w ECMAScript. Sprawdzaj dostępność obu metod; obecność Node 24 w repozytorium nie potwierdza obsługi w przeglądarce.

Przykład anuluje żądanie natychmiast po zaplanowaniu, przed oddaniem sterowania przeglądarce. Zapisuj identyfikator, aby móc anulować niepotrzebną pracę.

Przykłady

(() => {
  if (typeof window === "undefined" ||
      typeof window.requestIdleCallback !== "function" ||
      typeof window.cancelIdleCallback !== "function") {
    console.log("Idle callbacks unavailable");
    return;
  }

  const handle = window.requestIdleCallback(() => {
    console.log("Unexpected callback");
  });
  window.cancelIdleCallback(handle);
  console.log("Cancellation requested");
})();

Wynik

Cancellation requested

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła