WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Event.timeStamp und Event.type: Erstellungszeit und Ereignisname

`event.type` gibt den Namen des Ereignisses an. `event.timeStamp` gibt seinen Erstellungszeitpunkt in Millisekunden relativ zu einem Zeitursprung an.

Version: Current web platform; runtime support varies

Syntax

event.type
 event.timeStamp

event.type und event.timeStamp sind schreibgeschützte Eigenschaften eines DOM-Ereignisobjekts. Sie sind weder Methoden noch statische Eigenschaften des Konstruktors Event. Sie gehören zur Webplattform-API, nicht zu ECMAScript 2024, und ihre Verfügbarkeit hängt von der Laufzeitumgebung ab.

event.type ist der Ereignisname als Zeichenkette. Groß- und Kleinschreibung werden unterschieden. new Event("click") setzt den Typ auf "click". Das passt zu einem mit addEventListener("click", ...) registrierten Listener, aber nicht zu addEventListener("Click", ...). Der Name allein beweist nicht, dass jemand geklickt hat.

event.timeStamp ist ein DOMHighResTimeStamp: eine JavaScript-Zahl in Millisekunden vom Zeitursprung des zugehörigen globalen Objekts bis zur Erstellung des Ereignisses. Sie gibt nicht an, wann der Listener ausgeführt wird. Browser können die Zeitauflösung verringern, um Timing-Angriffe und Fingerprinting zu erschweren. Deshalb können zwei Ereignisse denselben Zeitstempel haben.

Subtrahiere Zeitstempel nur dann direkt voneinander, wenn sie denselben Zeitursprung haben. Ziehe event.timeStamp nicht direkt von Date.now() ab: Date.now() zählt Millisekunden seit der Unix-Epoche. Bringe Zeitstempel aus verschiedenen Kontexten, etwa einem Fenster und einem Worker, vor dem Vergleich auf einen gemeinsamen Zeitursprung.

Beispiele

{
  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);
}

Ergebnis

type: lesson-ready
timeStamp is a finite number: true
timeStamp unchanged: true

Führe den Code in einer Browserkonsole aus. `dispatchEvent()` ruft den passenden Listener synchron auf. Das Beispiel prüft, ob der Zeitstempel eine endliche Zahl ist und dem vor dem Auslösen gelesenen Wert entspricht. Der Zeitstempel selbst wird nicht ausgegeben, da er sich von Lauf zu Lauf ändern kann.

Zugehörige Lektionen

  • JavaScript · Lektion 35 · Mittlere Stufe · Version: 3

Quellen