EventTarget

EventTarget — это интерфейс DOM, реализуемый объектами, которые могут получать события и иметь обработчики для них.

class EventTarget {

addEventListener(
type: string,

listener: EventListenerOrEventListenerObject | null,

options?: boolean | AddEventListenerOptions,
): void;

dispatchEvent(event: Event): boolean;

removeEventListener(
type: string,

callback: EventListenerOrEventListenerObject | null,

options?: EventListenerOptions | boolean,
): void;
}

Методы

addEventListener(type: string, listener: EventListenerOrEventListenerObject | null, options?: boolean | AddEventListenerOptions): void

Добавляет обработчик событий для событий, значение атрибута типа которых равно type. Аргумент callback устанавливает обратный вызов, который будет вызван при обработке события.

Аргумент options устанавливает параметры, специфичные для обработчика. Для совместимости он может быть булевым значением, в этом случае метод ведет себя так, как если бы значение было указано в options' capture.

Если установлено в true, options' capture предотвращает вызов callback, когда значение атрибута eventPhase события равно BUBBLING_PHASE. Если false (или отсутствует), callback не будет вызван, когда значение атрибута eventPhase события равно CAPTURING_PHASE. В любом случае callback будет вызван, если значение атрибута eventPhase события равно AT_TARGET.

Если установлено в true, options' passive указывает, что обратный вызов не будет отменять событие, вызывая preventDefault(). Это используется для включения оптимизаций производительности, описанных в § 2.8 Наблюдение за обработчиками событий.

Если установлено в true, options' once указывает, что обратный вызов будет вызван только один раз, после чего обработчик события будет удален.

Обработчик события добавляется в список обработчиков событий target и не добавляется, если у него есть тот же тип, обратный вызов и capture.

dispatchEvent(event: Event): boolean

Отправляет синтетическое событие event объекту target и возвращает true, если атрибут cancelable события имеет значение false или его метод preventDefault() не был вызван, и false в противном случае.

removeEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean): void

Удаляет обработчик события в списке обработчиков событий target с тем же типом, обратным вызовом и параметрами.