Struct ChromiumOptions 

pub struct ChromiumOptions {
    pub executable_path: Option<PathBuf>,
    pub user_data_dir: Option<PathBuf>,
    pub cookies: Vec<Cookie>,
    pub headers: Vec<(String, String)>,
    pub auth_script: Option<PathBuf>,
    pub storage_state: Option<PathBuf>,
    pub auto_fetch_chromium: bool,
    pub auto_fetch_cache_dir: Option<PathBuf>,
}

Configuration for ChromiumDriver.

Fields

executable_path: Option<PathBuf>

Explicit Chrome or Chromium executable path. When unset, Plumb asks chromiumoxide to detect stable Chrome/Chromium installations.

user_data_dir: Option<PathBuf>

Override the Chromium profile directory. When unset, chromiumoxide reuses a single temp directory across all launches — which is fine for sequential CLI invocations but causes profile-singleton lock contention when multiple drivers run concurrently (e.g. the e2e test suite). Tests pass per-thread tempdirs here.

Profile contents do not flow into PlumbSnapshot output, so varying this path does not violate the determinism invariant.

cookies: Vec<Cookie>

Cookies to install before navigation (PRD §15 — --cookie). Iterated in (name, value) order for deterministic CDP traffic.

headers: Vec<(String, String)>

Extra HTTP headers to attach to every request (PRD §15 — --header). Sorted by name on injection so CDP traffic is stable across runs.

auth_script: Option<PathBuf>

Path to a JavaScript file evaluated on every new document via Page.addScriptToEvaluateOnNewDocument before navigation (PRD §15 — --auth-script).

storage_state: Option<PathBuf>

Path to a Playwright storage-state.json file. Cookies in the file are installed before navigation; localStorage entries are preserved as a parsed StorageState for downstream evaluation after navigation when the origin matches.

auto_fetch_chromium: bool

Opt-in: when no Self::executable_path is set and no system Chromium is detected, download Chrome-for-Testing pinned at MIN_SUPPORTED_CHROMIUM_MAJOR into a Plumb-managed cache directory and verify its SHA-256 before launch. Defaults to false. See fetcher for the security trade-offs.

auto_fetch_cache_dir: Option<PathBuf>

Override the auto-fetch cache directory. When None, Plumb resolves the platform default via fetcher::resolve_cache_dir. Useful for tests that want a tempdir-scoped cache and for callers that ship Chromium alongside their app.

Trait Implementations

impl Clone for ChromiumOptions

fn clone(&self) -> ChromiumOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChromiumOptions

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

Formats the value using the given formatter.

impl Default for ChromiumOptions

fn default() -> ChromiumOptions

Returns the “default value” for a type.

impl Eq for ChromiumOptions

impl PartialEq for ChromiumOptions

fn eq(&self, other: &ChromiumOptions) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ChromiumOptions