Struct FoxBrowserConfig 

pub struct FoxBrowserConfig {
    pub executable_path: Option<String>,
    pub profile_dir: Option<String>,
    pub headless: bool,
    pub viewport_width: u32,
    pub viewport_height: u32,
    pub user_agent: Option<String>,
    pub user_js_content: Option<String>,
    pub proxy: Option<ProxyConfig>,
    pub unhandled_prompt_behavior: Option<String>,
    pub env: Vec<(String, String)>,
}

Fields

executable_path: Option<String>

profile_dir: Option<String>

Firefox profile directory.

Supply a STABLE path to get a PERSISTENT persona: cookies, localStorage, IndexedDB, and the per-identity device fingerprint (canvas/audio seed, when launched via guise) all survive a restart that reuses the same path, a returning logged-in user, not a brand-new browser each launch. Persistence requires the session to end through Page::close, which performs the clean browser.close shutdown that flushes Firefox’s QuotaManager storage to disk (a bare SIGKILL would lose unflushed localStorage/IndexedDB).

None synthesizes a fresh temporary profile per launch, an ephemeral, one-shot persona with no cross-launch state.

headless: bool

viewport_width: u32

viewport_height: u32

user_agent: Option<String>

user_js_content: Option<String>

Raw user.js content to write into the profile directory before Firefox starts. The caller (typically guise) is responsible for building this string from profile overrides.

proxy: Option<ProxyConfig>

Optional upstream proxy. Emitted as network.proxy.* prefs appended to user_js_content at launch (requires profile_dir).

unhandled_prompt_behavior: Option<String>

How Firefox handles JS user prompts (alert/confirm/prompt/ beforeunload). One of accept, dismiss, ignore, dismiss and notify. None keeps the BiDi default (dismiss and notify), which never hangs and still emits the events the dialog log records. Set ignore to keep prompts OPEN so Page::handle_user_prompt can answer them; set accept to auto-accept (a confirm() guard returns true, beforeunload never blocks navigation).

env: Vec<(String, String)>

Extra environment variables to set on the spawned Firefox process, on top of the inherited parent env. ONLY honored by launch_firefox_self_managed (foxdriver owns that spawn); the rustenium-managed launch_firefox cannot set per-process env. The canonical use is TZ=<IANA zone> so ICU reports the persona timezone in EVERY realm, including dedicated Workers, which a window-realm JS Intl/Date preload can never reach (a worker that read the host zone while the window claimed the persona zone was a trivially-detected leak). Per-process, so concurrent launches with different zones never race (unlike mutating the parent process’s TZ).

Trait Implementations

impl Clone for FoxBrowserConfig

fn clone(&self) -> FoxBrowserConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FoxBrowserConfig

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

Formats the value using the given formatter.

impl Default for FoxBrowserConfig

fn default() -> FoxBrowserConfig

Returns the “default value” for a type.