Crate runtime_foxdriver 

runtime-foxdriver

Firefox browser automation via WebDriver BiDi (rustenium).

This crate provides a spawn-capable Firefox runtime: launch, drive, evaluate, click, type, scroll, screenshot, cookies, dialogs, and cross-origin frame graphs. It is intentionally independent of guise (the stealth substrate) so the fleet’s layering stays one-way: guise may depend on foxdriver for its browser feature, but foxdriver knows nothing about stealth profiles, fingerprint bundles, or TLS impersonation.

Quick start

use runtime_foxdriver::{drive_browser, BrowserDriveOptions};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    drive_browser("https://example.com", BrowserDriveOptions::default(), |page| async move {
        let res = page.evaluate("document.title").await?;
        let title: String = res.into_value()?;
        println!("Page title: {title}");
        Ok(())
    }).await
}

When to use / when not to use

When to use

• Driving Firefox browsers natively via WebDriver BiDi for automation or scanning.
• Capturing passive network traffic, JS dialogs, page downloads, and DOM security signals.
• Traversing cross-origin iframe hierarchies and translating frame coordinates to main viewport space.

When not to use

• You need stealth/fingerprint spoofing directly: use guise::browser (which wraps foxdriver with stealth profiles).
• You need Chromium / Playwright / CDP-specific driver bindings: use the corresponding runtime driver crate.

Compared to alternatives

Unlike raw selenium or marionette drivers, runtime-foxdriver uses WebDriver BiDi event streams for async, non-blocking telemetry and robust readiness-polled browser launches.

Compared to headless chromium drivers, Firefox via BiDi provides native gecko rendering, full cross-origin OOPIF frame graph traversal, and clean SIGTERM graceful profile persistence before shutdown.

How it fits in Santh

runtime-foxdriver lives in libs/runtime as the primary Firefox browser driver primitive in Santh. Higher-level automation tools and stealth engines (such as guise) build on top of runtime-foxdriver.

License

MIT OR Apache-2.0

Re-exports

pub use browser::launch_firefox;

pub use browser::launch_firefox_self_managed;

pub use browser::proxy_prefs;

pub use browser::Element;

pub use browser::EvaluationResult;

pub use browser::FoxBrowserConfig;

pub use browser::FrameId;

pub use browser::FrameInfo;

pub use browser::FrameTreeNode;

pub use browser::Page;

pub use browser::ProxyConfig;

pub use browser::ProxyScheme;

pub use browser::ScrollDirection;

pub use cookies::CapturedCookie;

pub use dialog::CapturedDialog;

pub use dialog::CapturedDownload;

pub use dialog::DialogLog;

pub use frame_graph::FrameGraph;

pub use frame_graph::FrameNode;

pub use network::CapturedHeader;

pub use network::CapturedRequest;

pub use network::CapturedResponse;

pub use network::Filter;

pub use network::NetworkEntry;

pub use network::NetworkLog;

pub use runtime::drive_browser;

pub use runtime::BrowserDriveOptions;

Modules

browser

Firefox browser automation via rustenium (WebDriver BiDi).

cookies

Captured browser cookies, preserve a solved-captcha session across page loads.

dialog

JS dialog (alert/confirm/prompt/beforeunload) and page-initiated download capture via WebDriver BiDi browsingContext.* events.

frame

Cross-origin iframe evaluation helpers.

frame_graph

Frame + shadow-root graph for the current page.

network

Passive network instrumentation for BiDi browsers.

runtime

Browser launch via rustenium Firefox (replaces runtime_headless).

sensors

The Omniscient Page: a passive, always-on instrumentation grid injected into every page’s MAIN world before its scripts run.