Struct thirtyfour::sync::WebDriver

pub struct WebDriver { /* fields omitted */ }

This WebDriver struct encapsulates a synchronous Selenium WebDriver browser session. For the async driver, see WebDriver.

Example:

use thirtyfour::sync::WebDriver;
let caps = serde_json::json!({
    "browserName": "chrome",
    "version": "",
    "platform": "any"
});
let driver = WebDriver::new("http://localhost:4444/wd/hub", caps)?;

// Navigate to mozilla.org.
driver.get("https://mozilla.org")?;

Methods

impl WebDriver

pub fn new(
    remote_server_addr: &str,
    capabilities: DesiredCapabilities
) -> WebDriverResult<Self>

Create a new synchronous WebDriver struct.

Example

use thirtyfour::sync::WebDriver;

let caps = serde_json::json!({
    "browserName": "chrome",
    "version": "",
    "platform": "any"
});
let driver = WebDriver::new("http://localhost:4444/wd/hub", caps)?;

pub fn capabilities(&self) -> &DesiredCapabilities

Return the actual capabilities as returned by Selenium.

pub fn close(&self) -> WebDriverResult<()>

Close the current window.

pub fn quit(&self) -> WebDriverResult<()>

End the webdriver session.

pub fn get<S: Into<String>>(&self, url: S) -> WebDriverResult<()>

Navigate to the specified URL.

pub fn current_url(&self) -> WebDriverResult<String>

Get the current URL as a String.

pub fn page_source(&self) -> WebDriverResult<String>

Get the page source as a String.

pub fn title(&self) -> WebDriverResult<String>

Get the page title as a String.

pub fn find_element(&self, by: By) -> WebDriverResult<WebElement>

Search for an element on the current page using the specified selector.

Example:

use thirtyfour::By;

let elem = driver.find_element(By::Id("theElementId"))?;

pub fn find_elements(&self, by: By) -> WebDriverResult<Vec<WebElement>>

Search for all elements on the current page that match the specified selector.

Example:

let elems = driver.find_elements(By::Class("some-class"))?;
for elem in elems {
    println!("Found element: {}", elem);
}

pub fn execute_script(
    &self,
    script: &str,
    args: Vec<Value>
) -> WebDriverResult<Value>

Execute the specified Javascript synchronously and return the result as a serde_json::Value.

pub fn execute_async_script(
    &self,
    script: &str,
    args: Vec<Value>
) -> WebDriverResult<Value>

Execute the specified Javascrypt asynchronously and return the result as a serde_json::Value.

pub fn current_window_handle(&self) -> WebDriverResult<WindowHandle>

Get the current window handle.

pub fn window_handles(&self) -> WebDriverResult<Vec<WindowHandle>>

Get all window handles for the current session.

pub fn mazimize_window(&self) -> WebDriverResult<()>

Maximize the current window.

pub fn minimize_window(&self) -> WebDriverResult<()>

Minimize the current window.

pub fn fullscreen_window(&self) -> WebDriverResult<()>

Make the current window fullscreen.

pub fn get_window_rect(&self) -> WebDriverResult<Rect>

Get the current window rectangle, in pixels.

The returned Rect struct has members x, y, width, height, all i32.

pub fn set_window_rect(&self, rect: OptionRect) -> WebDriverResult<()>

Set the current window rectangle, in pixels.

This requires an OptionRect, which is similar to Rect except all members are wrapped in Option.

Example:

use thirtyfour::OptionRect;
let r = OptionRect::new().with_size(1280, 720);
driver.set_window_rect(r)?;

You can also convert from a Rect if you want to get the window size and modify it before setting it again.

let rect = driver.get_window_rect()?;
let option_rect = OptionRect::from(rect);
driver.set_window_rect(option_rect.with_width(1024))?;

pub fn back(&self) -> WebDriverResult<()>

Go back. This is equivalent to clicking the browser's back button.

pub fn forward(&self) -> WebDriverResult<()>

Go forward. This is equivalent to clicking the browser's forward button.

pub fn refresh(&self) -> WebDriverResult<()>

Refresh the current page.

pub fn set_timeouts(
    &self,
    timeouts: TimeoutConfiguration
) -> WebDriverResult<()>

Set all timeouts for the current session.

Example:

use thirtyfour::TimeoutConfiguration;
use std::time::Duration;
let timeouts = TimeoutConfiguration::new(None, Some(Duration::new(30, 0)), None);
driver.set_timeouts(timeouts)?;

pub fn implicitly_wait(&self, time_to_wait: Duration) -> WebDriverResult<()>

Set the implicit wait timeout.

pub fn set_script_timeout(&self, time_to_wait: Duration) -> WebDriverResult<()>

Set the script timeout.

pub fn set_page_load_timeout(
    &self,
    time_to_wait: Duration
) -> WebDriverResult<()>

Set the page load timeout.

pub fn action_chain(&self) -> ActionChain

Create a new action chain for this session.

Example:

driver.action_chain().drag_and_drop_element(elem_src, elem_target).perform()?;

pub fn get_cookies(&self) -> WebDriverResult<Vec<Cookie>>

Get all cookies.

pub fn get_cookie(&self, name: &str) -> WebDriverResult<Cookie>

Get the specified cookie.

pub fn delete_cookie(&self, name: &str) -> WebDriverResult<()>

Delete the specified cookie.

pub fn delete_all_cookies(&self) -> WebDriverResult<()>

Delete all cookies.

pub fn add_cookie(&self, cookie: Cookie) -> WebDriverResult<()>

Add the specified cookie.

Example:

use thirtyfour::Cookie;
let cookie = Cookie::new("key", serde_json::json!("value"));
driver.add_cookie(cookie)?;

pub fn screenshot_as_base64(&self) -> WebDriverResult<String>

Take a screenshot of the current window and return it as a base64-encoded String.

pub fn screenshot_as_png(&self) -> WebDriverResult<Vec<u8>>

Take a screenshot of the current window and return it as PNG bytes.

pub fn screenshot(&self, path: &Path) -> WebDriverResult<()>

Take a screenshot of the current window and write it to the specified filename.

Trait Implementations

impl Clone for WebDriver

fn clone(&self) -> WebDriver

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for WebDriver

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

Formats the value using the given formatter.

impl Drop for WebDriver

fn drop(&mut self)

Close the current session when the WebDriver struct goes out of scope.