CKTIS / JavaScript
Event.timeStamp y Event.type: momento de creación y nombre del evento
`event.type` indica el nombre del evento y `event.timeStamp` indica cuándo se creó, en milisegundos con respecto a un origen temporal.
Versión: Current web platform; runtime support varies
Sintaxis
event.type
event.timeStampevent.type y event.timeStamp son propiedades de solo lectura de un objeto de evento del DOM. No son métodos ni propiedades estáticas del constructor Event. Forman parte de la API de la plataforma web, no de ECMAScript 2024, por lo que su disponibilidad depende del entorno de ejecución.
event.type contiene el nombre del evento como cadena y distingue mayúsculas de minúsculas. new Event("click") establece el tipo en "click", que coincide con un escuchador registrado mediante addEventListener("click", ...), pero no mediante addEventListener("Click", ...). El nombre por sí solo no demuestra que alguien haya hecho clic.
event.timeStamp es un DOMHighResTimeStamp: un número de JavaScript que mide los milisegundos transcurridos desde el origen temporal del objeto global correspondiente hasta la creación del evento. No indica cuándo se ejecuta el escuchador. Los navegadores pueden reducir la precisión para mitigar los ataques de temporización y la identificación por huella digital, por lo que dos eventos pueden tener la misma marca de tiempo.
Resta marcas de tiempo directamente solo si comparten el mismo origen temporal. No restes event.timeStamp directamente de Date.now(), que cuenta milisegundos desde la época Unix. Antes de comparar marcas de contextos distintos, como una ventana y un worker, exprésalas con respecto a un origen común.
Ejemplos
{
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);
}Resultado
type: lesson-ready timeStamp is a finite number: true timeStamp unchanged: true
Ejecuta el código en la consola del navegador. `dispatchEvent()` llama de forma síncrona al escuchador que coincide con el tipo. El ejemplo comprueba que la marca de tiempo es un número finito e igual al valor leído antes del envío. No muestra la marca en sí porque su valor varía entre ejecuciones.
Lecciones relacionadas
- JavaScript · Lección 35 · Intermedio · Versión: 3