这是 Browser Run(曾用名 Browser Rendering)每次更新的详细更新日志。如需了解包括 Browser Run 在内的所有 Cloudflare 产品的主要更新摘要,请访问 developers.cloudflare.com/changelog。
新端点:/accessibilityTree
- 新增
/accessibilityTree端点,用于从渲染后的网页中捕获无障碍树。无障碍树包含角色、名称、值、状态和层级结构,为 AI 智能体和自动化工作流提供页面元素的结构化视图,无需解析原始 HTML 或解读屏幕截图。您可以捕获完整的页面树,使用interestingOnly仅返回具有语义意义的节点,或使用root捕获子树。
新教程:为爬虫预渲染页面
- 新增一篇教程,介绍如何使用 Browser Run 和 Worker 预渲染大量使用 JavaScript 的页面。该教程介绍如何构建一个预渲染端点,调用
/contentQuick Action 在托管的无头 Chrome 中渲染页面,并为搜索爬虫、社交预览机器人、AI 索引任务或合作伙伴集成返回可供爬虫使用的 HTML。
/snapshot 新增 formats 参数
/snapshot端点现在支持formats参数,可让您在单次 API 调用中返回多种页面格式。此前,/snapshot仅返回 HTML 内容和屏幕截图。现在,您还可以在同一响应中包含 Markdown 和无障碍树。有关用法示例和可接受的值,请参阅/snapshot文档。
@cloudflare/playwright v1.3.0 发布
- 发布了
@cloudflare/playwright1.3.0 版本。从此版本开始,该库在内部使用标准 CDP(Chrome DevTools Protocol)与 Browser Run 通信,取代了之前的分块协议。这与 Browser Run 的完整 CDP 支持保持一致,并可避免在使用最新兼容性日期时出现兼容性问题。如果遇到任何问题,可以通过将compatibility_date设置为早于2026-03-17的日期或添加no_websocket_standard_binary_type标志来降级。详细信息请参阅@cloudflare/playwrightREADME。
更高的并发限制
Live View
- Live View 让您可以实时查看远程浏览器会话并与之交互。您可以用它来调试自动化脚本、监控浏览器正在执行的操作,或在任务需要人工干预时手动介入。可以通过 Cloudflare 仪表板、
live.browser.run上的托管 UI 或原生 Chrome DevTools 访问 Live View。
Human in the Loop
- Human in the Loop 允许人员介入实时浏览器会话,处理自动化无法完成的操作(例如登录页面、CAPTCHA 或敏感数据输入),然后将控制权交还给脚本。可以通过 Live View 访问任何活动会话。
会话录制
- 会话录制会将 DOM 变更、鼠标和键盘事件以及页面导航捕获为结构化数据,以便您在任何浏览器会话结束后进行回放。启动浏览器时传入
recording: true即可启用录制。会话关闭后,可以从 Cloudflare 仪表板的 Runs(运行) 选项卡访问录制内容,或通过 API 获取。
支持 WebMCP
- Browser Run 现在支持 WebMCP(Web Model Context Protocol),该协议允许网站声明可供 AI 智能体发现和执行的结构化工具。支持 WebMCP 的浏览器可通过实验性的 lab 浏览器池使用。
用于 Browser Rendering 的 Wrangler CLI 命令
- 新增
wrangler browser命令,可直接从终端创建、管理和查看浏览器会话。可用命令:create、close、list和view。完整用法请参阅 Wrangler 命令。
@cloudflare/puppeteer v1.1.0 发布
- 发布了
@cloudflare/puppeteer1.1.0 版本,该版本用普通 CDP 取代了内部的分块协议,修复了使用最新兼容性日期时的兼容性问题。
支持 Chrome DevTools Protocol(CDP)和 MCP 客户端
- Browser Rendering 现在将 Chrome DevTools Protocol(CDP)作为端点公开。任何兼容 CDP 的客户端(包括 Puppeteer 和 Playwright)都可以从任何环境连接,无论是 Cloudflare Workers、您的本地计算机还是云环境。Claude Desktop、Claude Code、Cursor 和 OpenCode 等 MCP 客户端也可以将 Browser Rendering 用作远程浏览器。
本地开发:有头模式(实验性)
- 现在,您可以在本地开发期间以可见(有头)模式运行 Chrome,只需在运行
wrangler dev或vite dev之前设置X_BROWSER_HEADFUL=true。这样可以更方便地直观调试浏览器自动化脚本。此功能为实验性功能,可能会在不另行通知的情况下更改。
@cloudflare/playwright v1.2.0 发布
- 发布了
@cloudflare/playwright1.2.0 版本,现已升级到 Playwright v1.58.2。
为不同的 Browser Rendering 方法使用独立的机器人检测 ID
- Browser Rendering 现在为 REST API 和 Browser Sessions 与 crawl 端点使用不同的机器人检测 ID,让您可以分别识别和控制每种方法。完整的 ID 列表请参阅自动请求标头。
新的 REST API 端点:/crawl(Beta)
- 在 REST API 中新增
/crawl端点(Beta)。/crawl端点会从起始 URL 抓取内容,并跟踪站点内的链接,直至达到可配置的深度或页面数上限。响应可以以 HTML、Markdown 或结构化 JSON(由 Workers AI 提供支持)的形式返回。
提高 REST API 速率限制
- Workers 付费计划的 REST API 速率限制已从每分钟 180 个请求(每秒 3 个)提高到每分钟 600 个请求(每秒 10 个)。您无需执行任何操作即可享受更高的限制。
新教程:为 Astro 站点生成 OG 图像
- 新增一篇教程,介绍如何使用 Browser Rendering 为 Astro 站点生成 OG 图像。该教程逐步介绍如何创建 Astro 模板、使用 Browser Rendering 将其截图为 PNG,以及提供生成的图像。
robots.txt 和站点地图的文档更新
- 新增 robots.txt 和站点地图参考页面,为 Browser Rendering 访问的站点提供配置 robots.txt 和站点地图的指导,包括站点地图索引文件和缓存标头。
@cloudflare/playwright v1.1.1 发布
- 发布了
@cloudflare/playwright1.1.1 版本,其中修复了生成大型 PDF 时可能出现的分块问题。请升级到此版本以避免该问题。
@cloudflare/puppeteer v1.0.6 发布
- 发布了
@cloudflare/puppeteer1.0.6 版本,其中修复了渲染大型文本 PDF 的问题。
@cloudflare/puppeteer v1.0.5 发布
- 发布了
@cloudflare/puppeteer1.0.5 版本,其中包含针对 base64 解码的性能优化。
@cloudflare/playwright v1.1.0 发布
- 发布了
@cloudflare/playwright1.1.0 版本,现已升级到 Playwright v1.57.0。
修复 JSON 端点、waitForSelector 超时和 WebSocket 渲染问题
- 更新了
/json端点的后备模型,并改进了 Workers 免费计划用户达到计划限制时的错误处理。 - 如果在时间限制内未找到指定的选择器,使用
waitForSelector的 REST API 请求现在会正确地返回失败。 - 修复了使用 WebSocket 的页面无法正确渲染的问题。
新增在 Bot Management 中将 Browser Rendering 加入允许列表的指导
- 新增常见问题解答指导,介绍在您的 zone 上使用 Bot Management 时,如何创建 WAF 跳过规则以将 Browser Rendering 请求加入允许列表。
改进 AI JSON 响应的解析和调试
- 在
/json端点的错误响应中新增rawAiResponse字段,让您可以在 JSON 解析失败时检查未解析的 AI 输出,便于调试。 - 改进了 AI 响应处理,能够更好地区分有效的 JSON 对象、数组和无效负载,从而提高类型安全性和可靠性。
新增关于 REST API 超时和自定义字体的指导
- 新增 REST API 超时页面,说明 Browser Rendering 如何使用独立的计时器(分别用于页面加载、选择器和操作)以及如何配置这些计时器。
- 更新了支持的字体指南,介绍如何在 Playwright 或 Puppeteer 中通过
addStyleTag()使用您自己的自定义字体。
Playwright 更新、新增 Stagehand 支持以及提高限制
- Browser Rendering 中的 Playwright 支持现已正式发布(GA)。我们已升级到 Playwright v1.55。
- 新增对 Stagehand 的支持。Stagehand 是一个由 Workers AI 提供支持的开源浏览器自动化框架,通过将代码与自然语言指令相结合,帮助开发者更可靠、更灵活地进行构建。
- 提高了付费计划在 REST API 和 Browser Sessions 上的限制。
为 `/links` REST 端点新增 `excludeExternalLinks` 参数
- 使用
/links端点时新增excludeExternalLinks参数。设置为true时,将排除指向所请求 URL 域名之外的链接。
新增 `X-Browser-Ms-Used` 响应标头
- 现在每个 REST API 响应都包含
X-Browser-Ms-Used响应标头,用于报告该请求所使用的浏览器时间(以毫秒为单位)。
Browser Rendering 开始计费
- Browser Rendering 从今天(2025 年 8 月 20 日)开始计费。完整详细信息请参阅定价页面。您可以通过 Cloudflare 仪表板监控用量。
Wrangler 本地开发更新
- 通过更新开发模式浏览器的下载方式改进了本地开发体验,并新增对
/v1/sessions端点的支持,让您可以列出打开的 Browser Rendering 会话。升级到[email protected]即可开始使用。
Playwright 更新、本地开发支持和 REST API 更新
- Playwright 已升级到 Playwright v1.54.1,Playwright MCP 也已升级,与上游 Playwright MCP v0.0.30 保持同步。
- 使用 Browser Rendering 时,通过
npx wrangler dev进行的本地开发现在支持 Playwright。升级到最新版本的 wrangler 即可开始使用。 /content端点现在会返回页面标题,便于识别页面。/json端点现在允许您使用custom_ai参数指定自己的 AI 模型来执行提取。/screenshot端点的默认视口大小已从 800x600 提高到 1920x1080。您仍然可以通过请求选项覆盖视口。
@cloudflare/puppeteer 1.0.4 发布
- 我们发布了
@cloudflare/puppeteer1.0.4 版本,现已与 Puppeteer v22.13.1 同步。
本地开发现已支持 Playwright
- 您现在可以在本地开发中使用 Playwright。升级到 [email protected] 即可开始使用。
新的 Web Bot Auth 标头
- Browser Rendering 现在支持 Web Bot Auth,会自动附加
Signature-agent、Signature和Signature-input标头,以验证请求是否来自 Cloudflare Browser Rendering。
修复 Workers 中调试日志过多的问题
- 修复了所有调试日志默认开启并导致日志泛滥的问题。调试日志现在默认关闭,但需要时可以通过设置
process.env.DEBUG重新启用。
Playwright MCP
- 您现在可以部署 Playwright MCP,并使用任何 MCP 客户端让 AI 模型与 Browser Rendering 交互。
自动请求标头
- 澄清了 Browser Rendering 中的自动请求标头。这些标头是 Browser Rendering 独有的,会被自动包含,且无法移除或覆盖。
支持 Playwright
- 您现在可以在 Cloudflare Workers 中使用 Playwright 的浏览器自动化功能。
新的 Browser Rendering REST API
- 发布了新的 REST API,处于公开 Beta 阶段。所有订阅 Workers 付费计划的客户均可使用。
Browser Rendering 面向所有用户开放
- Browser Rendering 现已结束 Beta 阶段,所有订阅 Workers 付费计划的客户均可使用。分析和日志可在 Cloudflare 仪表板的“Worker & Pages”下查看。