EventTarget.dispatchEvent()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

Синтаксис

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.

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

Пример

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

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

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

Примечание

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

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

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

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
dispatchEvent

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support