ChromeDriver128用stalenessOf正常，升级132后报错，根<html>元素应失效吗？

问题背景 #

以下代码在ChromeDriver 128版本中可正常运行：

WebElement element = // 定位根<html>元素

// 点击按钮触发AJAX请求后跳转到新页面

wait.until(ExpectedConditions.stalenessOf(element))

升级至ChromeDriver 132版本后，出现如下错误：

org.openqa.selenium.WebDriverException: unknown error: unhandled inspector error: {"code":-32000,"message":"Node with given id does not belong to the document"}
  (Session info: chrome=132.0.6834.160)

at java.base@11.0.18/jdk.internal.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
    at java.base@11.0.18/jdk.internal.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:62)
    at java.base@11.0.18/jdk.internal.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)
    at java.base@11.0.18/java.lang.reflect.Constructor.newInstance(Constructor.java:490)
    at app//org.openqa.selenium.remote.http.W3CHttpResponseCodec.createException(W3CHttpResponseCodec.java:187)
    at app//org.openqa.selenium.remote.http.W3CHttpResponseCodec.decode(W3CHttpResponseCodec.java:122)
    at app//org.openqa.selenium.remote.http.W3CHttpResponseCodec.decode(W3CHttpResponseCodec.java:49)
    at app//org.openqa.selenium.remote.HttpCommandExecutor.execute(HttpCommandExecutor.java:158)
    at app//org.openqa.selenium.remote.service.DriverCommandExecutor.execute(DriverCommandExecutor.java:83)
    at app//org.openqa.selenium.remote.RemoteWebDriver.execute(RemoteWebDriver.java:552)
    at app//org.openqa.selenium.remote.RemoteWebElement.execute(RemoteWebElement.java:285)
    at app//org.openqa.selenium.remote.RemoteWebElement.isEnabled(RemoteWebElement.java:156)
    at app//org.openqa.selenium.support.ui.ExpectedConditions$24.apply(ExpectedConditions.java:700)
    at app//org.openqa.selenium.support.ui.ExpectedConditions$24.apply(ExpectedConditions.java:695)
    at app//org.openqa.selenium.support.ui.FluentWait.until(FluentWait.java:249)

核心疑问：指向根<html>的元素是否应该变为失效（stale）状态？

解答 #

1. 根<html>元素在页面跳转后确实会进入stale状态 #

当页面完成跳转后，浏览器会销毁原有DOM树并加载新页面资源，原<html>元素不再属于当前文档的DOM结构，理论上应被标记为stale元素。

2. 报错原因分析 #

从错误栈可见，stalenessOf方法底层调用了isEnabled()判断元素状态。ChromeDriver 132版本对元素状态检查逻辑做了更新：当元素已不属于当前文档时，直接抛出"Node with given id does not belong to the document"异常，而非旧版本那样返回true表示元素已stale。

3. 解决方案 #

针对该问题，可采用以下替代方案：

• 自定义等待条件：手动捕获元素操作异常判断元素是否stale：

wait.until(driver -> {
    try {
        // 执行无副作用的元素操作
        element.isDisplayed();
        return false; // 元素仍可用，继续等待
    } catch (StaleElementReferenceException | WebDriverException e) {
        return true; // 元素已失效，结束等待
    }
});

• 更换判断元素：避免使用根<html>元素，改用页面内唯一固定元素（如主容器、导航栏等）判断staleness，这类元素的状态检查逻辑更稳定。

• 直接等待新页面特征：跳过等待旧元素失效，直接等待新页面的标志性元素出现，更符合页面跳转后的实际验证需求。

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