[−][src]Crate thirtyfour

Thirtyfour is a full-featured Selenium library for Rust, inspired by the Python Selenium library.

It supports the W3C WebDriver spec. Tested with Chrome and Firefox although any W3C-compatible WebDriver should work.

Both synchronous and asynchronous APIs are provided (see examples below).

Features

Async / await support
Synchronous support
Create new browser session via Selenium Standalone or Grid
Automatically close browser session on drop
All W3C WebDriver and WebElement methods supported
Find elements (via all common selectors)
Send keys to elements, including key-combinations
Execute Javascript
Action Chains
Cookies
Switch to frame/window/element/alert
Alert support
Capture / Save screenshot of browser or individual element

Examples

The following examples assume you have a selenium server running at localhost:4444, and a demo web app running at localhost:8000.

You can set these up using docker, as follows:

docker run --rm -d --network host --name selenium-server -v /dev/shm:/dev/shm selenium/standalone-chrome:3.141.59-zinc
docker run -d -p 8000:80 stevepryde/webappdemo:v0.2.3

The web app demo is purely for demonstration / unit testing purposes and is not required in order to use this library.

Async example:

use thirtyfour::error::WebDriverResult;
use thirtyfour::{By, DesiredCapabilities, WebDriver};
use tokio;

#[tokio::main]
async fn main() -> WebDriverResult<()> {
    let caps = DesiredCapabilities::chrome();
    let driver = WebDriver::new("http://localhost:4444/wd/hub", &caps).await?;

    // Navigate to URL.
    driver.get("http://localhost:8000").await?;

    // Find element.
    let elem_div = driver.find_element(By::Css("div[data-section='section-input']")).await?;

    // Find element from element.
    let elem_text = elem_div.find_element(By::Name("input1")).await?;

    // Type in the search terms.
    elem_text.send_keys("selenium").await?;

    // Click the button.
    let elem_button = elem_div.find_element(By::Tag("button")).await?;
    elem_button.click().await?;

    // Get text value of element.
    let elem_result = driver.find_element(By::Name("input-result")).await?;
    assert_eq!(elem_result.text().await?, "selenium");

    Ok(())
}

Sync example:

use thirtyfour::error::WebDriverResult;
use thirtyfour::{By, DesiredCapabilities, sync::WebDriver};

fn main() -> WebDriverResult<()> {
    let caps = DesiredCapabilities::chrome();
    let driver = WebDriver::new("http://localhost:4444/wd/hub", &caps)?;

    // Navigate to URL.
    driver.get("http://localhost:8000")?;

    // Find element.
    let elem_div = driver.find_element(By::Css("div[data-section='section-input']"))?;

    // Find element from element.
    let elem_text = elem_div.find_element(By::Name("input1"))?;

    // Type in the search terms.
    elem_text.send_keys("selenium")?;

    // Click the button.
    let elem_button = elem_div.find_element(By::Tag("button"))?;
    elem_button.click()?;

    // Get text value of element.
    let elem_result = driver.find_element(By::Name("input-result"))?;
    assert_eq!(elem_result.text()?, "selenium");

    Ok(())
}

Re-exports

pub use common::capabilities::DesiredCapabilities;

pub use common::command::By;

pub use common::cookie::Cookie;

pub use common::keys::Keys;

pub use common::keys::TypingData;

pub use common::types::*;

Modules

action_chain
common
error
sync

Structs

Alert	Struct for managing alerts.
RemoteConnectionAsync	Asynchronous remote connection with the Remote WebDriver server.
SwitchTo	Struct for switching between frames/windows/alerts.
WebDriver	The WebDriver struct encapsulates an async Selenium WebDriver browser session. For the async driver, see sync::WebDriver.
WebElement	The WebElement struct encapsulates a single element on a page.