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

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

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

Източници