Struct RealBrowserOptions 

pub struct RealBrowserOptions {

    pub engine: EngineType,
    pub channel: String,
    pub executable_path: Option<PathBuf>,
    pub user_data_dir: Option<PathBuf>,
    pub remote_debugging_port: u16,
    pub headless: bool,
    pub args: Vec<String>,
    pub extra_args: Vec<String>,
    pub ignore_default_args: Vec<String>,
    pub ignore_all_default_args: bool,
    pub startup_timeout: Duration,
    pub slow_mo: u64,
    pub timeout: Option<Duration>,
    pub protocol_timeout: Option<Duration>,
    pub seed_cookies: Vec<Value>,
    pub verbose: bool,
    pub node_executable: Option<PathBuf>,
    pub node_working_dir: Option<PathBuf>,
    pub downloads: DownloadSetting,
}

Options for launching an installed browser and attaching over CDP.

Fields

engine: EngineType

Browser Commander engine used after the browser starts.

channel: String

Installed Chrome-family channel to discover.

executable_path: Option<PathBuf>

Explicit installed-browser executable, bypassing channel discovery.

user_data_dir: Option<PathBuf>

Dedicated, non-default browser profile.

remote_debugging_port: u16

Loopback CDP port. Zero lets Chrome choose an available port.

headless: bool

Run the installed browser headlessly.

args: Vec<String>

Additional browser arguments.

extra_args: Vec<String>

Additional browser arguments appended after the compatibility args.

ignore_default_args: Vec<String>

Browser Commander default arguments to omit.

ignore_all_default_args: bool

Omit every Browser Commander default argument.

startup_timeout: Duration

Maximum time to wait for Chrome’s /json/version endpoint.

slow_mo: u64

Delay Playwright/Puppeteer operations by this many milliseconds.

timeout: Option<Duration>

Optional connection timeout.

protocol_timeout: Option<Duration>

Optional Puppeteer timeout for individual CDP calls.

seed_cookies: Vec<Value>

Cookies to seed immediately after attaching.

verbose: bool

Enable browser and connector logging.

node_executable: Option<PathBuf>

Node.js executable for Playwright/Puppeteer bridge engines.

node_working_dir: Option<PathBuf>

Directory where Node resolves Playwright/Puppeteer.

downloads: DownloadSetting

Manage the installed browser’s downloads.

The same setting and the same manager as LaunchOptions and ConnectOptions, which is what makes a download started by hand in a visible window land where an automated one does. See downloads.

Implementations

impl RealBrowserOptions

pub fn chromiumoxide() -> Self

Create native Chromiumoxide options.

pub fn playwright() -> Self

Create Playwright bridge options.

pub fn puppeteer() -> Self

Create Puppeteer bridge options.

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

Select an installed browser channel.

pub fn executable_path(self, executable_path: impl Into<PathBuf>) -> Self

Select an explicit installed-browser executable.

pub fn user_data_dir(self, user_data_dir: impl Into<PathBuf>) -> Self

Select a dedicated browser profile.

pub fn remote_debugging_port(self, port: u16) -> Self

Select a loopback CDP port. Zero asks Chrome to allocate one.

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

Enable or disable headless mode.

pub fn with_args(self, args: Vec<String>) -> Self

Set additional browser arguments.

pub fn with_extra_args(self, args: Vec<String>) -> Self

Add browser arguments after the compatibility args field.

pub fn ignore_default_args(self, args: Vec<String>) -> Self

Omit selected Browser Commander defaults.

pub fn ignore_all_default_args(self) -> Self

Omit every Browser Commander default argument.

pub fn startup_timeout(self, timeout: Duration) -> Self

Set the CDP readiness timeout.

pub fn slow_mo(self, milliseconds: u64) -> Self

Set the engine operation delay.

pub fn timeout(self, timeout: Duration) -> Self

Set the connection timeout.

pub fn protocol_timeout(self, timeout: Duration) -> Self

Set Puppeteer’s timeout for individual CDP calls.

pub fn seed_cookies(self, cookies: Vec<Value>) -> Self

Seed cookies after attaching.

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

Enable launch and connection logging.

pub fn node_executable(self, executable: impl Into<PathBuf>) -> Self

Override the Node.js executable for bridge engines.

pub fn node_working_dir(self, directory: impl Into<PathBuf>) -> Self

Set the directory where Node resolves Playwright/Puppeteer.

pub fn downloads(self, downloads: impl Into<DownloadSetting>) -> Self

Manage the installed browser’s downloads.

Arguments

• downloads - true for the defaults, false for none, or DownloadOptions

pub fn get_user_data_dir(&self) -> PathBuf

Resolve the configured or managed dedicated profile path.

Trait Implementations

impl Clone for RealBrowserOptions

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 RealBrowserOptions

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

Formats the value using the given formatter.

impl Default for RealBrowserOptions

fn default() -> Self

Returns the “default value” for a type.