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: Diese Funktion ist in Web Workers verfügbar.
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
<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
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.
// 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