Struct fantoccini::ClientBuilder

pub struct ClientBuilder<C> where
    C: Connect + Send + Sync + Clone + Unpin,  { /* fields omitted */ }

A builder for WebDriver Client instances.

You will likely want to use native or rustls (depending on your preference) to start the builder. If you want to supply your own connector, use new.

To connect to the WebDriver instance, call connect.

Implementations

impl ClientBuilder<HttpsConnector<HttpConnector>>

pub fn rustls() -> Self

This is supported on crate feature rustls-tls only.

Build a Client that will connect using Rustls.

impl ClientBuilder<HttpsConnector<HttpConnector>>

pub fn native() -> Self

This is supported on crate feature native-tls only.

Build a Client that will connect using native-tls.

impl<C> ClientBuilder<C> where
    C: Connect + Send + Sync + Clone + Unpin + 'static, 

pub fn new(connector: C) -> Self

Build a Client that will connect using the given HTTP connector.

pub fn capabilities(&mut self, cap: Capabilities) -> &mut Self

Pass the given WebDriver capabilities to the browser.

The WebDriver specification has a list of standard capabilities, which are given below. In addition, most browser vendors support a number of browser-specific capabilities stored in an object under a prefixed key like moz:firefoxOptions or goog:chromeOptions.

The standard options are given below. See the specification for more details.

Capability	Key	Value Type	Description
Browser name	"browserName"	string	Identifies the user agent.
Browser version	"browserVersion"	string	Identifies the version of the user agent.
Platform name	"platformName"	string	Identifies the operating system of the endpoint node.
Accept insecure TLS certificates	"acceptInsecureCerts"	boolean	Indicates whether untrusted and self-signed TLS certificates are implicitly trusted on navigation for the duration of the session.
Page load strategy	"pageLoadStrategy"	string	Defines the current session’s page load strategy.
Proxy configuration	"proxy"	JSON Object	Defines the current session’s proxy configuration.
Window dimensioning/positioning	"setWindowRect"	boolean	Indicates whether the remote end supports all of the commands in Resizing and Positioning Windows.
Session timeouts configuration	"timeouts"	JSON Object	Describes the timeouts imposed on certain session operations.
Unhandled prompt behavior	"unhandledPromptBehavior"	string	Describes the current session’s user prompt handler.

pub async fn connect(&self, webdriver: &str) -> Result<Client, NewSessionError>

Connect to the WebDriver session at the webdriver URL.

Trait Implementations

impl<C: Clone> Clone for ClientBuilder<C> where
    C: Connect + Send + Sync + Clone + Unpin, 

fn clone(&self) -> ClientBuilder<C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C: Debug> Debug for ClientBuilder<C> where
    C: Connect + Send + Sync + Clone + Unpin, 

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

Formats the value using the given formatter.

impl<C: Default> Default for ClientBuilder<C> where
    C: Connect + Send + Sync + Clone + Unpin, 

fn default() -> ClientBuilder<C>

Returns the “default value” for a type.