Struct Browser 

pub struct Browser { /* private fields */ }

Browser session for managing CDP connections

Implementations

impl Browser

pub fn new(profile: BrowserProfile) -> Self

Create a new Browser session with given profile

pub fn with_cdp_url(self, cdp_url: String) -> Self

Set CDP URL to connect to existing browser instead of launching new one

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

Start the browser session (launches browser or connects to existing)

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

Navigate to the specified URL

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

Get the current page URL

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

Stop the browser session and clean up resources

Safety Policy

IMPORTANT: This method does NOT delete browser data directories.

We never cleanup user data for safety reasons:

• Users may specify a custom user_data_dir pointing to their real browser profile
• Deleting user data (bookmarks, history, passwords, extensions) would be catastrophic
• Temporary profiles are preserved for debugging and inspection

Users are responsible for managing their own browser data directories.

pub fn get_cdp_client(&self) -> Result<Arc<CdpClient>>

Get the CDP client for the current session

pub fn get_session_id(&self) -> Result<String>

Get the session ID for the current target

pub fn get_page(&self) -> Result<Page>

Get a Page actor for the current session

pub fn get_current_target_id(&self) -> Result<String>

Get the current target ID

pub async fn take_screenshot( &self, path: Option<&str>, full_page: bool, format: Option<&str>, quality: Option<u32>, ) -> Result<Vec<u8>>

Take a screenshot of the current page

pub async fn get_tabs(&self) -> Result<Vec<TabInfo>>

Get all open tabs

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

Create a new tab

pub async fn switch_to_tab(&mut self, target_id: &str) -> Result<()>

Switch to a different tab by target ID

pub async fn close_tab(&mut self, target_id: &str) -> Result<()>

Close a tab by target ID

pub async fn get_target_id_from_tab_id(&self, tab_id: &str) -> Result<String>

Get target ID from short tab ID (last 4 characters)

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

Get the current page title

pub async fn get_browser_state_summary( &self, include_screenshot: bool, dom_service: Option<&DomService>, ) -> Result<BrowserStateSummary>

Get browser state summary for LLM consumption

Trait Implementations

impl BrowserClient for Browser

fn start<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Start the browser session

fn stop<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Stop the browser session and clean up resources gracefully. Default does nothing (for mocks or external browsers we don’t own).

fn navigate<'life0, 'life1, 'async_trait>( &'life0 mut self, url: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Navigate to the specified URL

fn get_current_url<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get the current page URL

fn create_tab<'life0, 'life1, 'async_trait>( &'life0 mut self, url: Option<&'life1 str>, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Create a new tab with optional URL

fn switch_to_tab<'life0, 'life1, 'async_trait>( &'life0 mut self, target_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Switch to a different tab by target ID

fn close_tab<'life0, 'life1, 'async_trait>( &'life0 mut self, target_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Close a tab by target ID

fn get_tabs<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<TabInfo>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get all open tabs

fn get_target_id_from_tab_id<'life0, 'life1, 'async_trait>( &'life0 self, tab_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get target ID from short tab ID (last 4 characters)

fn get_page(&self) -> Result<Page>

Get a Page actor for the current session

fn take_screenshot<'life0, 'life1, 'async_trait>( &'life0 self, path: Option<&'life1 str>, full_page: bool, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Take a screenshot of the current page

fn get_current_page_title<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

👎Deprecated since 0.1.2: Use get_session_info() instead

Get the current page title

fn get_cdp_client(&self) -> Result<Arc<CdpClient>>

Get the CDP client for the current session

fn get_session_id(&self) -> Result<String>

👎Deprecated since 0.1.2: Use get_session_info() instead

Get the session ID for the current target

fn get_current_target_id(&self) -> Result<String>

👎Deprecated since 0.1.2: Use get_session_info() instead

Get the current target ID

fn get_session_info<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<SessionInfo>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get streamlined session information (URL, title, target ID, session ID)