Quick Actions 概览

Quick Actions 为截取屏幕截图、提取 HTML 内容、生成 PDF 等常见浏览器任务提供简单接口。你可以通过两种方式使用 Quick Actions：

REST API：用于一次性请求或外部集成的 HTTP 端点。
Workers 绑定：使用 env.BROWSER.quickAction() 从 Cloudflare Worker 直接调用 Quick Actions。

可用选项如下：

``/crawl` 仅通过 REST API 提供。

当你需要快速、简单的方式执行常见浏览器任务（如截取屏幕截图、提取 HTML 或生成 PDF）而无需编写复杂脚本时，请使用 Quick Actions。对于更高级的自动化、自定义工作流或持久浏览器会话，请使用 Puppeteer、Playwright 或 CDP。

开始之前

要通过 REST API 使用 Quick Actions，请创建自定义 API Token，并授予以下权限：

要从 Worker 使用 Quick Actions，请在 wrangler.json 中配置 browser 绑定。使用 Workers 绑定时无需 API token。

{
  "browser": {
    "binding": "BROWSER"
  }
}

注意

.quickAction() 方法有两个要求：

兼容性日期： Worker 必须使用 2026-03-24 或更高版本的 compatibility date。
本地开发需要 remote 模式： .quickAction() 方法尚不支持本地开发模式。使用 wrangler dev 本地开发时，必须使用 npx wrangler dev --remote 或在 browser 绑定配置中设置 "remote": true。未使用 remote 模式时，将收到错误：The RPC receiver does not implement the method "quickAction"。

{
  "compatibility_date": "2026-03-24",
  "browser": {
    "binding": "BROWSER",
    "remote": true
  }
}