Wrangler は、Cloudflare の開発者向けプロダクトで構築するためのコマンドラインツールです。
Workers Browser Run API を使うプロジェクトのデプロイに Wrangler を使います。
Wrangler のインストールは、Wrangler のインストールと更新 を参照してください。
バインディング を使うと、Worker が Cloudflare 開発者プラットフォーム上のリソースとやり取りできます。ブラウザーバインディングは、専用の Chromium ブラウザーインスタンスとやり取りするための認証済みエンドポイントを Worker に提供します。
Browser Run Worker をデプロイするには、Worker の Wrangler 設定ファイルで ブラウザーバインディング を宣言する必要があります。
{
"$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 を使います。
デフォルトでは、ローカル開発は Chrome を headless モードで起動します。デバッグのために Chrome を表示付き（headful）で起動するには、環境変数 X_BROWSER_HEADFUL を設定します。
X_BROWSER_HEADFUL=true npx wrangler dev画面上にブラウザーウィンドウが開き、ナビゲーション、操作、レンダリングをリアルタイムで確認できます。Headful モードはローカル開発専用で、デプロイ済みの Worker には影響しません。この機能は実験的であり、予告なく変更される場合があります。