Browser Rendering 说明文档

# Cloudflare 浏览器渲染技能参考 **描述**：Cloudflare 浏览器渲染的专家知识——在 Cloudflare 全球网络上控制无头 Chrome，用于浏览器自动化、截图、PDF 生成、网页抓取、测试和内容生成。 **使用场景**：任何涉及 Cloudflare 浏览器渲染的任务，包括：截图、生成 PDF、网页抓取、浏览器自动化、测试 Web 应用、提取结构化数据、捕获页面指标或自动化浏览器交互。 ## 决策树 ### REST API 与 Workers 绑定 **在以下情况使用 REST API：** - 一次性、无状态的任务（截图、PDF、内容获取） - 尚未建立 Workers 基础设施 - 来自外部服务的简单集成 - 需要无需部署的快速原型设计 **在以下情况使用 Workers 绑定：** - 复杂的工作流浏览器自动化 - 需要会话重用以提高性能 - 每个请求需要多次页面交互 - 需要自定义脚本和逻辑 - 构建生产级应用程序 ### Puppeteer 与 Playwright | 特性 | Puppeteer | Playwright | |---------|-----------|------------| | API 风格 | Chrome DevTools 协议 | 高级抽象 | | 选择器 | CSS, XPath | CSS, 文本, 角色, test-id | | 最佳用途 | 高级控制, CDP 访问 | 快速自动化, 测试 | | 学习曲线 | 较陡峭 | 较平缓 | **使用 Puppeteer：** 需要 CDP 协议访问、Chrome 特有功能、从现有 Puppeteer 代码迁移 **使用 Playwright：** 现代选择器 API、跨浏览器模式、更快的开发速度 ## 层级限制摘要 | 限制 | 免费层级 | 付费层级 | |-------|-----------|-----------| | 每日浏览器时间 | 10 分钟 | 无限制* | | 并发会话 | 3 | 30 | | 每分钟请求数 | 6 | 180 | *受公平使用政策约束。详情请参阅 [gotchas.md](gotchas.md)。 ## 阅读顺序 **浏览器渲染新手：** 1. [configuration.md](configuration.md) - 设置与部署 2. [patterns.md](patterns.md) - 常见用例与示例 3. [api.md](api.md) - API 参考 4. [gotchas.md](gotchas.md) - 避免常见陷阱 **特定任务：** - **设置/部署** → [configuration.md](configuration.md) - **API 参考/端点** → [api.md](api.md) - **示例代码/模式** → [patterns.md](patterns.md) - **调试/故障排除** → [gotchas.md](gotchas.md) **REST API 用户：** - 从 [api.md](api.md) 的 REST API 部分开始 - 查看 [gotchas.md](gotchas.md) 了解速率限制 **Workers 用户：** - 从 [configuration.md](configuration.md) 开始