Connecting to a Session
Once you create a session, you’ll receive a connection URL that you can use with your preferred automation framework. Here’s how to connect using our supported frameworks:Connection Best Practices
-
Connection Timeout - You have 5 minutes to connect to a newly created session before it terminates. To prevent timeouts:
- Connect promptly after creation
- Enable keep alive for sessions that need to persist
- Use the connection URL immediately after receiving it
- Use Default Context - Always use the default context and page when possible to ensure proper functionality of stealth features:
Controlling the Browser
Once connected, use your preferred framework’s APIs to control the browser. Each framework has its own methods for navigation, interaction, and automation.Stagehand
Build reliable browser automation with AI-powered element selection and self-healing scripts
Playwright
Create fast, reliable end-to-end tests with built-in auto-waiting and mobile
emulation
Puppeteer
Headless Chrome automation with a lightweight API and strong DevTools
integration
Selenium
Industry-standard testing framework supporting all major browsers and programming languages
Browserbase Features
When running browsers in the cloud, certain operations require special handling through our APIs:File Downloads
Securely retrieve files from your cloud browser session
Screenshots
Capture high-quality browser screenshots with custom settings
PDF Generation
Create PDFs with advanced formatting options
File Upload
Transfer files directly to your browser session
Live View
The Live View feature gives you real-time visibility into your browser sessions through two powerful interfaces:Session Inspector
The Session Inspector provides real-time debugging capabilities:
- Live browser state and interactions
- Real-time network requests and responses
- Console output and error tracking
- Performance metrics and resource usage
- Session recording and replay