CKTIS / JavaScript
Animation.cancel(): отменяне на анимация
Animation.cancel() прекъсва анимацията и премахва ефекта ѝ върху елемента, вместо да я задържи на текущия кадър.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
animation.cancel();animation.cancel() е метод на Web Animations, а не на самия ECMAScript. Не приема аргументи и връща undefined. Задава playState на idle, а currentTime и startTime на null.
Премахва ефекта на анимацията, включително при fill: 'both'; не записва кадър в стиловете. За разлика от pause(), не запазва текущата позиция; за разлика от finish(), не преминава към края. Обектът може да бъде стартиран отново с play().
Ако анимацията не е в състояние idle, методът заменя досегашния promise finished с нов и поставя събитие cancel на опашка. Досегашният promise се отхвърля с грешка AbortError само ако все още е в състояние на изчакване. Ако вече е изпълнен, остава изпълнен. Добавете обработка на отхвърлянето преди отменянето. Примерът изисква браузър; Node 24 не доказва поддръжка на този API.
Примери
(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();
})();Резултат
idle true true AbortError
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.