Struct BrowserContext 

pub struct BrowserContext { /* private fields */ }

A browser context. The default context has browser_context_id == None; isolated contexts are created via Browser::new_context.

Implementations

impl BrowserContext

pub fn browser_context_id(&self) -> Option<&str>

The CDP browser-context id, or None for the default context.

pub async fn new_page(&self) -> Result<Page>

Open a new page in this context.

pub async fn add_init_script(&self, script: &str) -> Result<()>

Add a script evaluated before each document load (applied to new pages).

pub fn set_default_timeout(&self, timeout_ms: u64)

Set the default action timeout (ms) for pages in this context.

pub async fn set_extra_http_headers(&self, headers: Headers) -> Result<()>

Set extra HTTP headers sent on every request (applied to new + existing pages).

pub fn request(&self) -> APIRequestContext

Return a standalone HTTP client (APIRequestContext) tied to this context. Its default headers are seeded (best-effort) from the context’s extra_http_headers. The client is otherwise independent of the browser — it makes direct HTTP requests.

pub fn pages(&self) -> Vec<Page>

All pages opened in this context.

pub fn browser(&self) -> Browser

The owning browser.

pub async fn add_cookies(&self, cookies: &[Cookie]) -> Result<()>

Add cookies to this context.

pub async fn cookies(&self) -> Result<Vec<Value>>

Get cookies for this context.

pub async fn clear_cookies(&self) -> Result<()>

Clear cookies for this context.

pub fn on_page<F, Fut>(&self, handler: F)

where F: Fn(Page) -> Fut + Send + Sync + 'static, Fut: Future<Output = ()> + Send + 'static,

Register a handler called for each new page in this context.

pub async fn close(&self) -> Result<()>

Close the context and all its pages. Disposes an isolated context.

pub async fn grant_permissions(&self, permissions: &[&str]) -> Result<()>

Grant browser permissions (e.g. ["geolocation", "clipboard-read"]). Applies browser-wide (CDP Browser.grantPermissions is not context-scoped).

pub async fn clear_permissions(&self) -> Result<()>

Reset all granted permissions.

pub async fn storage_state(&self) -> Result<StorageState>

Snapshot storage state: cookies plus per-origin localStorage.

For each page in the context, localStorage is captured grouped by location.origin. Pages whose origin is "null" (e.g. about:blank, data: URLs) are skipped.

pub async fn set_storage_state(&self, state: &StorageState) -> Result<()>

Restore storage state previously captured by Self::storage_state: cookies are added via the Storage domain, and each origin’s localStorage is set by evaluating localStorage.setItem on a page at that origin (an existing page if one matches, otherwise a freshly created one).

pub async fn route<F, Fut>(&self, pattern: &str, handler: F) -> Result<()>

where F: Fn(Route) -> Fut + Send + Sync + 'static, Fut: Future<Output = ()> + Send + 'static,

Register a route that intercepts matching requests on ALL pages in this context — including pages created after this call. The handler must continue/fulfill/abort the Route.

A context route is applied to each page by registering the equivalent page-level route on it. Context-level and page-level routes are otherwise independent.

pub async fn unroute(&self, pattern: &str) -> Result<()>

Remove the first context-level route registered with exactly pattern and remove the matching page-level route on each page.

pub async fn unroute_all(&self) -> Result<()>

Remove all context-level routes and all page-level routes on each page.

pub fn tracing(&self) -> Tracing

A performance tracing handle bound to the browser-level CDP session.

Mirrors Playwright’s context.tracing(). The Tracing domain is browser-level; tracing() returns clones of a single shared handle so [Tracing::start] and [Tracing::stop] operate on the same state.

Trait Implementations

impl Clone for BrowserContext

fn clone(&self) -> BrowserContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.