event.composedpath() 返回事件实际经过的完整节点路径，包括跨 shadow boundary 的所有节点，但仅当事件为 composed: true 时才包含宿主外祖先；原生事件（如 click、input）默认可穿透，自定义事件需显式设置 composed: true 才能完整返回路径。
Event.composedPath() 在 Shadow DOM 中到底返回什么
它返回的是事件实际经过的完整节点路径，包括跨 Shadow Boundary 的元素——但前提是事件本身是 composed: true 的。原生如 click、input、keydown 默认就是 composed: true，所以能穿透；而自定义事件默认 composed: false，调用 composedPath() 会停在 Shadow Root 处，不会包含宿主外的父节点。
验证方法很简单：在 Shadow DOM 内部监听点击，打印路径：
shadowRoot.addEventListener('click', (e) => {
console.log(e.composedPath());
});
你会看到数组里从触发目标开始，依次包含 shadowRoot、宿主元素（比如 <my-editor></my-editor>）、、……直到 Document。
HTML 编辑器中监听外层容器的编辑事件为什么失效
常见错误是直接在编辑器宿主元素（如 <rich-text-editor></rich-text-editor>）上监听 input 或 blur，但这些事件根本不会冒泡到宿主——因为它们发生在 Shadow DOM 内部的 <div contenteditable> 上，而 <code>contenteditable 触发的 input 事件默认可穿透，但宿主若没监听，或监听了却没检查路径，就收不到。
- ✅ 正确做法：在宿主元素上监听，然后用
e.composedPath()判断事件是否来自内部可编辑区域 - ❌ 错误做法：只监听
shadowRoot.querySelector('[contenteditable]').addEventListener('input', ...)，这会让外部无法响应 - ⚠️ 注意：
focus/blur不冒泡（即使composed: true），必须用focusin/focusout替代
如何用 composedPath() 精准识别编辑器内的目标节点
不能只看 e.target，它可能是 Shadow DOM 内部的文本节点或 <span></span>，对宿主逻辑无意义；e.composedPath()[0] 才是原始触发点，结合 instanceof Text 或 nodeName 可做语义判断。
例如过滤出真实用户输入位置：
host.addEventListener('input', (e) => {
const path = e.composedPath();
const target = path[0];
if (target instanceof Text && target.parentElement?.closest('[contenteditable]')) {
console.log('用户在编辑器内输入了文字');
}
});
-
e.composedPath()第一项永远是原始事件目标，比e.target更可靠 - 用
closest('[contenteditable]')向上查，比硬写shadowRoot.host更健壮（兼容 open/closed mode） - 避免用
path.includes(host)判定是否来自内部——路径一定含宿主，这条件恒真
IE/Edge Legacy 和 Safari 15.2 之前的兼容性坑
Event.composedPath() 在 Safari ≤15.2、旧版 Edge（EdgeHTML）和 IE 中完全不支持，返回 undefined。不能假设它存在。
- 安全写法：先检测
typeof e.composedPath === 'function'，否则回退到[e.target]+ 手动向上遍历parentNode - 注意：Shadow DOM v1 的
shadowRoot.host在 closed mode 下不可读，所以不能靠它补全路径 - 如果项目需兼容 Safari 15.1 及更早，建议封装一个
getComposedPath(e)工具函数，内部做 UA 判断或特性检测，而非全局 polyfill
真正麻烦的不是 API 缺失，而是不同浏览器对「哪些原生事件默认 composed」的实现有细微差异——比如某些安卓 WebView 中 compositionend 不穿透，得手动 dispatch 一次 composed: true 的自定义事件兜底。
