CKTIS / JavaScript
Event.timeStamp en Event.type: aanmaaktijd en naam van een gebeurtenis
`event.type` geeft de naam van de gebeurtenis. `event.timeStamp` geeft aan wanneer die is aangemaakt, in milliseconden vanaf een tijdreferentiepunt.
Versie: Current web platform; runtime support varies
Syntax
event.type
event.timeStampevent.type en event.timeStamp zijn alleen-lezen eigenschappen van een DOM-gebeurtenisobject. Het zijn geen methoden of statische eigenschappen van de constructor Event. Ze horen bij de API van het webplatform, niet bij ECMAScript 2024, dus hun beschikbaarheid hangt af van de uitvoeromgeving.
event.type is de naam van de gebeurtenis als hoofdlettergevoelige tekenreeks. new Event("click") stelt het type in op "click". Dat komt overeen met een listener die is geregistreerd met addEventListener("click", ...), maar niet met addEventListener("Click", ...). De naam alleen bewijst niet dat iemand heeft geklikt.
event.timeStamp is een DOMHighResTimeStamp: een JavaScript-getal dat het aantal milliseconden aangeeft tussen het tijdreferentiepunt van het bijbehorende globale object en het aanmaken van de gebeurtenis. Het geeft niet aan wanneer de listener wordt uitgevoerd. Browsers kunnen de precisie beperken om timingaanvallen en fingerprinting tegen te gaan, waardoor twee gebeurtenissen dezelfde tijdstempel kunnen hebben.
Trek tijdstempels alleen rechtstreeks van elkaar af als ze hetzelfde tijdreferentiepunt hebben. Trek event.timeStamp niet rechtstreeks af van Date.now(), dat milliseconden sinds het Unix-tijdperk telt. Reken tijdstempels uit verschillende contexten, zoals een venster en een worker, eerst om naar een gemeenschappelijk tijdreferentiepunt.
Voorbeelden
{
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);
}Resultaat
type: lesson-ready timeStamp is a finite number: true timeStamp unchanged: true
Voer de code uit in de console van een browser. `dispatchEvent()` roept de overeenkomende listener synchroon aan. Het voorbeeld controleert of de tijdstempel een eindig getal is en gelijk is aan de waarde die vóór het versturen is gelezen. De tijdstempel zelf wordt niet gelogd, omdat de waarde per uitvoering kan verschillen.
Gerelateerde lessen
- JavaScript · Les 35 · Gemiddeld · Versie: 3