← Browser Run / browser-run / reference

Wrangler

Wrangler je nástroj příkazové řádky pro vývoj s produkty Cloudflare pro vývojáře.

K nasazení projektů využívajících Workers Browser Run API použijte Wrangler.

Instalovat

Pokyny k instalaci Wrangler najdete v Instalace a aktualizace Wrangler.

Bindings

Bindings umožňují vašim Workerům komunikovat s prostředky na vývojářské platformě Cloudflare. Vazba (binding) prohlížeče poskytne vašemu Workeru autentizovaný koncový bod pro komunikaci s vyhrazenou instancí prohlížeče Chromium.

Chcete-li nasadit Worker pro Browser Run, musíte deklarovat vazba pro prohlížeč v konfiguračním souboru Wrangler vašeho workeru.

{
	"$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"

Po deklarování vazby přistupte k endpointu DevTools pomocí env.MYBROWSER v kódu vašeho workeru:

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

Kompatibilita Quick Actions

browser bindingu .quickAction() metoda vyžaduje datum kompatibility 2026-03-24 nebo novější. Ujistěte se, že váš wrangler.json zahrnuje:

{
  "compatibility_date": "2026-03-24"
}

Quick Actions vyžadují pro lokální vývoj vzdálený režim

.quickAction() metoda zatím není v místním vývojovém režimu podporována. Při použití wrangler dev, musíte spustit s --remote nebo nastavte "remote": true v konfiguraci vazby prohlížeče:

{
  "browser": {
    "binding": "MYBROWSER",
    "remote": true
  }
}

Bez vzdáleného režimu volání na .quickAction() selže s chybou: The RPC receiver does not implement the method "quickAction".

U Workers založených na Puppeteer, Playwright nebo CDP spusťte npx wrangler dev k lokálnímu testování. Pro Quick Actions přes .quickAction(), použijte npx wrangler dev --remote jak je uvedeno výše.

Režim headful (experimentální)

Ve výchozím nastavení běží lokální vývoj v prohlížeči Chrome v režimu headless. Chcete-li spustit Chrome ve viditelném režimu (headful) kvůli ladění, nastavte X_BROWSER_HEADFUL proměnnou prostředí:

X_BROWSER_HEADFUL=true npx wrangler dev

Tím se na obrazovce otevře okno prohlížeče, takže můžete v reálném čase sledovat navigace, interakce a vykreslování. Headful režim je určen pouze pro lokální vývoj a neovlivňuje nasazené Workers. Tato funkce je experimentální a může se kdykoli bez upozornění změnit.