База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници