AnimationTimeline:currentTime 屬性

Baseline 已廣泛支援

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

Web Animations API 的 AnimationTimeline 介面的 currentTime 只讀屬性返回時間線當前的毫秒時間,如果時間線處於非活動狀態,則返回 null

一個數字,表示時間線當前的毫秒時間;如果時間線處於非活動狀態,則返回 null

時間精度降低

為了防止計時攻擊和指紋識別animationTimeline.currentTime 的精度可能會根據瀏覽器設定而進行舍入。在 Firefox 中,privacy.reduceTimerPrecision 偏好設定預設啟用,並且預設為 2ms。你也可以啟用 privacy.resistFingerprinting,在這種情況下,精度將是 100ms 或 privacy.resistFingerprinting.reduceTimerPrecision.microseconds 的值,取兩者中的較大者。

例如,在時間精度降低的情況下,animationTimeline.currentTime 的結果將始終是 0.002 的倍數,或者在啟用了 privacy.resistFingerprinting 的情況下是 0.1(或 privacy.resistFingerprinting.reduceTimerPrecision.microseconds)的倍數。

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

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

規範

規範
Web 動畫
# dom-animationtimeline-currenttime

瀏覽器相容性

另見