Animation: finished property

Baseline 已廣泛支援

此特性已經十分成熟，可在許多裝置和瀏覽器版本上使用。自 2020 年 7 月以來，它已在各大瀏覽器中可用。

Animation.finished 是 Web Animations API 的只讀屬性，它返回一個 Promise 物件，該物件在動畫播放完成後解決（resolve）。

注意： 每次動畫離開 finished 播放狀態（即重新開始播放時），都會為該屬性建立一個新的 Promise。新的 Promise 將在新動畫序列完成後解決。

值

一個 Promise 物件，它將在動畫執行完成後解決。

以下程式碼等待元素 elem 上所有正在執行的動畫完成後，將該元素從 DOM 樹中刪除：

Promise.all(elem.getAnimations().map((animation) => animation.finished)).then(
  () => elem.remove(),
);

規範
Web 動畫 # dom-animation-finished

此頁面最後更新於 2024年7月26日，由 MDN 貢獻者更新。