Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Event — o objeto de evento

Event representa um evento. As suas propriedades descrevem o tipo, o destino e a hora de criação do evento.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

new Event(type, { bubbles: false, cancelable: false, composed: false })

Event é uma interface da API Web definida pelo DOM Standard, não por ECMAScript. O construtor aceita um tipo; bubbles, cancelable e composed têm o valor false por predefinição.

Event.type é o nome do evento. Event.target é o seu destino e, inicialmente, tem o valor null; o Shadow DOM pode redirecioná-lo. currentTarget identifica o objeto que está a tratar o listener nesse momento.

Event.timeStamp indica a hora de criação em milissegundos relativamente à origem temporal do ambiente, e não à época Unix. A precisão pode ser reduzida. Estas três propriedades são só de leitura.

Exemplos

const target = new EventTarget();
const event = new Event("ready");
console.log(event.target === null);
target.addEventListener("ready", (e) => {
  console.log(e.type);
  console.log(e.target === target);
  console.log(Number.isFinite(e.timeStamp));
});
target.dispatchEvent(event);

Resultado

true
ready
true
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes