{{ ApiRef("DOM Events") }}
EventTarget
is an interface implemented by objects that can receive events and may have listeners for them.
{{domxref("Element")}}, {{domxref("document")}}, and {{domxref("window")}} are the most common event targets, but other objects can be event targets too, for example {{domxref("XMLHttpRequest")}}, {{domxref("AudioNode")}}, {{domxref("AudioContext")}}, and others.
Many event targets (including elements, documents, and windows) also support setting event handlers via on...
properties and attributes.
Methods
- {{domxref("EventTarget.addEventListener()")}}
- Register an event handler of a specific event type on the
EventTarget
. - {{domxref("EventTarget.removeEventListener()")}}
- Removes an event listener from the
EventTarget
. - {{domxref("EventTarget.dispatchEvent()")}}
- Dispatch an event to this
EventTarget
.
Additional methods for Mozilla chrome code
Mozilla extensions for use by JS-implemented event targets to implement on* properties. See also WebIDL bindings.
- void setEventHandler(DOMString type, EventHandler handler) {{ non-standard_inline() }}
- EventHandler getEventHandler(DOMString type) {{ non-standard_inline() }}
Specifications
Specification | Status | Comment |
---|---|---|
{{SpecName('DOM WHATWG', '#interface-eventtarget', 'EventTarget')}} | {{Spec2('DOM WHATWG')}} | No change. |
{{SpecName('DOM3 Events', 'DOM3-Events.html#interface-EventTarget', 'EventTarget')}} | {{Spec2('DOM3 Events')}} | A few parameters are now optional (listener ), or accepts the null value (useCapture ). |
{{SpecName('DOM2 Events', 'events.html#Events-EventTarget', 'EventTarget')}} | {{Spec2('DOM2 Events')}} | Initial definition. |
Browser compatibility
{{ CompatibilityTable() }}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 1.0 | {{ CompatGeckoDesktop("1") }} | 9.0 | 7 | 1.0 Note: window.EventTarget does not exist |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | 1.0 | {{ CompatGeckoMobile("1") }} | 9.0 | 6.0 | 1.0 |
See Also
- Event reference - the events available in the platform.
- Event developer guide
- {{domxref("Event")}} interface