Contexts
Viewports
Session metadata
Browser Extensions
Quick reference
| Feature | What it does | When to use it |
|---|---|---|
| Contexts | Persists cookies, auth tokens, and browser storage across sessions | Any workflow that requires login: avoids re-authenticating on every run |
| Viewports | Sets the browser window width and height | Visual testing, screenshots, or layouts that are viewport-dependent |
| Session metadata | Attaches custom JSON to a session for querying later | Organizing sessions by test run, environment, team, or status |
| Browser extensions | Loads a Chrome extension into the session | Custom page behavior, ad blocking, or site-specific workarounds |
All features are set at session creation
Every core feature is configured when you create a session. Pass your settings in the browserSettings object:
const session = await browsers.sessions.create({
browserSettings: {
viewport: { width: 1920, height: 1080 },
solveCaptchas: true,
},
context: { id: contextId, persist: true },
});See the Create Session API reference for the full list of options.