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 color_scheme: Option<ColorScheme>,
    pub launch_timeout: Option<Duration>,
    pub sandbox: bool,
}

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.

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.

Implementations

impl LaunchOptions

pub fn chromiumoxide() -> Self

Create options for chromiumoxide engine.

pub fn fantoccini() -> Self

Create options for fantoccini (WebDriver) engine.

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 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 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.