From e09c3a55ea380ab963f6d0401722c20c715fe05d Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Wed, 7 Aug 2024 11:39:18 +0900 Subject: [PATCH] =?UTF-8?q?2024/07/05=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../animationtimeline/currenttime/index.md | 54 +++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 files/ja/web/api/animationtimeline/currenttime/index.md diff --git a/files/ja/web/api/animationtimeline/currenttime/index.md b/files/ja/web/api/animationtimeline/currenttime/index.md new file mode 100644 index 00000000000000..055c4ebd8e49d4 --- /dev/null +++ b/files/ja/web/api/animationtimeline/currenttime/index.md @@ -0,0 +1,54 @@ +--- +title: "AnimationTimeline: currentTime プロパティ" +short-title: currentTime +slug: Web/API/AnimationTimeline/currentTime +l10n: + sourceCommit: 3b5a1c0dfd59257c0a51052a9efa7b0108f8ecca +--- + +{{ APIRef("Web Animations") }} + +**`currentTime`** は[ウェブアニメーション API](/ja/docs/Web/API/Web_Animations_API) の {{domxref("AnimationTimeline")}} インターフェイスの読み取り専用のプロパティで、タイムラインの現在時刻をミリ秒単位で返します。タイムラインがアクティブでない場合は `null` を返します。 + +## 値 + +タイムラインの現在時刻をミリ秒で表します。タイムラインがアクティブでない場合は `null` です。 + +## 時間精度の低下 + +タイミング攻撃や[フィンガープリンティング](/ja/docs/Glossary/Fingerprinting)から保護するために、 `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 +// … +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [ウェブアニメーション API](/ja/docs/Web/API/Web_Animations_API) +- {{domxref("AnimationTimeline")}} +- {{domxref("DocumentTimeline")}} このプロパティを継承 +- {{domxref("Document.timeline")}} は、このインターフェイスを継承するタイムラインオブジェクトを返す