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.

# Top-level configuration
name = "browser-rendering"
main = "src/index.ts"
node_compat = true
workers_dev = true

browser = { binding = "MYBROWSER" }

// For Wrangler to read a JSON configuration file, you must add the `-j` flag
// e.g. `wrangler -j dev`
{
  "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.