Enum PageSession 

pub enum PageSession {
    Cdp(CdpPage),
    Bidi(BidiPage),
}

A bound page-level session. Variants are not constructed directly outside this module; use PageSession::attach.

Variants

Cdp(CdpPage)

Bidi(BidiPage)

A BiDi page session. The client is shared via Arc so the MCP server can keep a single persistent BiDi session across many tool calls (Firefox limits a browser to one BiDi session at a time).

Implementations

impl PageSession

pub async fn attach( endpoint: &str, engine: Engine, url_regex: Option<&str>, ) -> Result<Self>

Attach to a fresh page session over engine.

If url_regex is Some, the first page target whose URL matches is selected; otherwise the first page (or top-level browsing context) is used.

pub async fn from_bidi_cache( client: Arc<BidiClient>, url_regex: Option<&str>, ) -> Result<Self>

Build a BiDi session from a pre-opened, possibly cached client.

The MCP server uses this to share one BiDi client across tool calls; session.new is invoked only when the client was freshly opened (the caller is expected to have done so).

pub async fn attach_for_origin( endpoint: &str, engine: Engine, origin: &str, ) -> Result<Self>

Attach to (or create) a page whose document origin matches origin.

Strategy:

1. List existing page targets / browsing contexts.
2. If any has the same origin as origin, attach to it.
3. Otherwise create a new tab navigated to the origin’s root and attach to that tab.

origin is parsed for its scheme, host, and port; path/query/fragment are ignored when comparing existing target URLs.

pub async fn evaluate( &self, expression: &str, await_promise: bool, ) -> Result<Value>

Evaluate expression in the page’s main world.

await_promise = true mirrors Runtime.evaluate({awaitPromise:true}) and is appropriate for fetch / promise-returning code. The returned value is the raw result.value from CDP / BiDi after returnByValue.

pub async fn navigate(&self, url: &str) -> Result<()>

Navigate the current page to url.

pub async fn screenshot(&self, full_page: bool) -> Result<String>

Capture a PNG screenshot of the current page; returns base64 data.

pub fn engine(&self) -> Engine

Engine this session is bound to.

pub async fn close(self)

Release the underlying CDP connection (no-op for BiDi, whose client is shared via Arc).