Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

Кратко

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

Синтаксис

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.

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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Особенность Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Базовая поддержка 4 2 9 [1] 9.64  3.2 
Особенность Android Firefox Mobile (Gecko) IE Phone Opera Mobile
Базовая поддержка ? ? ? ?
 

 

 

Метки документа и участники

Внесли вклад в эту страницу: vetraz, mdnwebdocs-bot, bagau, zhitkovkostya, Taimayr, DzmVasileusky, FeelUs, fscholz, soumya, teoli, anton1500m
Обновлялась последний раз: vetraz,