We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

Returns the time (in milliseconds) at which the event was created.

Note: This property only works if the event system supports it for the particular event.

Syntax

event.timeStamp

Value

This value is the number of milliseconds elapsed from the beginning of the current document's lifetime till the event was created.

In newer implementations, the value is a DOMHighResTimeStamp  accurate to 5 microseconds (0.005 ms). In older implementations, the value is a DOMTimeStamp, accurate to a millisecond.

Example

HTML content

<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 content

function getTime(event) {
  var time = document.getElementById("time");
  time.firstChild.nodeValue = event.timeStamp;
}
document.body.addEventListener("keypress", getTime);

Result

Reduced time precision

To offer protection against timing attacks and fingerprinting, the precision of event.timeStamp might get rounded depending on browser settings.
In Firefox, the privacy.reduceTimerPrecision  preference is enabled by default and defaults to 20us in Firefox 59; in 60 it will be 2ms.

// reduced time precision (2ms) in Firefox 60
event.timeStamp;
// 1519211809934
// 1519211810362
// 1519211811670
// ...


// reduced time precision with `privacy.resistFingerprinting` enabled
event.timeStamp;
// 1519129853500
// 1519129858900
// 1519129864400
// ...

In Firefox, you can also enabled privacy.resistFingerprinting, the precision will be 100ms or the value of privacy.resistFingerprinting.reduceTimerPrecision.microseconds, whichever is larger.

Specifications

Specification Status Comment
DOM
The definition of 'Event.timeStamp' in that specification.
Living Standard  
DOM4
The definition of 'Event.timeStamp' in that specification.
Obsolete  
Document Object Model (DOM) Level 2 Events Specification
The definition of 'Event.timeStamp' in that specification.
Obsolete Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support491 Yes Yes1 Yes1361 Yes
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support491491 Yes Yes1361 Yes ?

1. Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.