Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

cancelIdleCallback(): zrušení čekajícího callbacku

cancelIdleCallback(handle) zruší čekající callback naplánovaný pomocí requestIdleCallback(). Vyžaduje identifikátor požadavku, nikoli samotnou funkci callbacku.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

window.cancelIdleCallback(handle)

window.cancelIdleCallback(handle) přebírá číselný identifikátor vrácený metodou requestIdleCallback() ve stejném okně. Metoda odstraní čekající callback, i když už je připraven ke spuštění. Vrací undefined.

Pokud identifikátor neodpovídá žádnému čekajícímu požadavku, metoda nic neudělá. Callback, jehož vykonávání už začalo, nelze přerušit a jeho účinky nelze vrátit zpět.

Jde o Web API objektu Window, nikoli o funkci definovanou standardem ECMAScript. Ověřte dostupnost obou metod; přítomnost Node 24 v repozitáři nedokládá podporu v prohlížečích.

Příklad zruší požadavek ihned po naplánování, ještě před předáním řízení prohlížeči. Uložte si identifikátor, abyste mohli zrušit práci, která už není potřeba.

Příklady

(() => {
  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");
})();

Výsledek

Cancellation requested

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje