← Browser Run / browser-run / reference

Wrangler

Wrangler это инструмент командной строки для разработки с продуктами Cloudflare для разработчиков.

Используйте Wrangler для развёртывания проектов, использующих Workers Browser Run API.

Чтобы установить Wrangler, см. Установка и обновление Wrangler.

Bindings позволяют вашим Workers взаимодействовать с ресурсами платформы разработчика Cloudflare. Привязка (binding) браузера предоставит вашему Worker аутентифицированную конечную точку для взаимодействия с выделенным экземпляром браузера Chromium.

Чтобы развернуть Worker для Browser Run, необходимо объявить привязка browser в файле конфигурации Wrangler вашего Worker.

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

После объявления привязки обращайтесь к эндпоинту DevTools с помощью env.MYBROWSER в коде вашего Worker:

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

Для Workers на основе Puppeteer, Playwright или CDP выполните npx wrangler dev для локального тестирования. Для Quick Actions через .quickAction(), используйте npx wrangler dev --remote как отмечено выше.

По умолчанию при локальной разработке Chrome запускается в режиме headless. Чтобы запустить Chrome в видимом режиме (headful) для отладки, задайте X_BROWSER_HEADFUL переменную окружения:

X_BROWSER_HEADFUL=true npx wrangler dev

Это открывает окно браузера на экране, чтобы вы могли наблюдать за переходами, взаимодействиями и рендерингом в режиме реального времени. Режим headful предназначен только для локальной разработки и не влияет на развёрнутые Workers. Эта функция экспериментальная и может измениться без предупреждения.