Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

Wrangler

最終更新 Markdown で表示Agent セットアップ

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 を使います。

Headful モード(実験的)

デフォルトでは、ローカル開発は Chrome を headless モードで起動します。デバッグのために Chrome を表示付き(headful)で起動するには、環境変数 X_BROWSER_HEADFUL を設定します。

X_BROWSER_HEADFUL=true npx wrangler dev

画面上にブラウザーウィンドウが開き、ナビゲーション、操作、レンダリングをリアルタイムで確認できます。Headful モードはローカル開発専用で、デプロイ済みの Worker には影響しません。この機能は実験的であり、予告なく変更される場合があります。

役に立ちましたか?