Struct BrowserSession 

pub struct BrowserSession { /* private fields */ }

A browser session that wraps thirtyfour’s WebDriver.

This is the core abstraction for browser automation in ADK. It can be shared across multiple tools via Arc<BrowserSession>.

Implementations

impl BrowserSession

pub fn new(config: BrowserConfig) -> Self

Create a new browser session with the given configuration.

Note: This does not start the browser immediately. Call start() to initialize the WebDriver connection.

pub fn with_defaults() -> Self

Create a browser session with default configuration.

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

Start the browser session by connecting to WebDriver.

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

Stop the browser session.

pub async fn is_active(&self) -> bool

Check if the session is active.

pub fn config(&self) -> &BrowserConfig

Get the configuration.

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

Navigate to a URL.

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

Get the current URL.

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

Get the page title.

pub async fn find_element(&self, selector: &str) -> Result<WebElement>

Find an element by CSS selector.

pub async fn find_elements(&self, selector: &str) -> Result<Vec<WebElement>>

Find multiple elements by CSS selector.

pub async fn find_by_xpath(&self, xpath: &str) -> Result<WebElement>

Find element by XPath.

pub async fn click(&self, selector: &str) -> Result<()>

Click an element by selector.

pub async fn type_text(&self, selector: &str, text: &str) -> Result<()>

Type text into an element.

pub async fn clear(&self, selector: &str) -> Result<()>

Clear an input field.

pub async fn get_text(&self, selector: &str) -> Result<String>

Get text content of an element.

pub async fn get_attribute( &self, selector: &str, attribute: &str, ) -> Result<Option<String>>

Get an attribute value.

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

Take a screenshot (returns base64-encoded PNG).

pub async fn screenshot_element(&self, selector: &str) -> Result<String>

Take a screenshot of a specific element.

pub async fn execute_script(&self, script: &str) -> Result<Value>

Execute JavaScript and return result.

pub async fn execute_async_script(&self, script: &str) -> Result<Value>

Execute async JavaScript and return result.

pub async fn wait_for_element( &self, selector: &str, timeout_secs: u64, ) -> Result<WebElement>

Wait for an element to be present.

pub async fn wait_for_clickable( &self, selector: &str, timeout_secs: u64, ) -> Result<WebElement>

Wait for an element to be clickable.

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

Get page source HTML.

pub async fn back(&self) -> Result<()>

Go back in history.

pub async fn forward(&self) -> Result<()>

Go forward in history.

pub async fn refresh(&self) -> Result<()>

Refresh the current page.

pub async fn get_all_cookies(&self) -> Result<Vec<Value>>

Get all cookies.

pub async fn get_cookie(&self, name: &str) -> Result<Value>

Get a cookie by name.

pub async fn add_cookie( &self, name: &str, value: &str, domain: Option<&str>, path: Option<&str>, secure: Option<bool>, _expiry: Option<i64>, ) -> Result<()>

Add a cookie.

pub async fn delete_cookie(&self, name: &str) -> Result<()>

Delete a cookie.

pub async fn delete_all_cookies(&self) -> Result<()>

Delete all cookies.

pub async fn list_windows(&self) -> Result<(Vec<String>, String)>

List all windows/tabs.

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

Open a new tab.

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

Open a new window.

pub async fn switch_to_window(&self, handle: &str) -> Result<()>

Switch to a window by handle.

pub async fn close_window(&self) -> Result<()>

Close the current window.

pub async fn maximize_window(&self) -> Result<()>

Maximize window.

pub async fn minimize_window(&self) -> Result<()>

Minimize window.

pub async fn set_window_rect( &self, x: i32, y: i32, width: u32, height: u32, ) -> Result<()>

Set window size and position.

pub async fn switch_to_frame_by_index(&self, index: u16) -> Result<()>

Switch to frame by index.

pub async fn switch_to_frame_by_selector(&self, selector: &str) -> Result<()>

Switch to frame by selector.

pub async fn switch_to_parent_frame(&self) -> Result<()>

Switch to parent frame.

pub async fn switch_to_default_content(&self) -> Result<()>

Switch to default content.

pub async fn drag_and_drop( &self, source_selector: &str, target_selector: &str, ) -> Result<()>

Drag and drop.

pub async fn right_click(&self, selector: &str) -> Result<()>

Right-click (context click).

pub async fn focus_element(&self, selector: &str) -> Result<()>

Focus an element.

pub async fn get_element_state(&self, selector: &str) -> Result<ElementState>

Get element state.

pub async fn press_key( &self, key: &str, selector: Option<&str>, _modifiers: &[&str], ) -> Result<()>

Press a key.

pub async fn upload_file(&self, selector: &str, file_path: &str) -> Result<()>

Upload a file.

pub async fn print_to_pdf(&self, landscape: bool, scale: f64) -> Result<String>

Print page to PDF.

Trait Implementations

impl Drop for BrowserSession

fn drop(&mut self)

Executes the destructor for this type.