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

Синтаксис

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.

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

Пример

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

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

Примечание

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

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

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

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