Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

cancelAnimationFrame — otkazivanje čekajućeg povratnog poziva

cancelAnimationFrame(handle) uklanja čekajući povratni poziv registriran pomoću requestAnimationFrame(). Upotrijebite vraćeni identifikator u istom kontekstu; metoda ne prekida kod koji se već izvršava.

Verzija: 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.cancelAnimationFrame(handle);

cancelAnimationFrame(handle) otkazuje jedan čekajući povratni poziv registriran pomoću requestAnimationFrame(). Proslijedite vraćeni identifikator handle, a ne funkciju povratnog poziva, i upotrijebite isti objekt koji pruža API. Metoda vraća undefined.

Identifikator koji više nije među čekajućim povratnim pozivima ne mijenja ništa. Otkazivanje ne prekida povratni poziv koji je već započeo niti poništava njegove učinke. U petlji koja zakazuje sljedeće okvire spremite najnoviji identifikator i otkažite upravo njega; raniji identifikator ne predstavlja cijelu animaciju.

Ovo je Web API iz HTML Living Standard, a ne funkcija ECMAScript. Podržavaju ga aktualni mehanizmi preglednika za Window. Standard ga predviđa i u podržanim kontekstima DedicatedWorkerGlobalScope; nepodržani kontekst izaziva NotSupportedError. Verzija Nodea koja se upotrebljava u repozitoriju ne potvrđuje dostupnost ovog API-ja.

Primjer otkazuje prvi povratni poziv, a zatim provjerava brojač u drugom povratnom pozivu. Očekivani izlaz je calls: 0 i result: undefined. Ta se provjera događa tek kada preglednik pokrene drugi povratni poziv.

Primjeri

(() => {
  let calls = 0;
  const handle = window.requestAnimationFrame(() => {
    calls += 1;
  });

  const result = window.cancelAnimationFrame(handle);

  window.requestAnimationFrame(() => {
    console.log(`calls: ${calls}`);
    console.log(`result: ${result}`);
  });
})();

Rezultat

calls: 0
result: undefined

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori