EventTarget.dispatchEvent()

Кратко

Отправляет событие в общую систему событий. Это событие подчиняется тем же правилам поведения "Захвата" и "Всплывания" как и непосредственно инициированные события.

Синтаксис

cancelled = !target.dispatchEvent(event)

Параметры

• event - объект события, который инициализируется.
• target - используется для инициализации Event.target  и установки события, которое обработчик вызывает.

Возвращаемое Значение

• Возвращаемое значение false если хотя бы один из обработчиков этого события вызовал preventDefault. В ином случае true

Метод dispatchEvent кидает UNSPECIFIED_EVENT_TYPE_ERR если тип событий был не указан инициализировав событие до вызова метода, или если  тип событий является null или пустая строка.Исключения кидают обработчики события представленные как неперехваченные исключения; обработчики события продолжают вложенный стек вызовов: они блокируют вызывающего, пока они не будут выполнены, но исключения не распространняются  на вызывающего

Заметки

dispatchEvent является последним шагом для процесса создание => инициализация => диспетчер, который используется для контроля  событий внутри модели выполнения событий.Событие может быть созданно используя метод  document.createEvent и инициализированно используя initEvent или другой, более конкретный, метод инициализации, такой как initMouseEvent или initUIEvent.

Смотрите также  События

Пример

Для прочтения примера смотрите Создание и инициирование собственных событий .

Спецификация

Примечание

dispatchEvent представляет собой последний шаг в процессе create-init-dispatch, который служит для отправки событий.

Событие может быть создано методом document.createEvent и инициализировано initEvent или, более конкретными инициализирующими методами, такими как initMouseEvent или initUIEvent.

Смотрите также справку по Event object.

Поддержка браузерами