thirtyfour

Thirtyfour is a Selenium / WebDriver library for Rust, for automated website UI testing.

Features

All W3C WebDriver and WebElement methods supported
Create new browser session directly via WebDriver (e.g. chromedriver)
Create new browser session via Selenium Standalone or Grid
Find elements (via all common selectors e.g. Id, Class, CSS, Tag, XPath)
Send keys to elements, including key-combinations
Execute Javascript
Action Chains
Get and set cookies
Switch to frame/window/element/alert
Shadow DOM support
Alert support
Capture / Save screenshot of browser or individual element as PNG
Chrome DevTools Protocol (CDP) — typed commands plus optional WebSocket-based event subscription via the cdp-events feature
WebDriver BiDi (W3C bidirectional protocol) — typed commands and event subscription cross-browser, opt-in via the bidi feature
Powerful query interface (the recommended way to find elements) with explicit waits and various predicates
Component Wrappers (similar to Page Object Model)

Feature Flags

rustls-tls: (Default) Use rustls to provide TLS support (via reqwest).
native-tls: Use native TLS (via reqwest).
component: (Default) Enable the Component derive macro (via

thirtyfour_macros) and export Component / ElementResolver from the prelude.

cdp: (Default) Typed Chrome DevTools Protocol commands.
cdp-events: WebSocket-backed CDP event subscription.
bidi: WebDriver BiDi (W3C) — typed commands and event subscription

via WebDriver::bidi(). Opt in by calling caps.enable_bidi() before starting the session.

Example (async):

To run this example:

cargo run --example tokio_async

use thirtyfour::prelude::*;
#[tokio::main] async fn main() -> WebDriverResult<()> {      let caps = DesiredCapabilities::chrome();      let driver = WebDriver::managed(caps).await?;
// Navigate to https://wikipedia.org.      driver.goto("https://wikipedia.org").await?;      let elem_form = driver          .query(By::Id("search-form"))          .desc("Wikipedia search form")          .single()          .await?;
// Querying from an element scopes the search to its subtree.      let elemtext = elemform          .query(By::Id("searchInput"))          .desc("Wikipedia search input")          .single()          .await?;
// Type in the search terms.      elemtext.sendkeys("selenium").await?;
// Click the search button.      let elembutton = elemform          .query(By::Css("button[type='submit']"))          .desc("Wikipedia search button")          .single()          .await?;      elem_button.click().await?;
// Wait for the unique article heading before checking the title.      driver          .query(By::ClassName("firstHeading"))          .desc("Wikipedia article heading")          .single()          .await?;      assert_eq!(driver.title().await?, "Selenium - Wikipedia");
// Always explicitly close the browser.      driver.quit().await?;
Ok(()) }