EventTarget.dispatchEvent()

Dispara um Event para o EventTarget especificado, invocando os EventListeners especificados, em uma ordem apropriada. O processamento normal das regras (including the capturing and optional bubbling phase) aplica-se a eventos disparados manualmente com dispatchEvent().

Sintaxe

cancelled = !target.dispatchEvent(event)
  • event √© o objeto Event a ser disparado.
  • target √© utilizado para inicializar o Event.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 chamou Event.preventDefault(). De outro modo, isto retorna true.

O m√©todo dispatchEvent joga UNSPECIFIED_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 is null 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√©todo document.createEvent e pode ser inicializado com initEvent ou outro m√©todo de inicializa√ß√£o mais espec√≠fico, como initMouseEvent ou initUIEvent.

Veja também a referência Event object.

Exemplo

Especifica√ß√Ķes