跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Wrangler

最后更新 查看 MarkdownAgent 设置

Wrangler 是用于构建 Cloudflare 开发者产品的命令行工具。

使用 Wrangler 部署使用 Workers Browser Run API 的项目。

安装

要安装 Wrangler,请参阅安装和更新 Wrangler。

绑定(binding)

绑定(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",
	"upload_source_maps": true,
	"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"
upload_source_maps = true
workers_dev = true
compatibility_flags = [ "nodejs_compat_v2" ]

[browser]
binding = "MYBROWSER"

声明绑定后,在 Worker 代码中使用 env.MYBROWSER 访问 DevTools 端点:

const browser = await puppeteer.launch(env.MYBROWSER);

浏览器绑定还提供带类型定义的方法,用于会话管理、出站 Worker 路由和 DevTools 操作。

对于基于 Puppeteer、Playwright 或 CDP 的 Worker,运行 npx wrangler dev 在本地测试。对于通过 .quickAction() 使用 Quick Actions,如上所述使用 npx wrangler dev --remote。

Headful 模式(实验性)

默认情况下,本地开发以 headless 模式运行 Chrome。要以可见(headful)模式启动 Chrome 进行调试,请设置 X_BROWSER_HEADFUL 环境变量:

X_BROWSER_HEADFUL=true npx wrangler dev

这会在屏幕上打开浏览器窗口,以便实时观看导航、交互和渲染。Headful 模式仅用于本地开发,不影响已部署的 Worker。此功能为实验性,可能在不通知的情况下变更。

这篇文档对您有帮助吗?