CKTIS / JavaScript
Event.timeStamp et Event.type : instant de création et nom de l’événement
`event.type` indique le nom de l’événement. `event.timeStamp` indique son instant de création en millisecondes par rapport à une origine temporelle.
Version : Current web platform; runtime support varies
Syntaxe
event.type
event.timeStampevent.type et event.timeStamp sont deux propriétés en lecture seule d’un objet événement du DOM. Ce ne sont ni des méthodes ni des propriétés statiques du constructeur Event. Elles relèvent des API de la plateforme web et non d’ECMAScript 2024 : leur disponibilité dépend donc de l’environnement d’exécution.
event.type contient le nom de l’événement sous forme de chaîne sensible à la casse. new Event("click") fixe le type à "click", ce qui correspond à un écouteur enregistré avec addEventListener("click", ...), mais pas avec addEventListener("Click", ...). Le nom seul ne prouve pas qu’une personne a cliqué.
event.timeStamp est un DOMHighResTimeStamp : un nombre JavaScript qui exprime en millisecondes le temps écoulé entre l’origine temporelle de l’objet global concerné et la création de l’événement. Il n’indique pas quand l’écouteur s’exécute. Les navigateurs peuvent réduire la précision pour limiter les attaques temporelles et l’identification par empreinte numérique : deux événements peuvent donc avoir le même horodatage.
Ne soustrayez directement deux horodatages que s’ils partagent la même origine temporelle. Ne soustrayez pas directement event.timeStamp de Date.now(), qui compte les millisecondes depuis l’époque Unix. Ramenez les horodatages de contextes différents, par exemple une fenêtre et un worker, à une origine commune avant de les comparer.
Exemples
{
const target = new EventTarget();
const event = new Event("lesson-ready");
const createdAt = event.timeStamp;
target.addEventListener("lesson-ready", (received) => {
console.log(`type: ${received.type}`);
console.log(`timeStamp is a finite number: ${Number.isFinite(received.timeStamp)}`);
console.log(`timeStamp unchanged: ${received.timeStamp === createdAt}`);
});
target.dispatchEvent(event);
}Résultat
type: lesson-ready timeStamp is a finite number: true timeStamp unchanged: true
Exécutez le code dans la console d’un navigateur. `dispatchEvent()` appelle l’écouteur correspondant de façon synchrone. L’exemple vérifie que l’horodatage est un nombre fini et qu’il correspond à la valeur lue avant la distribution. Il ne l’affiche pas, car cette valeur varie d’une exécution à l’autre.
Leçons associées
- JavaScript · Leçon 35 · Intermédiaire · Version : 3