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_core::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<BrowserContext, Error>

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 new_page(&self) -> Result<Page, Error>

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<(), Error>

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

Trait Implementations

impl ChannelOwner for BrowserContext

fn guid(&self) -> &str

Returns the unique GUID for this object.

fn type_name(&self) -> &str

Returns the protocol type name (e.g., “Browser”, “Page”).

fn parent(&self) -> Option<Arc<dyn ChannelOwner>>

Returns the parent object, if any.

fn connection(&self) -> Arc<dyn ConnectionLike>

Returns the connection this object belongs to.

fn initializer(&self) -> &Value

Returns the raw initializer JSON from the server.

fn channel(&self) -> &Channel

Returns the channel for RPC communication.

fn dispose(&self, reason: DisposeReason)

Disposes this object and all its children.

fn adopt(&self, child: Arc<dyn ChannelOwner>)

Adopts a child object (moves from old parent to this parent).

fn add_child(&self, guid: Arc<str>, child: Arc<dyn ChannelOwner>)

Adds a child object to this parent’s registry.

fn remove_child(&self, guid: &str)

Removes a child object from this parent’s registry.

fn on_event(&self, method: &str, params: Value)

Handles a protocol event sent to this object.

fn was_collected(&self) -> bool

Returns true if this object was garbage collected.

fn as_any(&self) -> &(dyn Any + 'static)

Enables downcasting to concrete types.

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<(), Error>

Formats the value using the given formatter.