Event

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..

ИнтерфейсEvent представляет собой любое событие, которое происходит вDOM; некоторые из них генерируемые пользователем (клик мышью или нажатие клавиши на клавиатуре), а некоторые - генерируемые API (события, обозначающие завершение процесса анимации, приостановка видео и т.д.). Существует много типов событий, некоторые из них используют интерфейсы, базирующиеся на главном интерфейсеEvent.Event содержит общие свойства и методы для всех событий.

Интерфейсы, основанные на`Event`

Ниже приведён список интерфейсов, основанных на главном интерфейсеEvent, а также указаны ссылки на них в документации MDN API. Заметьте, что имена всех интерфейсов оканчиваются на "Event".

Конструктор

Event(): Создаёт объектEvent и возвращает его вызывающему.

Свойства

Event.bubblesТолько для чтения: Логическое значение, указывающее, всплыло ли событие вверх по DOM или нет.
Event.cancelBubble: Историческое название синонимаEvent.stopPropagation(). Если установить значение вtrue до возврата из обработчика события (Event Handler), то событие не будет распространяться дальше (например, на обработчики для родительских узлов).
Event.cancelableТолько для чтения: Логическое значение, показывающее возможность отмены события.
Event.composedТолько для чтения: Логическое значение, показывающее может или нет событие всплывать через границы между shadow DOM (внутренний DOM конкретного элемента) и обычного DOM документа.
Event.currentTargetТолько для чтения: Ссылка на текущий зарегистрированный объект, на котором обрабатывается событие. Это объект, которому планируется отправка события; поведение можно изменить с использованием перенаправления (retargeting).
Event.deepPathНе стандартно: Массив DOM-узлов, через которые всплывало событие.
Event.defaultPreventedТолько для чтения: Показывает, была ли для события вызвана функцияevent.preventDefault().
Event.eventPhaseТолько для чтения: Указывает фазу процесса обработки события.
Event.explicitOriginalTargetНе стандартноТолько для чтения: Явный первоначальный целевой объект события (Mozilla-специфичный). Не может содержать анонимного контента.
Event.originalTargetНе стандартноТолько для чтения: Первоначальный целевой объект события до перенаправлений (Mozilla-специфичный). Может быть из анонимного контента.
Event.returnValueНе стандартно: Нестандартная альтернатива (оставшаяся от старых версий Microsoft Internet Explorer) для Event.preventDefault() иEvent.defaultPrevented.
Event.scopedТолько для чтения: Логическое значение, показывающее всплывает ли данное событие через shadow root (внутренний DOM-элемента). Это свойство было переименовано вcomposed.
Event.srcElementНе стандартно: Нестандартный синоним (остался от старых версий Microsoft Internet Explorer) для Event.target.
Event.targetТолько для чтения: Ссылка на целевой объект, на котором произошло событие.
Event.timeStampТолько для чтения: Время, когда событие было создано (в миллисекундах). По спецификации это время от начала Эпохи (Unix Epoch), но в действительности в разных браузерах определяется по-разному; кроме того, ведётся работа по изменению его наDOMHighResTimeStamp тип.
Event.typeТолько для чтения: Название события (без учёта регистра символов).
Event.isTrustedТолько для чтения: Показывает было или нет событие инициировано браузером (например, по клику мышью) или из скрипта (например, через функцию создания события, такую какevent.initEvent)