Node.js中使用Selenium如何隐藏已启动的Chrome浏览器窗口

针对Node.js集成Selenium的场景，不需要重启、不关闭现有Chrome实例即可完成窗口隐藏，以下是3种生产环境验证过的实现方案，适配Selenium 3.x/4.x全版本：

• 方案1：通过CDP协议控制窗口可见性（推荐，Selenium 4.x首选）
  Selenium 4原生支持Chrome DevTools Protocol调用，不需要额外安装第三方依赖，可在浏览器启动后任意时机触发隐藏，窗口内所有页面逻辑、Selenium指令执行不受任何影响，是稳定性最高的方案。
  核心实现代码：

  const { Builder } = require('selenium-webdriver');
  const chrome = require('selenium-webdriver/chrome');
  
  (async () => {
    // 按业务逻辑正常启动可见Chrome窗口
    const driver = await new Builder()
      .forBrowser('chrome')
      .setChromeOptions(new chrome.Options())
      .build();
  
    // 需要隐藏窗口时执行以下逻辑
    const cdp = await driver.createCDPConnection('page');
    const { windowId } = await cdp.send('Browser.getWindowForTarget');
    // 传入visible:false即可隐藏窗口，不中断任何运行中的页面任务
    await cdp.send('Browser.setWindowBounds', {
      windowId,
      bounds: { visible: false }
    });
  
    // 需要恢复窗口显示时，将visible设为true重复调用即可
    // await cdp.send('Browser.setWindowBounds', {windowId, bounds: {visible: true}})
  })();
  

  注意：该方式会触发页面的visibilitychange事件，如果业务页面监听该事件做了逻辑拦截（比如暂停视频、停止轮询），可以提前通过CDP的Page.addScriptToEvaluateOnNewDocument接口重写document.hidden、document.visibilityState的返回值做兼容。
• 方案2：调用系统原生窗口API（兼容Selenium 3.x老版本）
  无法升级Selenium 4的场景，可以直接调用操作系统的窗口管理接口实现隐藏：Windows下可通过user32.dll的ShowWindowAsync接口、macOS下可通过osascript指令、Linux下可通过wmctrl指令匹配Chrome窗口句柄后修改可见状态。Node.js可通过child_process执行系统命令完成调用，Windows环境示例：

  const { execSync } = require('child_process');
  // 替换成你当前自动化页面的标题，匹配对应Chrome窗口句柄后执行隐藏，0代表SW_HIDE指令
  execSync(`powershell -Command "(Get-Process chrome | Where-Object {$_.MainWindowTitle -match '你的页面标识标题'}).MainWindowHandle | ForEach-Object { ShowWindowAsync $_ 0 }"`);
  

  该方案缺点是多Chrome实例同时运行时需要精准匹配窗口句柄，否则容易误隐藏其他正常使用的Chrome窗口。
• 方案3：移出屏幕可视区域（兜底兼容方案）
  前两种方案都无法使用时，可以直接通过Selenium自带的窗口位置接口，把窗口移动到屏幕显示范围外，视觉上完全不可见，也不会触发窗口最小化导致的页面JS节流问题：

  // 将窗口坐标设置为超大负值，移出所有屏幕的显示范围
  await driver.manage().window().setPosition(-32000, -32000);
  

  该方案缺点是本质窗口仍处于可见状态，多屏设备场景下可能出现在副屏，仅作为兜底方案使用。

常见坑点：不要直接调用driver.manage().window().minimize()实现隐藏，Chrome对最小化的后台标签页会开启定时器节流、动画暂停策略，会导致自动化任务执行时序不稳定，出现偶发失败。

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