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 cookie_manager(&self) -> Result<CookieManager>

Get a cookie manager for the current browser context

pub fn console_manager(&self) -> Result<ConsoleManager>

Get a console log manager for the current browser context

pub fn storage_manager(&self) -> StorageManager

Get a storage manager for the current browser context

pub fn viewport_manager(&self) -> Result<ViewportManager>

Get a viewport manager for the current browser context

pub fn pdf_manager(&self) -> Result<PdfManager>

Get a PDF manager for the current browser context

pub fn download_manager(&self) -> Result<DownloadManager>

Get a download manager for the current browser context

pub fn auth_manager(&self) -> Result<AuthManager>

Get an auth manager for the current browser context

pub fn performance_manager(&self) -> Result<PerformanceManager>

Get a performance manager for the current browser context

pub fn har_manager(&self) -> Result<HarManager>

Get a HAR manager for the current browser context

pub fn coverage_manager(&self) -> Result<CoverageManager>

Get a coverage manager for the current browser context

pub fn network_interceptor(&self) -> Result<NetworkInterceptor>

Get a network interceptor for the current browser context

pub fn dialog_manager(&self) -> Result<DialogManager>

Get a dialog manager for the current browser context

pub fn filechooser_manager(&self) -> Result<FileChooserManager>

Get a file chooser manager for the current browser context

pub fn permissions_manager(&self) -> Result<PermissionsManager>

Get a permissions manager for the current browser context

pub fn tracing_manager(&self) -> Result<TracingManager>

Get a tracing manager for the current browser context

pub async fn raw_cdp_command( &self, method: &str, params: Value, ) -> Result<Value>

Send a raw CDP command directly (power-user access to unwrapped CDP features). Returns the raw JSON response from the browser.

pub fn touch_manager(&self) -> Result<TouchManager>

Get a touch manager for the current browser context

pub fn worker_manager(&self) -> Result<WorkerManager>

Get a worker manager for the current browser context

pub fn service_worker_manager(&self) -> Result<ServiceWorkerManager>

Get a service worker manager for the current browser context

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_session_info(&self) -> Result<SessionInfo>

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

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

Get browser state summary

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_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)

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 cookie_manager(&self) -> Result<CookieManager>

Get a cookie manager for the current browser context

fn console_manager(&self) -> Result<ConsoleManager>

Get a console log manager for the current browser context

fn storage_manager(&self) -> StorageManager

Get a storage manager for the current browser context

fn viewport_manager(&self) -> Result<ViewportManager>

Get a viewport manager for the current browser context

fn pdf_manager(&self) -> Result<PdfManager>

Get a PDF manager for the current browser context

fn download_manager(&self) -> Result<DownloadManager>

Get a download manager for the current browser context

fn auth_manager(&self) -> Result<AuthManager>

Get an auth manager for the current browser context

fn performance_manager(&self) -> Result<PerformanceManager>

Get a performance manager for the current browser context

fn har_manager(&self) -> Result<HarManager>

Get a HAR manager for the current browser context

fn coverage_manager(&self) -> Result<CoverageManager>

Get a coverage manager for the current browser context

fn network_interceptor(&self) -> Result<NetworkInterceptor>

Get a network interceptor for the current browser context

fn dialog_manager(&self) -> Result<DialogManager>

Get a dialog manager for the current browser context

fn filechooser_manager(&self) -> Result<FileChooserManager>

Get a file chooser manager for the current browser context

fn permissions_manager(&self) -> Result<PermissionsManager>

Get a permissions manager for the current browser context

fn tracing_manager(&self) -> Result<TracingManager>

Get a tracing manager for the current browser context

fn raw_cdp_command<'life0, 'life1, 'async_trait>( &'life0 self, method: &'life1 str, params: Value, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'async_trait>>

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

Send a raw CDP command directly (power-user access to unwrapped CDP features)

fn touch_manager(&self) -> Result<TouchManager>

Get a touch manager for the current browser context

fn worker_manager(&self) -> Result<WorkerManager>

Get a worker manager for the current browser context

fn service_worker_manager(&self) -> Result<ServiceWorkerManager>

Get a service worker manager for the current browser context