EventTarget.dispatchEvent()

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

Синтаксис

cancelled = !target.dispatchEvent(event)

Параметры

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

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

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

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

Примечания

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

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

Пример

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

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

Specification
DOM Standard
# ref-for-dom-eventtarget-dispatchevent③

Примечание

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

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

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

Совместимость с браузерами

BCD tables only load in the browser