CKTIS / JavaScript
Event.timeStamp ed Event.type: istante di creazione e nome dell’evento
`event.type` indica il nome dell’evento; `event.timeStamp` indica quando è stato creato, in millisecondi rispetto a un’origine temporale.
Versione: Current web platform; runtime support varies
Sintassi
event.type
event.timeStampevent.type ed event.timeStamp sono proprietà di sola lettura di un oggetto evento del DOM. Non sono metodi né proprietà statiche del costruttore Event. Fanno parte dell’API della piattaforma web, non di ECMAScript 2024, quindi la loro disponibilità dipende dall’ambiente di esecuzione.
event.type contiene il nome dell’evento come stringa e distingue maiuscole e minuscole. new Event("click") imposta il tipo su "click", che corrisponde a un listener registrato con addEventListener("click", ...), ma non con addEventListener("Click", ...). Il nome da solo non dimostra che una persona abbia fatto clic.
event.timeStamp è un DOMHighResTimeStamp: un numero JavaScript che esprime i millisecondi trascorsi dall’origine temporale dell’oggetto globale di riferimento fino alla creazione dell’evento. Non indica quando viene eseguito il listener. I browser possono ridurre la precisione per contrastare gli attacchi basati sui tempi e il fingerprinting, quindi due eventi possono avere lo stesso timestamp.
Sottrai direttamente due timestamp solo se hanno la stessa origine temporale. Non sottrarre event.timeStamp direttamente da Date.now(), che conta i millisecondi dall’epoca Unix. Prima di confrontare timestamp di contesti diversi, come una finestra e un worker, riportali a un’origine comune.
Esempi
{
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);
}Risultato
type: lesson-ready timeStamp is a finite number: true timeStamp unchanged: true
Esegui il codice nella console del browser. `dispatchEvent()` chiama il listener corrispondente in modo sincrono. L’esempio controlla che il timestamp sia un numero finito e coincida con il valore letto prima dell’invio. Non stampa il timestamp stesso perché il suo valore varia tra le esecuzioni.
Lezioni correlate
- JavaScript · Lezione 35 · Intermedio · Versione: 3