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

Кратко

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

Синтаксис

cancelled = !target.dispatchEvent(event)

Параметры

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

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

  • Возвращаемое значение — false если хотя бы один из обработчиков этого события вызвал 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.

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

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

 

 

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

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