CKTIS / JavaScript
Animation.cancel(): preklic animacije
Animation.cancel() prekine animacijo in odstrani njen učinek na elementu, namesto da bi jo ustavila na trenutni sličici.
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
animation.cancel();animation.cancel() je metoda Web Animations, ne samega ECMAScripta. Ne sprejema argumentov in vrne undefined. Nastavi playState na idle, currentTime in startTime pa na null.
Odstrani učinek animacije, tudi pri fill: 'both'; sličice ne shrani v sloge. Za razliko od pause() ne ohrani trenutnega položaja; za razliko od finish() ne skoči na konec. Objekt lahko znova zaženete z play().
Če animacija ni v stanju idle, metoda nadomesti obstoječo obljubo finished z novo in v čakalno vrsto doda dogodek cancel. Prejšnjo obljubo zavrne z napako AbortError le, če je še v teku. Če je bila že izpolnjena, ostane izpolnjena. Obravnavo zavrnitve dodajte pred preklicem. Primer zahteva brskalnik; Node 24 ne potrjuje podpore za ta API.
Primeri
(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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.