Struct LaunchOptions 

pub struct LaunchOptions {

    pub engine: EngineType,
    pub user_data_dir: Option<PathBuf>,
    pub headless: bool,
    pub slow_mo: u64,
    pub verbose: bool,
    pub args: Vec<String>,
    pub extra_args: Vec<String>,
    pub ignore_default_args: Vec<String>,
    pub ignore_all_default_args: bool,
    pub channel: Option<String>,
    pub executable_path: Option<PathBuf>,
    pub color_scheme: Option<ColorScheme>,
    pub launch_timeout: Option<Duration>,
    pub sandbox: bool,
    pub node_executable: Option<PathBuf>,
    pub node_working_dir: Option<PathBuf>,
}

Options for launching a browser.

Fields

engine: EngineType

The browser engine to use.

user_data_dir: Option<PathBuf>

Path to user data directory.

headless: bool

Run in headless mode.

slow_mo: u64

Slow down operations by this many milliseconds.

verbose: bool

Enable verbose logging.

args: Vec<String>

Additional Chrome arguments.

extra_args: Vec<String>

Additional Chrome 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 and engine default argument.

channel: Option<String>

Installed browser channel for Playwright/Puppeteer (for example, chrome).

executable_path: Option<PathBuf>

Explicit path to a Chrome or Chromium executable.

color_scheme: Option<ColorScheme>

Color scheme to emulate. None uses the system default.

launch_timeout: Option<Duration>

Optional timeout for the browser launch handshake.

sandbox: bool

Whether to run the browser with the Chromium sandbox enabled.

Defaults to true. Disable when running in environments where the sandbox is unavailable (e.g. CI containers without the required capabilities). This translates to the --no-sandbox / --disable-setuid-sandbox Chromium flags.

node_executable: Option<PathBuf>

Node.js executable for Playwright/Puppeteer fallback engines.

node_working_dir: Option<PathBuf>

Working directory used to resolve Playwright/Puppeteer Node packages.

Implementations

impl LaunchOptions

pub fn engine(self, engine: EngineType) -> Self

Set the browser automation engine.

pub fn chromiumoxide() -> Self

Create options for chromiumoxide engine.

pub fn fantoccini() -> Self

Create options for fantoccini (WebDriver) engine.

pub fn playwright() -> Self

Create options for Playwright through the Node.js CLI bridge.

pub fn puppeteer() -> Self

Create options for Puppeteer through the Node.js CLI bridge.

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

Set headless mode.

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

Set the user data directory.

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

Set slow motion delay.

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

Enable verbose logging.

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

Add additional Chrome arguments.

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

Add Chrome 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 and engine default argument.

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

Select an installed browser channel for Playwright or Puppeteer.

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

Select an explicit Chrome or Chromium executable.

pub fn color_scheme(self, color_scheme: ColorScheme) -> Self

Set the color scheme for media emulation.

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

Override the browser launch timeout.

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

Enable or disable the Chromium sandbox for the launched browser.

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

Override the Node.js executable used by Playwright/Puppeteer engines.

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

Set the directory where Node resolves playwright or puppeteer.

pub fn all_chrome_args(&self) -> Vec<String>

Get all Chrome arguments (default + custom).

pub fn get_user_data_dir(&self) -> PathBuf

Get the user data directory, using a default if not specified.

Trait Implementations

impl Clone for LaunchOptions

fn clone(&self) -> LaunchOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LaunchOptions

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

Formats the value using the given formatter.

impl Default for LaunchOptions

fn default() -> Self

Returns the “default value” for a type.