Struct ChromeCapabilities 

pub struct ChromeCapabilities {
    pub base_capabilities: CapabilityRequest,
    pub chrome_options: ChromeOptions,
}

Chrome-specific capabilities for configuring browser behavior.

This struct provides a fluent API for setting Chrome capabilities and options. Use the builder methods to configure the browser, then call build() to generate the capabilities request for session creation.

Examples

use rustenium::browsers::ChromeCapabilities;

let mut caps = ChromeCapabilities::default();
caps.add_arg("--headless")
    .add_arg("--disable-gpu")
    .accept_insecure_certs(true);

let capabilities_request = caps.build();

Fields

base_capabilities: CapabilityRequest

chrome_options: ChromeOptions

Implementations

impl ChromeCapabilities

pub fn new(base_capabilities: Option<CapabilityRequest>) -> Self

Creates a new ChromeCapabilities instance.

pub fn accept_insecure_certs(&mut self, accept: bool) -> &mut Self

Sets whether to accept insecure (self-signed) certificates.

pub fn browser_name(&mut self, name: impl Into<String>) -> &mut Self

Sets the browser name.

pub fn browser_version(&mut self, version: impl Into<String>) -> &mut Self

Sets the desired browser version.

pub fn platform_name(&mut self, platform: impl Into<String>) -> &mut Self

Sets the platform name.

pub fn proxy(&mut self, proxy: ProxyConfiguration) -> &mut Self

Configures proxy settings.

pub fn unhandled_prompt_behavior( &mut self, behavior: UserPromptHandler, ) -> &mut Self

Sets how to handle unhandled prompts.

pub fn args(&mut self, args: Vec<String>) -> &mut Self

Sets Chrome command-line arguments.

pub fn add_arg(&mut self, arg: impl Into<String>) -> &mut Self

Adds a single Chrome command-line argument (e.g., “–headless”, “–disable-gpu”).

pub fn add_args<I, S>(&mut self, new_args: I) -> &mut Self

where I: IntoIterator<Item = S>, S: Into<String>,

Adds multiple Chrome command-line arguments.

pub fn binary(&mut self, binary: impl Into<String>) -> &mut Self

Sets the path to the Chrome binary.

pub fn extensions(&mut self, extensions: Vec<String>) -> &mut Self

Sets Chrome extensions to load (as base64-encoded .crx files).

pub fn add_extension(&mut self, extension: impl Into<String>) -> &mut Self

Adds a Chrome extension to load.

pub fn local_state(&mut self, local_state: HashMap<String, Value>) -> &mut Self

Sets Chrome’s local state preferences.

pub fn prefs(&mut self, prefs: HashMap<String, Value>) -> &mut Self

Sets Chrome user preferences.

pub fn add_pref(&mut self, key: impl Into<String>, value: Value) -> &mut Self

Adds a single Chrome user preference.

pub fn detach(&mut self, detach: bool) -> &mut Self

Sets whether Chrome should continue running after the driver disconnects.

pub fn debugger_address(&mut self, address: impl Into<String>) -> &mut Self

Sets the debugger address to connect to an existing Chrome instance.

pub fn exclude_switches(&mut self, switches: Vec<String>) -> &mut Self

Sets command-line switches to exclude.

pub fn add_exclude_switch(&mut self, switch: impl Into<String>) -> &mut Self

Adds a command-line switch to exclude.

pub fn minidump_path(&mut self, path: impl Into<String>) -> &mut Self

Sets the directory path for Chrome minidump files.

pub fn mobile_emulation( &mut self, emulation: HashMap<String, Value>, ) -> &mut Self

Configures mobile device emulation.

pub fn perf_logging_prefs(&mut self, prefs: PerfLoggingPrefs) -> &mut Self

Sets performance logging preferences.

pub fn window_types(&mut self, types: Vec<String>) -> &mut Self

Sets which window types to consider.

pub fn add_window_type(&mut self, window_type: impl Into<String>) -> &mut Self

Adds a window type to consider.

pub fn enable_extension_targets(&mut self, enable: bool) -> &mut Self

Sets whether to enable extension targets.

pub fn use_automation_extension(&mut self, use_it: bool) -> &mut Self

Sets whether to use the automation extension.

pub fn build(self) -> CapabilitiesRequest

Builds the final CapabilitiesRequest for session creation.

Trait Implementations

impl Clone for ChromeCapabilities

fn clone(&self) -> ChromeCapabilities

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChromeCapabilities

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

Formats the value using the given formatter.

impl Default for ChromeCapabilities

fn default() -> Self

Returns the “default value” for a type.