mirror of
https://github.com/ksyasuda/dotfiles.git
synced 2026-03-20 06:11:27 -07:00
79 lines
3.0 KiB
Markdown
79 lines
3.0 KiB
Markdown
# Cloudflare Browser Rendering Skill Reference
|
|
|
|
**Description**: Expert knowledge for Cloudflare Browser Rendering - control headless Chrome on Cloudflare's global network for browser automation, screenshots, PDFs, web scraping, testing, and content generation.
|
|
|
|
**When to use**: Any task involving Cloudflare Browser Rendering including: taking screenshots, generating PDFs, web scraping, browser automation, testing web applications, extracting structured data, capturing page metrics, or automating browser interactions.
|
|
|
|
## Decision Tree
|
|
|
|
### REST API vs Workers Bindings
|
|
|
|
**Use REST API when:**
|
|
- One-off, stateless tasks (screenshot, PDF, content fetch)
|
|
- No Workers infrastructure yet
|
|
- Simple integrations from external services
|
|
- Need quick prototyping without deployment
|
|
|
|
**Use Workers Bindings when:**
|
|
- Complex browser automation workflows
|
|
- Need session reuse for performance
|
|
- Multiple page interactions per request
|
|
- Custom scripting and logic required
|
|
- Building production applications
|
|
|
|
### Puppeteer vs Playwright
|
|
|
|
| Feature | Puppeteer | Playwright |
|
|
|---------|-----------|------------|
|
|
| API Style | Chrome DevTools Protocol | High-level abstractions |
|
|
| Selectors | CSS, XPath | CSS, text, role, test-id |
|
|
| Best for | Advanced control, CDP access | Quick automation, testing |
|
|
| Learning curve | Steeper | Gentler |
|
|
|
|
**Use Puppeteer:** Need CDP protocol access, Chrome-specific features, migration from existing Puppeteer code
|
|
**Use Playwright:** Modern selector APIs, cross-browser patterns, faster development
|
|
|
|
## Tier Limits Summary
|
|
|
|
| Limit | Free Tier | Paid Tier |
|
|
|-------|-----------|-----------|
|
|
| Daily browser time | 10 minutes | Unlimited* |
|
|
| Concurrent sessions | 3 | 30 |
|
|
| Requests per minute | 6 | 180 |
|
|
|
|
*Subject to fair-use policy. See [gotchas.md](gotchas.md) for details.
|
|
|
|
## Reading Order
|
|
|
|
**New to Browser Rendering:**
|
|
1. [configuration.md](configuration.md) - Setup and deployment
|
|
2. [patterns.md](patterns.md) - Common use cases with examples
|
|
3. [api.md](api.md) - API reference
|
|
4. [gotchas.md](gotchas.md) - Avoid common pitfalls
|
|
|
|
**Specific task:**
|
|
- **Setup/deployment** → [configuration.md](configuration.md)
|
|
- **API reference/endpoints** → [api.md](api.md)
|
|
- **Example code/patterns** → [patterns.md](patterns.md)
|
|
- **Debugging/troubleshooting** → [gotchas.md](gotchas.md)
|
|
|
|
**REST API users:**
|
|
- Start with [api.md](api.md) REST API section
|
|
- Check [gotchas.md](gotchas.md) for rate limits
|
|
|
|
**Workers users:**
|
|
- Start with [configuration.md](configuration.md)
|
|
- Review [patterns.md](patterns.md) for session management
|
|
- Reference [api.md](api.md) for Workers Bindings
|
|
|
|
## In This Reference
|
|
|
|
- **[configuration.md](configuration.md)** - Setup, deployment, wrangler config, compatibility
|
|
- **[api.md](api.md)** - REST API endpoints + Workers Bindings (Puppeteer/Playwright)
|
|
- **[patterns.md](patterns.md)** - Common patterns, use cases, real examples
|
|
- **[gotchas.md](gotchas.md)** - Troubleshooting, best practices, tier limits, common errors
|
|
|
|
## See Also
|
|
|
|
- [Cloudflare Docs](https://developers.cloudflare.com/browser-rendering/)
|