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.