CKTIS / JavaScript
Event.timeStamp e Event.type: instante de criação e nome do evento
`event.type` indica o nome do evento e `event.timeStamp` indica quando foi criado, em milissegundos relativamente a uma origem temporal.
Versão: Current web platform; runtime support varies
Sintaxe
event.type
event.timeStampevent.type e event.timeStamp são propriedades só de leitura de um objeto de evento do DOM. Não são métodos nem propriedades estáticas do construtor Event. Fazem parte da API da plataforma web, não do ECMAScript 2024, pelo que a sua disponibilidade depende do ambiente de execução.
event.type contém o nome do evento como cadeia de caracteres e distingue maiúsculas de minúsculas. new Event("click") define o tipo como "click", que corresponde a um ouvinte registado com addEventListener("click", ...), mas não com addEventListener("Click", ...). O nome, por si só, não prova que alguém tenha clicado.
event.timeStamp é um DOMHighResTimeStamp: um número JavaScript que indica os milissegundos decorridos desde a origem temporal do objeto global relevante até à criação do evento. Não indica quando o ouvinte é executado. Os navegadores podem reduzir a precisão para mitigar ataques de temporização e a identificação por impressão digital, pelo que dois eventos podem ter a mesma marca temporal.
Subtrai diretamente marcas temporais apenas se partilharem a mesma origem temporal. Não subtraias event.timeStamp diretamente de Date.now(), que conta milissegundos desde a época Unix. Antes de comparares marcas de contextos diferentes, como uma janela e um worker, exprime-as em relação a uma origem comum.
Exemplos
{
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
Executa o código na consola de um navegador. `dispatchEvent()` chama o ouvinte correspondente de forma síncrona. O exemplo verifica se a marca temporal é um número finito e se coincide com o valor lido antes do envio. Não apresenta a própria marca temporal porque o valor varia entre execuções.
Lições relacionadas
- JavaScript · Lição 35 · Intermédio · Versão: 3