Struct BrowserConfigBuilder 

pub struct BrowserConfigBuilder { /* private fields */ }

Fluent builder for BrowserConfig.

Implementations

impl BrowserConfigBuilder

pub fn chrome_path(self, path: PathBuf) -> Self

Set path to the Chrome executable.

pub const fn headless(self, headless: bool) -> Self

Set headless mode.

pub const fn window_size(self, width: u32, height: u32) -> Self

Set browser viewport / window size.

pub const fn devtools(self, enabled: bool) -> Self

Enable or disable DevTools attachment.

pub fn proxy(self, proxy: String) -> Self

Set proxy URL.

pub fn proxy_bypass_list(self, bypass: String) -> Self

Set a comma-separated proxy bypass list.

Example

use stygian_browser::BrowserConfig;
let cfg = BrowserConfig::builder()
    .proxy("http://proxy:8080".to_string())
    .proxy_bypass_list("<local>,localhost".to_string())
    .build();
assert!(cfg.effective_args().iter().any(|a| a.contains("proxy-bypass")));

pub fn webrtc(self, webrtc: WebRtcConfig) -> Self

Set WebRTC IP-leak prevention config.

Example

use stygian_browser::BrowserConfig;
use stygian_browser::webrtc::{WebRtcConfig, WebRtcPolicy};
let cfg = BrowserConfig::builder()
    .webrtc(WebRtcConfig { policy: WebRtcPolicy::BlockAll, ..Default::default() })
    .build();
assert!(cfg.effective_args().iter().any(|a| a.contains("disable_non_proxied")));

pub fn arg(self, arg: String) -> Self

Append a custom Chrome argument.

pub const fn stealth_level(self, level: StealthLevel) -> Self

Set the stealth level.

pub const fn cdp_fix_mode(self, mode: CdpFixMode) -> Self

Set the CDP leak-mitigation mode.

Example

use stygian_browser::BrowserConfig;
use stygian_browser::cdp_protection::CdpFixMode;
let cfg = BrowserConfig::builder()
    .cdp_fix_mode(CdpFixMode::IsolatedWorld)
    .build();
assert_eq!(cfg.cdp_fix_mode, CdpFixMode::IsolatedWorld);

pub fn source_url(self, url: Option<String>) -> Self

Override the sourceURL injected into CDP scripts, or pass None to disable sourceURL patching.

Example

use stygian_browser::BrowserConfig;
let cfg = BrowserConfig::builder()
    .source_url(Some("main.js".to_string()))
    .build();
assert_eq!(cfg.source_url.as_deref(), Some("main.js"));

pub const fn pool(self, pool: PoolConfig) -> Self

Override pool settings.

pub fn build(self) -> BrowserConfig

Build the final BrowserConfig.