Selenium中是否存在检查页面完全加载的通用方法？

我太懂你这个困扰了——用document.readyState判断页面加载完成确实经常掉链子！它只告诉你DOM树已经构建好了，但很多时候页面上的控件、异步内容（比如AJAX请求返回的数据、动态渲染的组件）还在后台加载，这时候你的代码自然不会等待。

下面分享几个通用的解决方案，能覆盖大部分场景：

1. 结合AJAX状态检查（适用于使用jQuery的网站） #

很多网站用jQuery处理AJAX请求，我们可以同时检查document.readyState和是否有未完成的AJAX请求：

new WebDriverWait(firefoxDriver, pageLoadTimeout).until(webDriver -> {
    JavascriptExecutor js = (JavascriptExecutor) webDriver;
    // 确认DOM树构建完成
    boolean isReadyStateComplete = "complete".equals(js.executeScript("return document.readyState"));
    // 检查是否有pending的AJAX请求（如果页面没有jQuery，直接返回true）
    boolean noPendingAjax = (boolean) js.executeScript("return typeof jQuery !== 'undefined' ? jQuery.active === 0 : true");
    return isReadyStateComplete && noPendingAjax;
});

这个方法能确保页面不仅DOM加载完，所有AJAX请求也都处理完毕。

2. 检查所有资源加载状态（适用于需要静态资源全部就绪的场景） #

如果你的场景需要图片、样式、脚本等所有资源都加载完成，可以利用浏览器的性能API来验证：

new WebDriverWait(firefoxDriver, pageLoadTimeout).until(webDriver -> {
    JavascriptExecutor js = (JavascriptExecutor) webDriver;
    // 先确保readyState是complete
    if (!"complete".equals(js.executeScript("return document.readyState"))) {
        return false;
    }
    // 检查所有资源是否加载完成且没有失败
    return (boolean) js.executeScript("""
        const resources = window.performance.getEntriesByType('resource');
        const allResourcesLoaded = resources.every(resource => resource.responseEnd > 0);
        const noFailedResources = resources.every(resource => 
            resource.responseStatus !== 404 && resource.responseStatus !== 500
        );
        return allResourcesLoaded && noFailedResources;
        """);
});

这个方案会遍历所有已加载的资源，确保它们都成功加载完毕。

3. 等待DOM稳定（通用无依赖方案） #

如果网站用了Vue、React这类前端框架，或者有大量动态渲染内容，我们可以等待DOM在一段时间内没有变化，以此判断页面加载完成：

new WebDriverWait(firefoxDriver, pageLoadTimeout).until(webDriver -> {
    JavascriptExecutor js = (JavascriptExecutor) webDriver;
    // 记录当前DOM的总长度
    long initialDomLength = (long) js.executeScript("return document.documentElement.innerHTML.length");
    // 等待1秒，给动态内容足够的渲染时间
    try {
        Thread.sleep(1000);
    } catch (InterruptedException e) {
        Thread.currentThread().interrupt();
        return false;
    }
    // 再次获取DOM长度，对比是否一致
    long newDomLength = (long) js.executeScript("return document.documentElement.innerHTML.length");
    return initialDomLength == newDomLength;
});

这个思路的核心是：动态内容渲染会改变DOM的长度，当DOM稳定1秒后，就认为所有控件都加载完成了，完全不依赖任何前端框架，通用性拉满。

额外提醒 #

• 没有100%万能的方案，比如单页应用（SPA）的路由切换，document.readyState会一直是complete，这时候你可能需要结合路由变化的监听（比如检查URL变化或特定路由元素的出现）。
• 可以把这些方法封装成工具类，根据不同测试场景灵活调用。
• 如果页面有懒加载内容，记得先滚动页面触发加载，再执行上述检查逻辑。

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