Wrangler 是用于构建 Cloudflare 开发者产品的命令行工具。
使用 Wrangler 部署使用 Workers Browser Run API 的项目。
要安装 Wrangler,请参阅安装和更新 Wrangler。
绑定(binding) 允许 Worker 与 Cloudflare 开发者平台上的资源交互。browser 绑定将为 Worker 提供经过身份验证的端点,以与专用 Chromium 浏览器实例交互。
要部署 Browser Run Worker,必须在 Worker 的 Wrangler 配置文件中声明 browser 绑定。
{
"$schema": "./node_modules/wrangler/config-schema.json",
// Top-level configuration
"name": "browser-rendering",
"main": "src/index.ts",
"workers_dev": true,
"compatibility_flags": ["nodejs_compat_v2"],
"browser": {
"binding": "MYBROWSER",
},
}"$schema" = "./node_modules/wrangler/config-schema.json"
name = "browser-rendering"
main = "src/index.ts"
workers_dev = true
compatibility_flags = [ "nodejs_compat_v2" ]
[browser]
binding = "MYBROWSER"声明绑定后,在 Worker 代码中使用 env.MYBROWSER 访问 DevTools 端点:
const browser = await puppeteer.launch(env.MYBROWSER);对于基于 Puppeteer、Playwright 或 CDP 的 Worker,运行 npx wrangler dev 在本地测试。对于通过 .quickAction() 使用 Quick Actions,如上所述使用 npx wrangler dev --remote。
默认情况下,本地开发以 headless 模式运行 Chrome。要以可见(headful)模式启动 Chrome 进行调试,请设置 X_BROWSER_HEADFUL 环境变量:
X_BROWSER_HEADFUL=true npx wrangler dev这会在屏幕上打开浏览器窗口,以便实时观看导航、交互和渲染。Headful 模式仅用于本地开发,不影响已部署的 Worker。此功能为实验性,可能在不通知的情况下变更。