AnimationEffect：getComputedTiming() 方法

Baseline 已廣泛支援

此功能已經成熟，並可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 3 月⁩起，它已在各瀏覽器中推出。

AnimationEffect 介面的 getComputedTiming() 方法返回此動畫效果的計算後的計時屬性。

注意： 這些值可與使用 window.getComputedStyle(elem) 返回的 Element 的計算樣式進行比較。

語法

getComputedTiming()

無。

一個包含

AnimationEffect.getTiming() 返回的物件的全部屬性，只是任何 "auto" 值都將替換為可能取決於 AnimationEffect 型別的計算值。
以下附加屬性的物件

endTime

一個 number，表示效果從效果開始算起的結束時間（以毫秒為單位）。這等於 activeDuration 加上 delay 和 endDelay。

activeDuration

一個 number，表示效果所有迭代的總持續時間（以毫秒為單位）。這等於 duration 乘以 iterations（如果乘積為 NaN，則為零）。

localTime

一個 number 或 null。

表示效果已執行的時間長度（以毫秒為單位）。這等於關聯動畫的 currentTime，如果效果未與動畫關聯，則為 null。

progress

null 或一個大於等於 0 且小於 1 的 number。

表示效果在其當前迭代中的進度。在 activeDuration 開始時，這等於 iterationStart 的小數部分。

如果效果不在迭代中，例如因為效果處於 delay 或 endDelay 期間，效果已完成，或者 localTime 為 null，則返回 null。

currentIteration

null 或一個整數 number。

表示當前迭代的索引。在 activeDuration 開始時，這等於 iterationStart 的整數部分。

只要 progress 為 null，就返回 null。

規範
Web 動畫 # dom-animationeffect-getcomputedtiming

此頁面最後由 MDN 貢獻者於 2025年6月23日修改。