Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Animation.cancel(): otkazivanje animacije

Animation.cancel() prekida animaciju i uklanja njezin učinak na element, umjesto da je zadrži na trenutačnom okviru.

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

animation.cancel();

animation.cancel() metoda je Web Animationsa, a ne samog ECMAScripta. Ne prima argumente i vraća undefined. Postavlja playState na idle, a currentTime i startTime na null.

Uklanja učinak animacije, uključujući i uz fill: 'both'; ne sprema okvir u stilove. Za razliku od pause(), ne čuva trenutačni položaj; za razliku od finish(), ne prelazi na kraj. Objekt se može ponovno pokrenuti pomoću play().

Ako animacija nije u stanju idle, metoda zamjenjuje postojeći finished promise novim i stavlja događaj cancel u red čekanja. Prethodni promise odbacuje s pogreškom AbortError samo ako je još na čekanju. Ako je već ispunjen, ostaje ispunjen. Obradu odbacivanja dodajte prije otkazivanja. Primjer zahtijeva preglednik; Node 24 ne potvrđuje podršku za ovaj API.

Primjeri

(async () => {
  const box = document.createElement('div');
  document.body.append(box);
  const animation = box.animate(
    [{ opacity: 0 }, { opacity: 1 }],
    { duration: 1000, fill: 'both' }
  );
  const outcome = animation.finished.catch(error => error.name);
  animation.cancel();
  console.log(animation.playState);
  console.log(animation.currentTime === null);
  console.log(animation.startTime === null);
  console.log(await outcome);
  box.remove();
})();

Rezultat

idle
true
true
AbortError

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

Izvori