用途:在 Cloudflare Workers 上运行无头 Chromium 浏览器,用 Puppeteer 或 Playwright 自动化浏览器任务,包括截图、生成 PDF、抓取动态网页、前端测试和跨页爬取。资料分为 Workers 绑定(支持完整 API 与自定义工作流)和 REST API(适合简单截图/PDF)两种集成方式,本文覆盖 Workers 绑定。
主要能力:截图与 PDF 生成、通过 page.evaluate() 在页面上下文执行 JS 提取数据、page.waitForSelector()、type()、click() 等交互;浏览器对象提供 newPage()、sessionId()、close()、disconnect()、createBrowserContext()。Puppeteer 支持 sessions()、history()、limits() 等会话管理 API;Playwright 会话 API 较基础,仅支持 Chromium。
配置与使用:在 wrangler.jsonc 中添加 browser 绑定(如 "browser": {"binding": "MYBROWSER"}),并启用 nodejs_compat;安装 npm install @cloudflare/puppeteer 或 @cloudflare/playwright;调用 puppeteer.launch(env.MYBROWSER) 或 chromium.launch(env.BROWSER),完成后调用 browser.close(),会话复用时改用 disconnect()。部署用 npx wrangler deploy。keep_alive 最长 600000 毫秒。
限制:绑定必须传入,否则报错;Chromium 为唯一浏览器;会话与并发受账户限制,可用 puppeteer.limits() 检查;Playwright 会话管理能力有限。具体定价与配额资料未提供。