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 |
|---|---|
| addCookies() | Adds
cookies into the BrowserContext. |
| addInitScript() | Adds a script that will be evaluated on page creation, frame attached or a navigation occurs. |
| clearCookies() | Clear the BrowserContext’s
cookies. |
| clearPermissions() | Clears all permission overrides for the BrowserContext. |
| cookies() | Returns a list of
cookies from the BrowserContext. |
| close() | Close the BrowserContext and all its
pages. |
| grantPermissions(permissions[, options]) | Grants specified permissions to the BrowserContext. |
| newPage() | Uses the BrowserContext to create a new
Page and returns it. |
| pages() | Returns a list of
pages that belongs to the BrowserContext. |
| setDefaultNavigationTimeout(timeout) | Sets the default navigation timeout in milliseconds. |
| setDefaultTimeout(timeout) | Sets the default maximum timeout for all methods accepting a timeout option in milliseconds. |
| setGeolocation(geolocation) | Sets the BrowserContext’s geolocation. |
| setOffline(offline) | Toggles the BrowserContext’s connectivity on/off. |
| waitForEvent(event[, optionsOrPredicate]) | Waits for the event to fire and passes its value into the predicate function. |


