Struct StealthConfig 

pub struct StealthConfig {
    pub user_agent: Option<String>,
    pub viewport_width: u32,
    pub viewport_height: u32,
    pub locale: String,
    pub inject_js: Option<String>,
    pub use_builtin_stealth: bool,
    pub bypass_csp: bool,
}

Configuration for browser stealth features that help avoid bot detection.

Fields

user_agent: Option<String>

User-Agent string override. None = use browser default.

viewport_width: u32

Viewport width in pixels.

viewport_height: u32

Viewport height in pixels.

locale: String

Accept-Language header value.

inject_js: Option<String>

JavaScript snippet injected via Page.addScriptToEvaluateOnNewDocument before every page load. Runs in the page’s main world.

use_builtin_stealth: bool

Whether to use chromiumoxide’s built-in enable_stealth_mode.

bypass_csp: bool

Whether to bypass Content-Security-Policy for JS injection.

Implementations

impl StealthConfig

pub fn chrome_like() -> Self

Preset that mimics a real desktop Chrome session.

This follows the zendriver / nodriver philosophy: rely on clean Chrome launch flags rather than heavy JS injection. We do NOT override the user-agent (avoids version mismatches with the real browser) and we do NOT use chromiumoxide’s built-in stealth mode (it fires multiple addScriptToEvaluateOnNewDocument CDP calls that sophisticated WAFs can fingerprint).

No JS is injected at all: navigator.webdriver comes out false from the launch flag, and the old force-open-shadow-DOM patch is gone (it broke Cloudflare Turnstile’s closed-shadow tamper check). UA / platform / Client-Hints consistency is applied via CDP setUserAgentOverride (see Page::apply_stealth), not page-world JS.

pub fn none() -> Self

Minimal config — no overrides, no injection, just headless defaults.

Trait Implementations

impl Clone for StealthConfig

fn clone(&self) -> StealthConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StealthConfig

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

Formats the value using the given formatter.

impl Default for StealthConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for StealthConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for StealthConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.