All Production Symptoms
Production Symptom3 Causal Mechanisms

Click handler fires on the wrong element or misses Shadow DOM target

Capture, bubbling, and Shadow DOM event retargeting alter event.target versus event.currentTarget along the composed path.

DevTools / RUM Signature
event.target !== event.currentTarget; Shadow DOM event.target retargeted to host element outside shadow root

Causal Chain of Browser Mechanisms

Ordered from trigger to root invariant. Open any mechanism to inspect its internals or reproduce the behavior in an interactive lab.

Step 1
DOM & EventsBaseline · Widely

Three-phase DOM event traversal from window to target and back, enabling single-listener delegation on common ancestors.

Step 2
DOM & EventsBaseline · Widely

Isolate component CSS and DOM trees without iframes—Shadow DOM blocks outer selectors, projects light DOM via <slot>, and retargets bubbling events to the host.

Step 3
DOM & EventsBaseline · Widely

Stop mobile browser scroll from hijacking custom drags and sliders—CSS touch-action negotiates gesture ownership on the compositor while setPointerCapture() locks fast pointer streams.

Seen in Architecture Autopsies