Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

cancelIdleCallback(): preklic čakajočega povratnega klica

cancelIdleCallback(handle) prekliče čakajoči povratni klic, načrtovan z requestIdleCallback(). Potrebuje identifikator zahteve, ne same funkcije povratnega klica.

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

Sintaksa

window.cancelIdleCallback(handle)

window.cancelIdleCallback(handle) prejme številski identifikator, ki ga vrne requestIdleCallback() v istem oknu. Metoda odstrani čakajoči povratni klic, tudi če je že pripravljen na izvedbo. Vrne undefined.

Če se identifikator ne ujema z nobeno čakajočo zahtevo, metoda ne naredi ničesar. Povratnega klica, ki se je že začel izvajati, ni mogoče prekiniti, prav tako ni mogoče razveljaviti njegovih učinkov.

To je spletni API objekta Window, ne funkcija, določena v ECMAScriptu. Preverite, ali sta na voljo obe metodi; prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.

Primer prekliče zahtevo takoj po načrtovanju, še preden prepusti nadzor brskalniku. Shranite identifikator, da lahko prekličete delo, ki ni več potrebno.

Primeri

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

Rezultat

Cancellation requested

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri