Selenium-Java+TestNG无法定位#shadow-root(user-agent)内元素求助

我用Selenium-Java结合TestNG做网页自动化测试，页面里有个默认值为Please Select的Timezone下拉菜单，需要定位#shadow-root(user-agent)下<div aria-hidden="true">Please Select</div>里的文本，但多次尝试都失败了：

尝试过的方法及报错 #

1. 执行以下代码时，抛出org.openqa.selenium.NoSuchShadowRootException: no such shadow root异常：

WebElement element = driver.findElement(By.id("timezone"));
WebElement shadowRoot1 = (WebElement) ((JavascriptExecutor)driver).executeScript("return arguments[0].shadowRoot", element);
String text = shadowRoot1.findElement(By.cssSelector("div")).getText();
System.out.println(text);

2. 用getShadowRoot()方法定位元素时，同样抛出上述异常。

相关截图说明 #

• HTML结构截图：展示Timezone元素及嵌套的user-agent shadow root结构
• 网站页面截图：显示Timezone下拉菜单的默认状态
• 调试截图：展示元素的调试信息

报错原因 #

#shadow-root(user-agent)是浏览器原生的user-agent shadow DOM，和开发者创建的普通open shadow DOM不同，Selenium标准API（包括getShadowRoot()和JS获取shadowRoot属性）无法直接访问——浏览器限制了外部脚本对原生组件shadow DOM的访问权限。

可行解决方法 #

方法1：直接通过JS获取文本

绕过shadow root的访问限制，用JS直接查询原生组件内部文本：

String timezoneText = (String) ((JavascriptExecutor) driver).executeScript(
    "return document.querySelector('#timezone').shadowRoot.querySelector('div[aria-hidden=\"true\"]').textContent;"
);
System.out.println(timezoneText);

如果上述代码报错，试试兼容写法：

String timezoneText = (String) ((JavascriptExecutor) driver).executeScript(
    "const element = document.getElementById('timezone'); " +
    "return element.shadowRoot ? element.shadowRoot.querySelector('div[aria-hidden=\"true\"]').textContent : '';"
);

方法2：定位可见文本或宿主元素属性

如果Please Select是页面可见文本，或原生组件会把选中值同步到宿主元素属性，可直接获取：

// 尝试获取宿主元素的value属性
WebElement timezoneElement = driver.findElement(By.id("timezone"));
String visibleText = timezoneElement.getAttribute("value");

// 或直接通过文本定位元素
WebElement selectedTextElement = driver.findElement(By.xpath("//*[text()='Please Select']"));
System.out.println(selectedTextElement.getText());

方法3：使用Chrome DevTools协议（CDP）

针对Chrome浏览器，可通过CDP突破原生shadow DOM的访问限制：

ChromeDriver driver = (ChromeDriver) yourWebDriverInstance;
// 启用DOM调试
driver.executeCdpCommand("DOM.enable", new HashMap<>());

// 获取Timezone元素的节点ID
Map<String, Object> queryHostParams = new HashMap<>();
queryHostParams.put("selector", "#timezone");
Map<String, Object> hostNode = driver.executeCdpCommand("DOM.querySelector", queryHostParams);
int hostNodeId = (int) hostNode.get("nodeId");

// 获取shadow root的ID
Map<String, Object> getShadowParams = new HashMap<>();
getShadowParams.put("nodeId", hostNodeId);
Map<String, Object> shadowRoot = driver.executeCdpCommand("DOM.getShadowRoot", getShadowParams);
int shadowRootId = (int) shadowRoot.get("shadowRootId");

// 在shadow root内查询目标元素
Map<String, Object> queryShadowParams = new HashMap<>();
queryShadowParams.put("shadowRootId", shadowRootId);
queryShadowParams.put("selector", "div[aria-hidden='true']");
Map<String, Object> targetNode = driver.executeCdpCommand("DOM.querySelector", queryShadowParams);
int targetNodeId = (int) targetNode.get("nodeId");

// 获取元素文本
Map<String, Object> getHtmlParams = new HashMap<>();
getHtmlParams.put("nodeId", targetNodeId);
Map<String, Object> htmlResult = driver.executeCdpCommand("DOM.getOuterHTML", getHtmlParams);
String outerHtml = (String) htmlResult.get("outerHTML");
String targetText = outerHtml.replaceAll("<[^>]+>", "").trim();
System.out.println(targetText);

// 关闭DOM调试
driver.executeCdpCommand("DOM.disable", new HashMap<>());

注意事项 #

• 不同浏览器对原生shadow DOM的访问限制有差异，Chrome的CDP方法兼容性最优
• 若为自定义组件而非浏览器原生组件，需确认shadow root为open模式（closed模式无法外部访问）

内容的提问来源于stack exchange，提问作者Dhanush S