Cloudflare Docs
Browser Rendering
Edit this page on GitHub
Set theme to dark (⇧+D)

Wrangler

Wrangler is a command-line tool for building with Cloudflare developer products.

Use Wrangler to deploy projects that use the Workers Browser Rendering API.

​​ Install

To install Wrangler, refer to Install and Update Wrangler.

​​ Bindings

Bindings allow your Workers to interact with resources on the Cloudflare developer platform. A browser binding will provide your Worker with an authenticated endpoint to interact with a dedicated Chromium browser instance.

To deploy a Browser Rendering Worker, you must declare a browser binding in your Worker’s wrangler.toml configuration file.

wrangler.toml
# Top-level configuration
name = "browser-rendering"
main = "src/index.ts"
node_compat = true
workers_dev = true
browser = { binding = "MYBROWSER" }

After the binding is declared, access the DevTools endpoint using env.MYBROWSER in your Worker code:

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

Run npx wrangler dev --remote to test your Worker remotely before deploying to Cloudflare’s global network. Local mode support does not exist for Browser Rendering so --remote is required. To deploy, run npx wrangler deploy.