Event: currentTarget property
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.
Note: This feature is available in Web Workers.
The currentTarget read-only property of the Event interface identifies the element to which the event handler has been attached.
This will not always be the same as the element on which the event was fired, because the event may have fired on a descendant of the element with the handler, and then bubbled up to the element with the handler. The element on which the event was fired is given by Event.target.
Note that the value of currentTarget is only available in a handler for the event. Outside an event handler it will be null. This means that, for example, if you take a reference to the Event object inside an event handler and then access its currentTarget property outside the event handler, its value will be null.
Value
An EventTarget representing the object to which the current event handler is attached.
Examples
currentTarget versus target
This example illustrates the difference between currentTarget and target.
HTML
The page has a "parent" <div> containing a "child" <div>.
<div id="parent">
Click parent
<div id="child">Click child</div>
</div>
<button id="reset">Reset</button>
<pre id="output"></pre>
JavaScript
The event handler is attached to the parent. It logs the value of event.currentTarget and event.target.
We also have a "Reset" button that just reloads the example.
const output = document.querySelector("#output");
const parent = document.querySelector("#parent");
parent.addEventListener("click", (event) => {
const currentTarget = event.currentTarget.getAttribute("id");
const target = event.target.getAttribute("id");
output.textContent = `Current target: ${currentTarget}\n`;
output.textContent += `Target: ${target}`;
});
const reset = document.querySelector("#reset");
reset.addEventListener("click", () => document.location.reload());
Result
If you click inside the child <div>, then target identifies the child. If you click inside the parent <div>, then target identifies the parent.
In both cases, currentTarget identifies the parent, because that's the element that the handler is attached to.
Specifications
| Specification |
|---|
| DOM # ref-for-dom-event-currenttarget② |
Browser compatibility
Loading…