Puppeteer如何在运行过程中动态设置浏览器窗口位置

Puppeteer 支持在程序运行过程中动态移动浏览器窗口位置，完全可以实现 Selenium 中driver.set_window_position(-10000, 0)的等效效果，无需在浏览器启动阶段通过启动参数固定位置。

实现方法 #

通用兼容方案（所有Puppeteer版本适用） #

通过 Chrome DevTools Protocol（CDP）提供的Browser.setWindowBounds接口实现，可在浏览器运行的任意阶段调用，即时生效：

// 1. 初始化CDP会话
const cdpSession = await page.target().createCDPSession();
// 2. 获取当前浏览器主窗口ID
const browserTarget = await page.browser().waitForTarget(t => t.type() === 'browser');
const windowId = browserTarget.windowId;
// 3. 动态设置窗口位置
await cdpSession.send('Browser.setWindowBounds', {
  windowId,
  bounds: {
    left: -10000, // 对应Selenium接口的x轴坐标
    top: 0,       // 对应Selenium接口的y轴坐标
    windowState: 'normal' // 若窗口处于最大化/最小化/全屏状态，必须先设为常规模式才能调整位置
  }
});

注意：如果不需要修改窗口尺寸，bounds参数里无需传入width、height字段，窗口会保留原有大小仅移动位置。

高版本简化写法（Puppeteer v19.0.0及以上支持） #

高版本Puppeteer封装了窗口操作的原生方法，无需手动创建CDP会话即可直接调用：

// 直接调用窗口实例的setBounds方法即可动态调整位置
await page.browserWindow().setBounds({
  left: -10000,
  top: 0
});

注意事项 #

• 所有位置调整接口均为运行时生效，不需要重启浏览器，可在自动化流程的任意节点按需调用
• 位置调整仅在有头模式（启动配置中设置headless: false）下有实际视觉效果；无头模式无实体窗口外壳，调用接口不会报错但不会产生可见的窗口位移
• 调整位置前请确保窗口处于常规状态，最大化、最小化、全屏状态下直接设置坐标不会生效

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