Event: timeStamp プロパティ
timeStamp
は Event
インターフェイスの読み取り専用プロパティで、イベントが作成された時刻(ミリ秒単位)を返します。
値
この値は、時間の起点からイベントが作成されるまでの経過ミリ秒数です。
グローバルオブジェクトが Window
である場合、ユーザーがリンクをクリックした瞬間、または文書の読み込みを開始したスクリプトが時間の起点となります。
ワーカーでは、時間の起点はワーカーが作成された瞬間となります。
値は、5 マイクロ秒(0.005 ミリ秒)精度の DOMHighResTimeStamp
ですが、フィンガープリンティングを防ぐために精度が落とされています。
例
HTML
html
<p>
この iframe にフォーカスを設定していずれかのキーを押下すると、 keypress
イベントの現在のタイムスタンプを取得します。
</p>
<p>timeStamp: <span id="time">-</span></p>
JavaScript
js
function getTime(event) {
const time = document.getElementById("time");
time.firstChild.nodeValue = event.timeStamp;
}
document.body.addEventListener("keypress", getTime);
結果
時間精度の低下
タイミング攻撃やフィンガープリントに対する保護を提供するために、Event.timeStamp
の精度はブラウザーの設定によって丸められていることがあります。
Firefox では、privacy.reduceTimerPrecision
環境設定が既定で有効になっており、既定値は 2 ミリ秒になっています。
js
// Firefox での時間精度の低下(既定: 2 ミリ秒)
event.timeStamp;
// 9934
// 10362
// 11670
// …
Firefox では、 privacy.resistFingerprinting
も有効にすると、精度は 100 ミリ秒または privacy.resistFingerprinting.reduceTimerPrecision.microseconds
の値のうち大きい方になります。
仕様書
Specification |
---|
DOM Standard # ref-for-dom-event-timestamp① |
ブラウザーの互換性
BCD tables only load in the browser