Botium+WebdriverIO中Chrome调用maximizeWindow()未实现报错如何解决

问题原因 #

这个报错是当前使用的浏览器驱动/运行环境不支持maximizeWindow原生API调用，常见于无头模式运行、驱动与浏览器版本不匹配、使用非主流浏览器的场景。

解决方案 #

• 方案1：用显式设置窗口尺寸替代maximizeWindow调用，兼容性最高，修改后代码如下：

module.exports = async (container, browser) => {
    await browser.url(`https://www.orangehrm.com/`);
    // 替换maximizeWindow为手动设置窗口大小，可根据需求调整分辨率
    await browser.setWindowSize(1920, 1080);
    await browser.pause(5000)
}

• 方案2：在浏览器启动参数里直接配置最大化，无需在脚本中调用命令。以Chrome为例，在botium.json的WEBDRIVERIO_OPENBOT配置的capabilities项下添加启动参数：

{
  "capabilities": {
    "goog:chromeOptions": {
      "args": ["--start-maximized"]
    }
  }
}

如果是Edge浏览器，对应参数项为ms:edgeOptions，火狐对应moz:firefoxOptions。

• 方案3：检查浏览器与驱动版本匹配度，保证两者大版本号一致，同时将WebdriverIO升级到最新稳定版，解决版本兼容导致的API缺失问题。
• 方案4：如果当前使用无头模式运行，必须显式设置窗口尺寸，无头模式默认不支持maximizeWindow原生调用。

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