AnimationTimeline: currentTime プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2020.

currentTimeウェブアニメーション APIAnimationTimeline インターフェイスの読み取り専用のプロパティで、タイムラインの現在時刻をミリ秒単位で返します。タイムラインがアクティブでない場合は 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
// Firefox 60 における時間精度の低下 (2ms)
animationTimeline.currentTime;
// Might be:
// 23.404
// 24.192
// 25.514
// …

// `privacy.resistFingerprinting` が有効な場合の時間制度の低下
animationTimeline.currentTime;
// Might be:
// 49.8
// 50.6
// 51.7
// …

仕様書

Specification
Web Animations
# dom-animationtimeline-currenttime

ブラウザーの互換性

BCD tables only load in the browser

関連情報