CKTIS / JavaScript
Event.target i nasłuchiwanie w fazie przechwytywania
Odróżnij cel zdarzenia od obiektu, na którym działa nasłuchiwacz, i sprawdź, jak opcja `capture` wpływa na kolejność wywołań w DOM.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
event.target
event.currentTarget
event.eventPhase
node.addEventListener(type, listener, { capture: true })
node.addEventListener(type, listener, true)
node.addEventListener(type, listener)event.target wskazuje cel zdarzenia widoczny dla nasłuchiwacza, a event.currentTarget — obiekt, na którym zarejestrowano właśnie wykonywany nasłuchiwacz. Obie właściwości są tylko do odczytu. Poza wykonywaniem nasłuchiwacza currentTarget ma wartość null; jeśli obiekt będzie potrzebny później, zapisz go w trakcie wywołania.
W zwykłym drzewie DOM zdarzenie najpierw przechodzi przez przodków w kierunku celu. W tej fazie (Event.CAPTURING_PHASE, 1) działają nasłuchiwacze zarejestrowane przez addEventListener() z { capture: true } albo z true jako trzecim argumentem. capture domyślnie ma wartość false.
Na samym celu nasłuchiwacze z capture: true działają przed tymi z capture: false, ale obie grupy odczytują tę samą wartość event.eventPhase: Event.AT_TARGET (2). Potem, tylko jeśli event.bubbles ma wartość true, zdarzenie wraca przez przodków w odwrotnej kolejności (Event.BUBBLING_PHASE, 3), uruchamiając ich nasłuchiwacze bez przechwytywania. Brak bąbelkowania nie wyłącza przechwytywania ani obsługi na celu.
To API DOM, nie część ECMAScript. W zwykłym drzewie target nie zmienia się podczas propagacji; po przekroczeniu granicy Shadow DOM może jednak wskazywać element hosta zamiast węzła wewnętrznego.
Przykłady
(() => {
// Node.js has no DOM tree. This fallback models only the propagation used here.
class DemoNode {
#parent = null;
#listeners = [];
append(child) {
child.#parent = this;
}
addEventListener(type, listener, options) {
const capture = options === true || options?.capture === true;
this.#listeners.push({ type, listener, capture });
}
dispatchEvent(event) {
const ancestors = [];
for (let node = this.#parent; node !== null; node = node.#parent) {
ancestors.push(node);
}
let currentTarget = null;
let phase = Event.NONE;
Object.defineProperties(event, {
target: { configurable: true, get: () => this },
currentTarget: { configurable: true, get: () => currentTarget },
eventPhase: { configurable: true, get: () => phase }
});
const invoke = (node, nextPhase, capture) => {
currentTarget = node;
phase = nextPhase;
for (const entry of node.#listeners.slice()) {
if (entry.type === event.type && entry.capture === capture) {
entry.listener.call(node, event);
}
}
};
try {
for (let i = ancestors.length - 1; i >= 0; i--) {
invoke(ancestors[i], Event.CAPTURING_PHASE, true);
}
invoke(this, Event.AT_TARGET, true);
invoke(this, Event.AT_TARGET, false);
if (event.bubbles) {
for (const node of ancestors) {
invoke(node, Event.BUBBLING_PHASE, false);
}
}
} finally {
currentTarget = null;
phase = Event.NONE;
}
return !event.defaultPrevented;
}
}
const createElement = (tag) =>
typeof document === 'undefined' ? new DemoNode() : document.createElement(tag);
const parent = createElement('div');
const child = createElement('button');
parent.id = 'parent';
child.id = 'child';
parent.append(child);
const report = (label) => (event) => {
console.log(`${label}: target=${event.target.id}, currentTarget=${event.currentTarget.id}, phase=${event.eventPhase}`);
};
parent.addEventListener('demo', report('parent bubble'));
child.addEventListener('demo', report('child non-capture'));
parent.addEventListener('demo', report('parent capture'), { capture: true });
child.addEventListener('demo', report('child capture'), { capture: true });
child.dispatchEvent(new Event('demo', { bubbles: true }));
})();Wynik
parent capture: target=child, currentTarget=parent, phase=1 child capture: target=child, currentTarget=child, phase=2 child non-capture: target=child, currentTarget=child, phase=2 parent bubble: target=child, currentTarget=parent, phase=3
Uruchom kod w konsoli przeglądarki. Elementy nie są dołączane do dokumentu, a `dispatchEvent()` wywołuje nasłuchiwacze synchronicznie. W Node.js kod korzysta z uproszczonego modelu propagacji zamiast z DOM przeglądarki. Po zmianie `bubbles` na `false` zniknie tylko ostatni wiersz.
Powiązane lekcje
- JavaScript · Lekcja 40 · Średniozaawansowany · Wersja: 3