Struct BrowserContext 

pub struct BrowserContext { /* private fields */ }

BrowserContext represents an isolated browser session.

Contexts are isolated environments within a browser instance. Each context has its own cookies, cache, and local storage, enabling independent sessions without interference.

Example

use playwright_rs::protocol::Playwright;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let playwright = Playwright::launch().await?;
    let browser = playwright.chromium().launch().await?;

    // Create isolated contexts
    let context1 = browser.new_context().await?;
    let context2 = browser.new_context().await?;

    // Create pages in each context
    let page1 = context1.new_page().await?;
    let page2 = context2.new_page().await?;

    // Cleanup
    context1.close().await?;
    context2.close().await?;
    browser.close().await?;
    Ok(())
}

See: https://playwright.dev/docs/api/class-browsercontext

Implementations

impl BrowserContext

pub fn new( parent: Arc<dyn ChannelOwner>, type_name: String, guid: Arc<str>, initializer: Value, ) -> Result<Self>

Creates a new BrowserContext from protocol initialization

This is called by the object factory when the server sends a __create__ message for a BrowserContext object.

Arguments

• parent - The parent Browser object
• type_name - The protocol type name (“BrowserContext”)
• guid - The unique identifier for this context
• initializer - The initialization data from the server

Errors

Returns error if initializer is malformed

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

Adds a script which would be evaluated in one of the following scenarios:

• Whenever a page is created in the browser context or is navigated.
• Whenever a child frame is attached or navigated in any page in the browser context.

The script is evaluated after the document was created but before any of its scripts were run. This is useful to amend the JavaScript environment, e.g. to seed Math.random.

Arguments

• script - Script to be evaluated in all pages in the browser context.

Errors

Returns error if:

• Context has been closed
• Communication with browser process fails

See: https://playwright.dev/docs/api/class-browsercontext#browser-context-add-init-script

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

Creates a new page in this browser context.

Pages are isolated tabs/windows within a context. Each page starts at “about:blank” and can be navigated independently.

Errors

Returns error if:

• Context has been closed
• Communication with browser process fails

See: https://playwright.dev/docs/api/class-browsercontext#browser-context-new-page

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

Closes the browser context and all its pages.

This is a graceful operation that sends a close command to the context and waits for it to shut down properly.

Errors

Returns error if:

• Context has already been closed
• Communication with browser process fails

See: https://playwright.dev/docs/api/class-browsercontext#browser-context-close

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

Pauses the browser context.

This pauses the execution of all pages in the context.

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.

impl Debug for BrowserContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.