shadow dom 不提升测试效率反而降低，因其阻断常规定位；需通过双重判空+显式等待、分步处理嵌套shadow、统一data属性和open模式来保障稳定。
Shadow DOM 本身不提升测试效率，反而会降低——它天然阻断常规定位，让 find_element、cy.get()、page.locator() 全部失效。所谓“提升效率”，实际是指：在已使用 Shadow DOM 的项目中，如何用最少的适配成本让测试脚本能稳定跑通。
为什么直接写 shadowRoot.querySelector 容易出错
很多人复制 Chrome DevTools 的 “Copy JS Path” 后直接塞进 execute_script，结果频繁报 TypeError: Cannot read property 'querySelector' of null。根本原因不是语法错，而是没处理两层空值：
-
document.querySelector("wujie-app")返回 null（宿主元素还没加载） - 宿主元素存在，但
.shadowRoot为 null（Shadow DOM 尚未 attach，比如 mode='closed' 或动态创建中）
正确做法是加双重判空 + 显式等待：
js = """
host = document.querySelector("wujie-app");
if (!host) throw new Error("Host not found");
root = host.shadowRoot;
if (!root) throw new Error("Shadow root not ready");
root.querySelector("button.submit")
"""
element = driver.execute_script(f"return {js}")
Playwright 中用 locator.shadow() 前必须确认宿主可交互
Playwright 的 locator.shadow() 看似简洁，但它不自动等待 Shadow Root 出现。如果宿主元素是懒加载的（比如通过 IntersectionObserver 触发），直接链式调用会失败：
- 错误写法：
page.locator("my-datepicker").shadow().locator("input").fill("2026-07-01") - 正确顺序：先等宿主可见且可点击，再进 shadow：
await page.locator("my-datepicker").waitFor({ state: "visible" }); await page.locator("my-datepicker").click(); // 触发 shadow attach await page.locator("my-datepicker").shadow().locator("input").fill("2026-07-01");
Cypress 的 .shadow() 不支持嵌套穿透
当组件 A 包含组件 B，B 又带自己的 Shadow DOM（即多层 shadow-root），Cypress 的 .shadow() 只能穿透一层。例如：
-
cy.get("app-shell").shadow().get("user-form")可行 -
cy.get("app-shell").shadow().get("user-form").shadow().get("input[name=phone]")会报错 —— 第二个.shadow()找不到上下文 - 必须拆成两步，并显式保存中间 locator：
const form = cy.get("app-shell").shadow().get("user-form"); form.shadow().get("input[name=phone]").type("138****1234");
真正影响效率的从来不是 Shadow DOM 本身，而是团队是否统一了宿主元素的 data 属性命名、是否暴露了稳定的 shadow-host 标识（比如强制用 data-testid="date-picker-host"），以及是否把 shadow-root 的 mode 统一设为 open。closed 模式下，连 shadowRoot 属性都不可读，所有自动化方案都得绕道组件提供的 JS API —— 那已经不是 DOM 层面的问题了。
