CKTIS / JavaScript
Animation.finished — промисът за завършване на анимацията
Animation.finished ви позволява с await да изчакате завършването на анимация, като отчетете и евентуалното ѝ отменяне.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const completedAnimation = await animation.finished;Animation.finished е свойство само за четене, което връща Promise<Animation>. Когато анимацията достигне състояние finished, включително чрез finish(), промисът може да се изпълни с обекта на анимацията. То не е булева стойност и не е метод.
Когато анимацията излезе от състояние finished, текущият промис се заменя само ако вече е изпълнен. Ако анимацията излезе от това състояние, преди поставеното в опашката известие за завършване да изпълни промиса, същият промис може да остане в изчакване. Прочетете свойството отново за следващо възпроизвеждане. Ако анимацията не е в състояние idle, cancel() отхвърля текущия ѝ промис finished с DOMException с име AbortError, при условие че промисът все още е в изчакване. Използвайте try/catch, за да обработите това отхвърляне. Ако анимацията вече е в състояние idle, промисът finished, който е в изчакване, остава в това състояние и след извикване на cancel(). Така изпълнението може да остане спряно на await, без да влезе в блока catch. ready показва готовност за възпроизвеждане или пауза, а не завършване на анимацията.
Това е част от Web Animations, а не от ECMAScript. Необходима е поддръжка от браузъра; наличието на Node 24 в хранилището не я потвърждава.
Примери
(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();
}
})();Резултат
true finished
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.