Puppeteer同上下文场景下多窗口（非标签页）识别处理问题咨询

Puppeteer 没有单独的窗口实体概念，所有标签页、手动拖出产生的新窗口，本质上都属于同一浏览器实例下的Page对象，天然共享用户配置、Cookie、缓存等上下文，无需启动多实例。你可以通过以下方案实现和 Selenium getWindowHandle 完全等价的能力：

1. 捕获新创建的窗口 #

手动触发的新窗口、页面弹窗生成的新窗口都会触发browser实例的targetcreated事件，你可以通过监听该事件维护所有窗口的句柄映射：

const puppeteer = require('puppeteer');

(async () => {
  // 启动浏览器时指定固定用户配置路径
  const browser = await puppeteer.launch({
    headless: false,
    userDataDir: '/your/custom/user/data/path', // 替换为实际用户配置目录
    defaultViewport: null // 关闭默认视图限制，匹配窗口实际大小
  });

  // 存储窗口句柄映射，等价于Selenium的windowHandles集合
  const windowHandles = new Map();

  // 初始化已存在的页面/窗口
  const existPages = await browser.pages();
  for (let i = 0; i < existPages.length; i++) {
    const windowId = await getWindowIdForPage(existPages[i]);
    windowHandles.set(windowId, existPages[i]);
  }

  // 监听新窗口创建事件
  browser.on('targetcreated', async (target) => {
    // 过滤页面类型的target，排除扩展、后台请求等无关资源
    if (target.type() !== 'page') return;
    const newPage = await target.page();
    const windowId = await getWindowIdForPage(newPage);
    windowHandles.set(windowId, newPage);

    // 监听窗口关闭事件，自动清理映射
    newPage.on('close', () => {
      windowHandles.delete(windowId);
    });
  });
})();

2. 获取独立窗口唯一标识 #

如果是已有标签页拖出生成新窗口（没有新建页面，仅原有页面迁移窗口），可以调用CDP原生接口获取每个页面对应的窗口唯一ID，区分不同独立窗口：

// 获取页面对应的独立窗口ID
async function getWindowIdForPage(page) {
  const cdpClient = await page.createCDPSession();
  const { windowId } = await cdpClient.send('Browser.getWindowForTarget', {
    targetId: page.target()._targetId
  });
  return windowId;
}

返回的windowId是浏览器分配给每个独立窗口的唯一数值ID，和标签页归属无关，只要页面在同一个独立窗口内，对应的windowId就不会变化。

3. 切换操作指定窗口 #

直接通过windowHandles映射获取对应窗口的Page实例，调用常规Puppeteer Page API即可操作对应窗口，和操作普通标签页完全一致：

// 示例：获取所有活跃窗口ID列表
const allWindowIds = Array.from(windowHandles.keys());

// 示例：操作指定窗口跳转页面
const targetWindow = windowHandles.get(指定的windowId);
await targetWindow.goto('https://example.com');

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