EventTarget.dispatchEvent()

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

Синтаксис

cancelled = !target.dispatchEvent(event)

Параметры

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

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

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

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

Заметки

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

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

Пример

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

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

Описание Статус Комментарий
DOM
Определение 'EventTarget.dispatchEvent()' в этой спецификации.
Живой стандарт
DOM4
Определение 'EventTarget.dispatchEvent()' в этой спецификации.
Устаревшая
Document Object Model (DOM) Level 2 Events Specification
Определение 'EventTarget.dispatchEvent()' в этой спецификации.
Устаревшая Начальное определение.

Примечание

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

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

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

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

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung Internet
dispatchEventChrome Полная поддержка 4Edge Полная поддержка 12Firefox Полная поддержка 2IE Полная поддержка 9
Полная поддержка 9
Нет поддержки 6 — 11
Замечания Альтернативное имя
Замечания Older versions of IE supported an equivalent, proprietary EventTarget.fireEvent() method.
Альтернативное имя Использует нестандартное имя: fireEvent
Opera Полная поддержка 9Safari Полная поддержка 3.2WebView Android Полная поддержка 4Chrome Android Полная поддержка 18Firefox Android Полная поддержка 4Opera Android Полная поддержка ДаSafari iOS Полная поддержка ДаSamsung Internet Android Полная поддержка Да

Легенда

Полная поддержка  
Полная поддержка
Смотрите замечания реализации.
Смотрите замечания реализации.
Использует нестандартное имя.
Использует нестандартное имя.