Event: timeStamp-Eigenschaft

Baseline Widely available

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

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die timeStamp-Eigenschaft des Event-Interfaces ist eine schreibgeschützte Eigenschaft, die die Zeit (in Millisekunden) zurückgibt, zu der das Ereignis erstellt wurde.

Wert

Dieser Wert ist die Anzahl an Millisekunden, die vom Beginn des Zeitursprungs bis zur Erstellung des Ereignisses vergangen sind. Wenn das globale Objekt ein Window ist, entspricht der Zeitursprung dem Moment, in dem der Benutzer auf den Link geklickt hat oder das Skript, das das Laden des Dokuments initiiert hat. In einem Worker ist der Zeitursprung der Moment der Erstellung des Workers.

Der Wert ist ein DOMHighResTimeStamp, der auf 5 Mikrosekunden (0,005 ms) genau ist, wobei die Präzision reduziert wird, um Fingerabdrücke zu verhindern.

Beispiel

HTML

html
<p>
  Focus this iframe and press any key to get the current timestamp for the
  keypress event.
</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);

Ergebnis

Reduzierte Zeitpräzision

Um Schutz vor Timing-Angriffen und Fingerabdrücken zu bieten, könnte die Präzision von event.timeStamp je nach Browsereinstellungen gerundet werden. In Firefox ist die Einstellung privacy.reduceTimerPrecision standardmäßig aktiviert und auf 2 ms festgelegt. Sie können auch privacy.resistFingerprinting aktivieren. In diesem Fall beträgt die Präzision 100 ms oder den Wert von privacy.resistFingerprinting.reduceTimerPrecision.microseconds, je nachdem, welcher Wert größer ist.

Zum Beispiel wird mit reduzierter Zeitpräzision das Ergebnis von event.timeStamp immer ein Vielfaches von 2 sein oder ein Vielfaches von 100 (oder privacy.resistFingerprinting.reduceTimerPrecision.microseconds), wenn privacy.resistFingerprinting aktiviert ist.

js
// reduced time precision (2ms) in Firefox 60
event.timeStamp;
// Might be:
// 9934
// 10362
// 11670
// …

// reduced time precision with `privacy.resistFingerprinting` enabled
event.timeStamp;
// Might be:
// 53500
// 58900
// 64400
// …

Spezifikationen

Specification
DOM Standard
# ref-for-dom-event-timestamp①

Browser-Kompatibilität

BCD tables only load in the browser