如何在WebdriverIO中实现页面整体加载等待？

当然可以！WebdriverIO 里完全有对应你提到的 Java 两种思路的页面加载等待方案，下面给你逐一说明：

1. 主动检查 document.readyState（对应 Java 执行 executeScript 的方式） #

你可以用 browser.waitUntil 结合 browser.execute 来主动轮询页面的就绪状态，直到它变为 complete，和你在 Java 里的实现思路一致：

await browser.waitUntil(
  async () => {
    // 执行JS获取页面就绪状态
    const readyState = await browser.execute(() => document.readyState);
    // 当状态为complete时结束等待
    return readyState === 'complete';
  },
  {
    timeout: 10000, // 超时时间设置为10秒（和你Java里的配置对应）
    timeoutMsg: '页面加载超时，未达到complete状态' // 超时提示信息
  }
);

这种方式的好处是可以自定义等待逻辑，比如你也可以检查 interactive 状态（页面可交互但资源还在加载），根据需求调整返回条件。

2. 设置页面加载超时时间（对应 Java 的 pageLoadTimeout） #

WebdriverIO 支持直接配置页面加载的超时时间，有两种方式：

方式一：在配置文件中全局设置 #

在你的 wdio.conf.js 配置文件里，给 capabilities 添加 pageLoadTimeout 参数：

exports.config = {
  // 其他基础配置...
  capabilities: [{
    browserName: 'chrome',
    // 配置页面加载超时为10秒
    pageLoadTimeout: 10000
  }]
};

方式二：在测试用例中动态设置 #

如果需要针对某个测试用例单独调整超时时间，可以用 browser.setTimeout 动态修改：

// 设置当前会话的页面加载超时为10秒
await browser.setTimeout({ pageLoad: 10000 });

设置后，当页面在指定时间内未完成加载（即 document.readyState 未变为 complete），WebdriverIO 会直接抛出超时错误，和 Java 里的 pageLoadTimeout 行为一致。

补充说明 #

默认情况下，WebdriverIO 调用 browser.url() 导航页面时，会自动等待页面的 document.readyState 变为 complete 才继续执行后续命令。但如果你的页面有大量异步加载的内容（比如接口请求、动态渲染的组件），仅等待初始页面加载可能不够，这时候可以结合等待关键元素出现的方式，但如果只是需要等待页面的基础加载完成，上面两种方法就完全满足需求了。

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