Retourne le temps (en millisecondes) à partir duquel l'événement a été créé.

Note : Cette propriété fonctionne seulement si le système d'évènements le prend en charge pour des évènements particuliers.

Syntaxe

event.timeStamp

Valeur

Cette valeur est un nombre de millisecondes écoulées depuis le début du temps de vie du document courant jusqu'à la création de l'évènement.

Dans les nouvelles implémentations, la valeur est un DOMHighResTimeStamp dont la précision est de 5 microsecondes (0,005 ms). Dans les implémentations plus anciennes, la valeur est un DOMTimeStamp de précision d'une milliseconde.

Exemple

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) {
  var time = document.getElementById("time");
  time.firstChild.nodeValue = event.timeStamp;
}
document.body.addEventListener("keypress", getTime);

Résultat

Précision du temps réduite

Pour offrir une protection contre les attaques de synchronisation et les empreintes digitales, la précision de event.timeStamp peut être arrondie en fonction des paramètres du navigateur.
Dans Firefox, la préférence privacy.reduceTimerPrecision est activée et à 20 us par défaut dans Firefox 59 ; en version 60 ce sera 2 ms.

// Précision du temps réduite (2ms) dans Firefox 60
event.timeStamp;
// 1519211809934
// 1519211810362
// 1519211811670
// ...


// Précision du temps réduite avec `privacy.resistFingerprinting` activé
event.timeStamp;
// 1519129853500
// 1519129858900
// 1519129864400
// ...

Dans Firefox, vous pouvez aussi activer privacy.resistFingerprinting, la précision sera de 100 ms ou la valeur de privacy.resistFingerprinting.reduceTimerPrecision.microseconds, selon la valeur la plus grande.

Spécifications

Spécification Statut Commentaire
DOM
La définition de 'Event.timeStamp' dans cette spécification.
Standard évolutif  
DOM4
La définition de 'Event.timeStamp' dans cette spécification.
Obsolete  
Document Object Model (DOM) Level 2 Events Specification
La définition de 'Event.timeStamp' dans cette spécification.
Obsolete Définition initiale.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung Internet
Support simpleChrome Support complet 49
Notes
Support complet 49
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Edge Support complet OuiFirefox Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
IE Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Opera Support complet 36
Notes
Support complet 36
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Safari Support complet OuiWebView Android Support complet 49
Notes
Support complet 49
Notes
Notes Starting with version 49, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Chrome Android Support complet 49
Notes
Support complet 49
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Edge Mobile Support complet OuiFirefox Android Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Opera Android Support complet 36
Notes
Support complet 36
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Safari iOS Support complet OuiSamsung Internet Android ?

Légende

Support complet  
Support complet
Compatibilité inconnue  
Compatibilité inconnue
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : loella16, Kalwyn
Dernière mise à jour par : loella16,