Struct WebDriverBuilder 

pub struct WebDriverBuilder { /* private fields */ }

Builder for WebDriver sessions that talk to an externally-managed driver (e.g. a Selenium Grid, a manually-launched chromedriver, or any W3C-compatible WebDriver server).

Construct via WebDriver::builder. Awaiting the builder opens the session.

Example

let caps = DesiredCapabilities::chrome();
let driver = WebDriver::builder("http://localhost:4444", caps)
    .request_timeout(Duration::from_secs(30))
    .user_agent("my-app/1.0")
    .await?;

For driver-managed sessions (auto-download + spawn), use WebDriver::managed instead.

Implementations

impl WebDriverBuilder

pub fn keep_alive(self, keep_alive: bool) -> Self

Set the Connection: keep-alive header on outgoing requests. Default: true.

pub fn poller(self, poller: Arc<dyn IntoElementPoller + Send + Sync>) -> Self

Set the element poller used by WebDriver::query and WebElement::wait_until.

pub fn user_agent<V>(self, user_agent: V) -> Self

where HeaderValue: TryFrom<V>, <HeaderValue as TryFrom<V>>::Error: Into<WebDriverError>,

Override the User-Agent header sent with WebDriver requests. Default: WebDriverConfig::DEFAULT_USER_AGENT.

pub fn request_timeout(self, timeout: Duration) -> Self

Override the per-request HTTP timeout. Default: 120s. Applied to the default reqwest-based client; custom HttpClient implementations supplied via WebDriverBuilder::client may also honour it.

pub fn client(self, client: impl HttpClient + 'static) -> Self

Use a custom HttpClient instead of the default reqwest-based one. Useful for plugging in a proxy, custom TLS configuration, or running without the reqwest feature.

pub async fn connect(self) -> WebDriverResult<WebDriver>

Open the session.

Trait Implementations

impl Debug for WebDriverBuilder

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

Formats the value using the given formatter.

impl IntoFuture for WebDriverBuilder

type Output = Result<WebDriver, WebDriverError>

The output that the future will produce on completion.

type IntoFuture = Pin<Box<dyn Future<Output = <WebDriverBuilder as IntoFuture>::Output> + Send>>

Which kind of future are we turning this into?

fn into_future(self) -> Self::IntoFuture

Creates a future from a value.