EventTarget: метод dispatchEvent()

Базовая Широко поддерживается

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Примечание: Эта функция доступна в Web Workers.

Метод dispatchEvent() объекта EventTarget отправляет Event объекту, (синхронно) вызывая соответствующие обработчики событий в нужном порядке. Обычные правила обработки событий (включая фазы захвата и, при необходимости, фазы всплытия) также применяются к событиям, отправленным вручную с помощью dispatchEvent().

Вызов dispatchEvent() является последним шагом для вызова события. Событие должно быть создано и инициализировано с помощью конструктора Event().

Примечание: При вызове этого метода свойство Event.target инициализируется текущим EventTarget.

В отличие от "родных" событий, которые вызываются браузером и вызывают обработчики событий асинхронно через цикл событий, dispatchEvent() вызывает обработчики событий синхронно. Все соответствующие обработчики событий вызываются и возвращают значение, прежде чем dispatchEvent() вернёт значение.

Синтаксис

dispatchEvent(event)

Параметры

event: Объект Event, который необходимо отправить. Его свойство Event.target будет установлено в текущий объект EventTarget.

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

false , если event является отменяемым, и по крайней мере один из обработчиков событий, получивших event , вызвал Event.preventDefault(). В противном случае true.

Исключения

InvalidStateError DomException: Выбрасывается, если тип события не был указан во время инициализации события.

Предупреждение: Исключение, выброшенное обработчиками событий, отображается как необработанное исключение. Обработчики событий выполняются вложенном стеке вызовов; они блокируют вызывающую функцию до завершения, но исключения не распространяются на вызывающую функцию.

Пример

См. Создание и вызов событий.

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

Спецификация
DOM # ref-for-dom-eventtarget-dispatchevent③

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`dispatchEvent`	4	12	2	9	3.1	18	4	10.1	3	1.0	4

См. также

Ссылка на объект события

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/dispatchEvent