Struct BrowserConfig 

pub struct BrowserConfig {
    pub webdriver_url: String,
    pub browser: BrowserType,
    pub headless: bool,
    pub viewport_width: u32,
    pub viewport_height: u32,
    pub page_load_timeout_secs: u64,
    pub script_timeout_secs: u64,
    pub implicit_wait_secs: u64,
    pub user_agent: Option<String>,
    pub browser_args: Vec<String>,
    pub require_explicit_start: bool,
    pub chrome_options: BTreeMap<String, Value>,
}

Configuration for browser sessions.

Fields

webdriver_url: String

WebDriver server URL (e.g., “http://localhost:4444”)

browser: BrowserType

Browser type to use

headless: bool

Run in headless mode (no visible window)

viewport_width: u32

Viewport width in pixels

viewport_height: u32

Viewport height in pixels

page_load_timeout_secs: u64

Page load timeout in seconds

script_timeout_secs: u64

Script execution timeout in seconds

implicit_wait_secs: u64

Implicit wait timeout in seconds

user_agent: Option<String>

User agent string override

browser_args: Vec<String>

Additional browser arguments

require_explicit_start: bool

Require the host to start the session, and to start it again after it is lost, instead of tools starting or recreating it on first use.

chrome_options: BTreeMap<String, Value>

Chrome options under goog:chromeOptions, such as binary and prefs, supplied by the execution host. Chrome only. Command-line flags belong in browser_args; an args entry here is rejected when the session starts.

Implementations

impl BrowserConfig

pub fn new() -> Self

Create a new config with default values.

pub fn webdriver_url(self, url: impl Into<String>) -> Self

Set the WebDriver URL.

pub fn browser(self, browser: BrowserType) -> Self

Set the browser type.

pub fn headless(self, headless: bool) -> Self

Enable or disable headless mode.

pub fn viewport(self, width: u32, height: u32) -> Self

Set the viewport size.

pub fn page_load_timeout(self, secs: u64) -> Self

Set page load timeout.

pub fn user_agent(self, ua: impl Into<String>) -> Self

Set a custom user agent.

pub fn add_arg(self, arg: impl Into<String>) -> Self

Add a browser argument.

pub fn require_explicit_start(self, required: bool) -> Self

Require explicit BrowserSession::start() calls instead of automatic startup.

Example

use adk_browser::BrowserConfig;

let config = BrowserConfig::new().require_explicit_start(true);
assert!(config.require_explicit_start);

pub fn chrome_option(self, name: impl Into<String>, value: Value) -> Self

Set a Chrome option under goog:chromeOptions, such as binary or prefs.

Command-line flags belong in add_arg; an args option is rejected when the session starts.

Example

use adk_browser::BrowserConfig;

let config = BrowserConfig::new()
    .chrome_option("binary", serde_json::json!("/opt/chromium"))
    .chrome_option("prefs", serde_json::json!({"download.default_directory": "/tmp/dl"}));
assert_eq!(config.chrome_options["binary"], "/opt/chromium");

pub fn observable(self) -> Self

Configure for observable mode (noVNC-compatible).

Sets headless: false and viewport to 1280x720 for noVNC viewing. Use this when running with Selenium’s noVNC viewer (port 7900).

Trait Implementations

impl Clone for BrowserConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BrowserConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BrowserConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BrowserConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BrowserConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.