跳转到内容
搜索文档

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",
	"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

Headful 模式(实验性)

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

X_BROWSER_HEADFUL=true npx wrangler dev

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

这篇文档对您有帮助吗?