Animation: finished property

Baseline 已廣泛支援

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

Animation.finishedWeb Animations API 的只讀屬性,它返回一個 Promise 物件,該物件在動畫播放完成後解決(resolve)。

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

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

示例

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

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

規範

規範
Web 動畫
# dom-animation-finished

瀏覽器相容性

另見