Menu
Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
Open source
RSS
BrowserContext
BrowserContexts provide a way to operate multiple independent sessions, with separate pages, cache, and cookies. A default BrowserContext is created when a browser is launched.
The browser module API is used to create a new BrowserContext.
If a page opens another page, e.g. with a window.open call, the popup will belong to the parent page’s BrowserContext.
| Method | Description |
|---|---|
| BrowserContext.addCookies() | Adds cookies into the BrowserContext. |
| BrowserContext.addInitScript() | Adds a script that will be evaluated on page creation, frame attached or a navigation occurs. |
| BrowserContext.clearCookies() | Clear the BrowserContext’s cookies. |
| BrowserContext.clearPermissions() | Clears all permission overrides for the BrowserContext. |
| BrowserContext.cookies() | Returns a list of cookies from the BrowserContext. |
| BrowserContext.close() | Close the BrowserContext and all its pages. |
| BrowserContext.grantPermissions(permissions[, options]) | Grants specified permissions to the BrowserContext. |
| BrowserContext.newPage() | Uses the BrowserContext to create a new Page and returns it. |
| BrowserContext.pages() | Returns a list of pages that belongs to the BrowserContext. |
| BrowserContext.setDefaultNavigationTimeout(timeout) | Sets the default navigation timeout in milliseconds. |
| BrowserContext.setDefaultTimeout(timeout) | Sets the default maximum timeout for all methods accepting a timeout option in milliseconds. |
| BrowserContext.setGeolocation(geolocation) | Sets the BrowserContext’s geolocation. |
| BrowserContext.setOffline(offline) | Toggles the BrowserContext’s connectivity on/off. |
| BrowserContext.waitForEvent(event[, optionsOrPredicate]) | Waits for the event to fire and passes its value into the predicate function. |
Was this page helpful?
Related resources from Grafana Labs
Performance testing and observability in Grafana Cloud
In this webinar, learn how Grafana Cloud k6 offers you the best developer experience for performance testing.
User-centered observability: load testing, real user monitoring, and synthetics
Learn how to use load testing, synthetic monitoring, and real user monitoring (RUM) to understand end users' experience of your apps. Watch on demand.