Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

cancelIdleCallback(): zrušenie čakajúceho callbacku

cancelIdleCallback(handle) zruší čakajúci callback naplánovaný pomocou requestIdleCallback(). Vyžaduje identifikátor požiadavky, nie samotnú funkciu callbacku.

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

Syntax

window.cancelIdleCallback(handle)

window.cancelIdleCallback(handle) prijíma číselný identifikátor vrátený metódou requestIdleCallback() v tom istom okne. Metóda odstráni čakajúci callback, aj keď už je pripravený na spustenie. Vráti undefined.

Ak identifikátor nezodpovedá žiadnej čakajúcej požiadavke, metóda nič neurobí. Callback, ktorého vykonávanie sa už začalo, nemožno prerušiť a jeho účinky nemožno vrátiť späť.

Ide o Web API objektu Window, nie o funkciu definovanú štandardom ECMAScript. Skontrolujte dostupnosť oboch metód; prítomnosť Node 24 v repozitári nedokladá podporu v prehliadačoch.

Príklad zruší požiadavku hneď po naplánovaní, ešte pred odovzdaním riadenia prehliadaču. Uložte si identifikátor, aby ste mohli zrušiť prácu, ktorá už nie je potrebná.

Prí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ýsledok

Cancellation requested

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje