Dispara umEvent para oEventTarget especificado, invocando osEventListeners especificados, em uma ordem apropriada. O processamento normal das regras (incluindo a captura e a fase opcional debubbling) aplica-se a eventos disparados manualmente comdispatchEvent().

Sintaxe

cancelled = !target.dispatchEvent(event)

• event é o objetoEvent a ser disparado.
• target é utilizado para inicializar oEvent.target e determinar quais event listeners serão invocados.
• O valor retornado éfalse se ao menos um dos event handlers o qual manipulou o evento chamouEvent.preventDefault(). De outro modo, isto retornatrue.

O métododispatchEvent jogaUNSPECIFIED_EVENT_TYPE_ERR se o tipo do evento não foi especificado pela inicialização do evento antes do método ser chamado, ou se o tipo do evento for isnull ou uma string vazia. Exceções jogadas por event handlers são reportadas como exceções não-capturáveis; os event handlers são executados em uma callstack aninhada; eles bloqueiam o chamador até que a rotina tenha sido totalmente executada, mas as execeções não se propagam para o chamador.

Notas

dispatchEvent é a última fase do processo create-init-dispatch, a qual é usada para disparar eventos na implementação do event model. O evento pode ser criado utilizando o métododocument.createEvent e pode ser inicializado cominitEvent ou outro método de inicialização mais específico, comoinitMouseEvent ouinitUIEvent.

Veja também areferência Event object.

Exemplo

VejaCreating and triggering events.

Especificações

• DOM Level 2 Events: dispatchEvent