headful-browser-rendering.md

wrangler	minor
miniflare	minor
@cloudflare/vite-plugin	minor
@cloudflare/workers-utils	minor

Add headful browser rendering support for local development

When developing locally with the Browser Rendering API, you can now enable headful (visible) mode to see the browser while debugging.

wrangler dev:

wrangler dev --headful

@cloudflare/vite-plugin — via plugin config:

// vite.config.ts
import { cloudflare } from "@cloudflare/vite-plugin";

export default defineConfig({
  plugins: [cloudflare({ headful: true })],
});

Or via environment variable (no config change needed):

BROWSER_RENDERING_HEADFUL=true vite dev

Note: when using @cloudflare/playwright, two Chrome windows may appear — the initial blank page and the one created by browser.newPage(). This is expected behavior due to how Playwright handles browser contexts via CDP.