AnimationPlaybackEvent: currentTime 属性

Baseline 已广泛支持

此特性已经十分成熟,可在许多设备和浏览器版本上使用。自 2020 年 7 月以来,它已在各大浏览器中可用。

currentTimeAnimationPlaybackEvent 接口的一个只读属性,表示生成此事件时动画的当前时间。如果动画在生成事件时处于 idle 状态,此值将为未解析(unresolved)。

一个数字,表示当前时间(以毫秒为单位),或者 null

时间精度降低

为了防止计时攻击和指纹识别playbackEvent.currentTime 的精度可能会根据浏览器设置而进行舍入。在 Firefox 中,privacy.reduceTimerPrecision 首选项默认启用,并默认为 2ms。你也可以启用 privacy.resistFingerprinting,在这种情况下,精度将是 100ms 或 privacy.resistFingerprinting.reduceTimerPrecision.microseconds 的值,取两者中较大的一个。

例如,在降低时间精度的情况下,playbackEvent.currentTime 的结果将始终是 0.002 的倍数;如果启用了 privacy.resistFingerprinting,则为 0.1(或 privacy.resistFingerprinting.reduceTimerPrecision.microseconds)的倍数。

js
// reduced time precision (2ms) in Firefox 60
playbackEvent.currentTime;
// Might be:
// 23.404
// 24.192
// 25.514
// …

// reduced time precision with `privacy.resistFingerprinting` enabled
playbackEvent.currentTime;
// Might be:
// 49.8
// 50.6
// 51.7
// …

规范

规范
Web 动画
# dom-animationplaybackevent-currenttime

浏览器兼容性

另见