如何获取Puppeteer v16.1.0中每个页面的唯一ID？

以下几种方法可以在 Puppeteer ^16.1.0 中获取字符串类型的页面唯一标识：

1. 使用官方公开API（推荐） #

直接通过page.target().targetId()获取官方提供的页面唯一ID，这是稳定且受支持的方式，不会因为版本迭代失效：

const uniqueId = page.target().targetId();

返回值是字符串类型，每个页面实例对应唯一的ID，完全满足需求。

2. 自定义唯一标识 #

如果需要更灵活的标识规则，可以自行生成唯一字符串，比如结合页面URL+时间戳，或者使用UUID库：

// 先安装uuid库：npm install uuid
const { v4: uuidv4 } = require('uuid');

// 在创建页面时为其分配唯一ID
const page = await browser.newPage();
const customUniqueId = uuidv4(); // 生成随机唯一字符串

这种方式完全不受Puppeteer内部结构变动影响，适合需要自定义标识逻辑的场景。

注意事项 #

不要依赖page._client._targetId这类私有属性，Puppeteer升级时会频繁修改内部实现，这类未公开的API随时可能失效，官方也不会提供兼容性保证。

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