Struct LaunchOptions 

pub struct LaunchOptions {

    pub headless: Option<bool>,
    pub executable_path: Option<String>,
    pub args: Vec<String>,
    pub channel: Option<String>,
    pub env: Option<FxHashMap<String, String>>,
    pub slow_mo: Option<u64>,
    pub timeout: Option<u64>,
    pub downloads_path: Option<PathBuf>,
    pub ignore_default_args: Option<IgnoreDefaultArgs>,
    pub handle_sighup: Option<bool>,
    pub handle_sigint: Option<bool>,
    pub handle_sigterm: Option<bool>,
    pub chromium_sandbox: Option<bool>,
    pub firefox_user_prefs: Option<FxHashMap<String, Value>>,
    pub proxy: Option<ProxyConfig>,
    pub traces_dir: Option<PathBuf>,
}

Public launch options bag, the browserType.launch(options) parameter. Selection of which browser to launch happens via the BrowserType instance you call .launch(...) on (chromium(), firefox(), webkit()); this bag only carries the per-launch knobs.

Fields

headless: Option<bool>

Run in headless mode. Defaults to true (default).

executable_path: Option<String>

Path to a browser executable to run instead of the bundled one.

args: Vec<String>

Extra command-line arguments to pass to the browser.

channel: Option<String>

Browser distribution channel (e.g. "chrome", "chrome-beta", "msedge"). Currently surface-only — the bundled-browser resolver reads this when selecting between the headless shell and a channel-specific Chrome install.

env: Option<FxHashMap<String, String>>

Environment variables to set when spawning the browser process.

slow_mo: Option<u64>

Slow down operations by this many ms (debugging).

timeout: Option<u64>

Maximum time to wait for the browser to start. 0 means no timeout. Defaults to 30_000.

downloads_path: Option<PathBuf>

Directory to use for downloads (per-context override is on BrowserContextOptions / persistent-context launch).

ignore_default_args: Option<IgnoreDefaultArgs>

If true, do not pass the bundled “default args”; if a list of strings, filter out the named default args. Currently surface-only — wired through to LaunchPlan for future filtering work.

handle_sighup: Option<bool>

Per-process signal handling — defaults all three to true (close the browser on SIGHUP / SIGINT / SIGTERM).

handle_sigint: Option<bool>

handle_sigterm: Option<bool>

chromium_sandbox: Option<bool>

Enable Chromium sandboxing. Defaults to false.

firefox_user_prefs: Option<FxHashMap<String, Value>>

Firefox about:config user-prefs map.

proxy: Option<ProxyConfig>

Network proxy applied at the browser level.

traces_dir: Option<PathBuf>

Tracing artifact directory.

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() -> LaunchOptions

Returns the “default value” for a type.