CKTIS / JavaScript
Animation.finished — promise dokončenia animácie
Animation.finished umožňuje pomocou await čakať na dokončenie animácie a zohľadniť pritom jej prípadné zrušenie.
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
const completedAnimation = await animation.finished;Animation.finished je vlastnosť iba na čítanie, ktorá vracia Promise<Animation>. Keď animácia dosiahne stav finished, napríklad volaním finish(), môže sa promise splniť objektom animácie. Nie je to logická hodnota ani metóda.
Keď animácia opustí stav finished, aktuálna promise sa nahradí len vtedy, ak už bola splnená. Ak animácia opustí tento stav skôr, než oznámenie o dokončení zaradené do frontu splní promise, tá istá promise môže zostať nevybavená. Pri ďalšom prehrávaní vlastnosť znova načítaj. Ak animácia nie je v stave idle, cancel() zamietne jej aktuálnu promise finished výnimkou DOMException s názvom AbortError, pokiaľ táto promise ešte čaká na vyhodnotenie. Toto zamietnutie môžeš zachytiť pomocou try/catch. Ak je animácia už v stave idle, čakajúca promise finished sa ani po volaní cancel() nevyhodnotí. await tak môže ďalej čakať bez toho, aby sa vykonal blok catch. ready označuje pripravenosť prehrávania alebo pozastavenia, nie dokončenie animácie.
Patrí do Web Animations, nie do ECMAScriptu. Vyžaduje sa podpora prehliadača; prítomnosť Node 24 v repozitári ju nepotvrdzuje.
Príklady
(async () => {
const element = document.createElement('div');
element.textContent = 'Animation.finished';
document.body.append(element);
const animation = element.animate(
[{ opacity: 0 }, { opacity: 1 }],
{ duration: 1000, fill: 'forwards' }
);
try {
const completion = animation.finished;
animation.finish();
const result = await completion;
console.log(result === animation);
console.log(animation.playState);
} catch (error) {
console.log(error.name);
} finally {
animation.cancel();
element.remove();
}
})();Výsledok
true finished
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.