Puppeteer 代理接入
产品介绍
Puppeteer 是由 Google Chrome 团队维护的开源 JavaScript/TypeScript 库，通过 DevTools 协议（CDP）或 WebDriver BiDi 高级 API 控制 Chrome 与 Firefox。 Puppeteer 提供通过浏览器自动化协议控制 Chrome 与 Firefox 的 JavaScript API，可在无可见窗口的模式下运行。它适合编写可重复的页面交互、渲染与测试任务，代理配置则作用于脚本启动的浏览器进程，需要与实际使用的浏览器和认证方式配合。
核心功能
真实浏览器渲染与无头控制：默认以无头模式（Headless）运行，也可开启完整界面（Headful）；支持完整的 DOM 渲染、JavaScript 执行、表单交互、网络请求拦截、性能时间线分析以及生成页面截图与 PDF。
- JavaScript 浏览器控制：Puppeteer 的 API 可以驱动 Chrome 与 Firefox，完成页面导航、点击、表单填写和脚本执行。它默认支持无头运行，也能生成页面截图与 PDF，因此既适合自动化测试，也能用于渲染内容和生成网页报告。
- 无头模式运行：工作流由代码控制浏览器进程与页面，用户可为不同任务建立浏览器上下文并保存需要的结果。与直接发送 HTTP 请求的库相比，它能够运行页面 JavaScript 并操作真实页面，但也需要管理浏览器资源与等待条件。
适用工作流
例如生成某个网站的定期截图时，可以在脚本中统一设置访问页面、等待内容、输出图片和错误处理。代理应配置在实际启动的浏览器连接中，认证方式也要与浏览器配合；只改变 Node.js 进程的网络设置不一定覆盖浏览器流量。
- SPA 动态网页采集与自动化测试：适用于抓取依赖客户端 JS 渲染的单页应用（SPA）、自动生成可视化报表快照、端到端（E2E）UI 测试及定时页面巡检。
- 通过在 `puppeteer.launch()` 的启动参数中传入 `--proxy-server` 配置代理，并使用 `page.authenticate()` 处理代理用户名密码认证；针对大规模公开页面渲染与抓取，建议搭配高性价比、低延迟的数据中心代理。