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日修改。