Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.timeStamp

event.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

Sources