Struct Browser 

pub struct Browser {
    pub user_agent: String,
    /* private fields */
}

A browser-level CDP connection used to drive one page inside an isolated browser context (Target.createBrowserContext): its own cookie jar and storage, shared with no other tab, so nothing else in the browser can log it out and it can’t disturb the user’s tabs.

Contexts are created with disposeOnDetach: false, so the context and its tab survive this process exiting; a later process reconnects by id.

Fields

user_agent: String

The browser’s User-Agent.

Implementations

impl Browser

pub async fn connect(base: &str) -> Result<Self>

pub async fn call( &mut self, session: Option<&str>, method: &str, params: Value, ) -> Result<Value>

Raw CDP call, optionally on an attached page session.

pub async fn create_context(&mut self) -> Result<String>

Create an isolated context that outlives this connection.

pub async fn context_exists(&mut self, context: &str) -> Result<bool>

pub async fn dispose_context(&mut self, context: &str) -> Result<()>

Dispose a context we created (closes its tabs, drops its cookies).

pub async fn open_tab(&mut self, context: &str, url: &str) -> Result<String>

Open url in a new background tab of context.

pub async fn tab_in_context( &mut self, context: &str, target: &str, ) -> Result<bool>

Whether target is still a page in context.

pub async fn attach(&mut self, target: &str) -> Result<String>

Attach to a tab (flattened session) and make it behave like a focused, visible page: a background tab otherwise never runs requestAnimationFrame, and the login SPA stays on its spinner.

pub async fn eval(&mut self, session: &str, expression: &str) -> Result<Value>

Evaluate expression in the page (promises awaited) and return its JSON value. Callers must not log values that are credentials.

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

Navigate the attached page.

pub async fn click_at(&mut self, session: &str, x: f64, y: f64) -> Result<()>

A trusted left click at viewport coordinates (as a user’s would be).

pub async fn type_digits(&mut self, session: &str, digits: &str) -> Result<()>

Type ASCII digits into the focused element, one key at a time.

pub async fn context_cookies(&mut self, context: &str) -> Result<Vec<Cookie>>

The grab.com cookies of one browser context.

pub async fn default_cookies(&mut self) -> Result<Vec<Cookie>>

The grab.com cookies of the browser’s default context (the user’s normal tabs), as opposed to context_cookies.

pub async fn drain_events(&mut self, wait: Duration) -> Result<usize>

Drain buffered CDP events (e.g. after a navigation), waiting up to wait for more. Returns how many were seen.