1# Configuration & Setup
2 
3## Installation
4 
5```bash
6npm install @cloudflare/puppeteer  # or @cloudflare/playwright
7```
8 
9**Use Cloudflare packages** - standard `puppeteer`/`playwright` won't work in Workers.
10 
11## wrangler.json
12 
13```json
14{
15  "name": "browser-worker",
16  "main": "src/index.ts",
17  "compatibility_date": "2025-01-01",
18  "compatibility_flags": ["nodejs_compat"],
19  "browser": {
20    "binding": "MYBROWSER"
21  }
22}
23```
24 
25**Required:** `nodejs_compat` flag and `browser.binding`.
26 
27## TypeScript
28 
29```typescript
30interface Env {
31  MYBROWSER: Fetcher;
32}
33 
34export default {
35  async fetch(request: Request, env: Env): Promise<Response> {
36    // ...
37  }
38} satisfies ExportedHandler<Env>;
39```
40 
41## Development
42 
43```bash
44wrangler dev --remote  # --remote required for browser binding
45```
46 
47**Local mode does NOT support Browser Rendering** - must use `--remote`.
48 
49## REST API
50 
51No wrangler config needed. Get API token with "Browser Rendering - Edit" permission.
52 
53```bash
54curl -X POST \
55  'https://api.cloudflare.com/client/v4/accounts/{accountId}/browser-rendering/screenshot' \
56  -H 'Authorization: Bearer TOKEN' \
57  -d '{"url": "https://example.com"}' --output screenshot.png
58```
59 
60## Requirements
61 
62| Requirement | Value |
63|-------------|-------|
64| Node.js compatibility | `nodejs_compat` flag |
65| Compatibility date | 2023-03-01+ |
66| Module format | ES modules only |
67| Browser | Chromium 119+ (no Firefox/Safari) |
68 
69**Not supported:** WebGL, WebRTC, extensions, `file://` protocol, Service Worker syntax.
70 
71## Troubleshooting
72 
73| Error | Solution |
74|-------|----------|
75| `MYBROWSER is undefined` | Use `wrangler dev --remote` |
76| `nodejs_compat not enabled` | Add to `compatibility_flags` |
77| `Module not found` | `npm install @cloudflare/puppeteer` |
78| `Browser Rendering not available` | Enable in dashboard |
79