[−][src]Crate thirtyfour_sync
Thirtyfour is a Selenium / WebDriver library for Rust, for automated website UI testing.
It supports the full W3C WebDriver spec. Tested with Chrome and Firefox although any W3C-compatible WebDriver should work.
This crate provides a synchronous (i.e. not async) interface for thirtyfour
.
For async, see the thirtyfour crate instead.
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
- Automatically close browser session on drop
- 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
Cargo features
There are four reqwest-*-tls*
-features, which enable the respective features in the reqwest
dependency:
- reqwest-default-tls (enabled by default): Provides TLS support to connect over HTTPS.
- reqwest-native-tls: Enables TLS functionality provided by
native-tls
. - reqwest-native-tls-vendored: Enables the
vendored
feature ofnative-tls
. - reqwest-rustls-tls: Enables TLS functionality provided by
rustls
.
Examples
The following example assumes you have a selenium server running at localhost:4444, and a demo web app running at http://webappdemo
You can set these up using docker-compose, as follows:
docker-compose up -d
The included web app demo is purely for demonstration / unit testing purposes and is not required in order to use this library in other projects.
Example (synchronous):
use thirtyfour_sync::prelude::*; fn main() -> WebDriverResult<()> { let caps = DesiredCapabilities::chrome(); let driver = WebDriver::new("http://localhost:4444/wd/hub", &caps)?; // Navigate to URL. driver.get("http://webappdemo")?; // Navigate to page. driver.find_element(By::Id("pagetextinput"))?.click()?; // 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::Id("input-result"))?; assert_eq!(elem_result.text()?, "selenium"); Ok(()) }
Modules
common | Re-export common types. |
error | Error types. |
http | |
prelude |
Structs
Alert | Struct for managing alerts. |
ChromeCapabilities | Re-export common types. |
Cookie | Re-export common types. |
DesiredCapabilities | The DesiredCapabilities struct provides a generic way to construct capabilities as well as helper methods that create specific capabilities structs for the various browsers. |
EdgeCapabilities | Re-export common types. |
ElementId | |
ElementRect | |
ElementRef | |
FirefoxCapabilities | Re-export common types. |
GenericWebDriver | NOTE: For WebDriver method documentation, see the WebDriverCommands trait. |
InternetExplorerCapabilities | Re-export common types. |
OperaCapabilities | Re-export common types. |
OptionRect | |
Rect | |
SafariCapabilities | Re-export common types. |
ScriptArgs | Re-export common types. |
SessionId | |
SwitchTo | Struct for switching between frames/windows/alerts. |
TimeoutConfiguration | |
TypingData | Re-export common types. |
WebDriverSession | |
WebElement | The WebElement struct encapsulates a single element on a page. |
WindowHandle |
Enums
AlertBehaviour | |
By | Re-export common types. |
Keys | Re-export common types. |
PageLoadStrategy | |
Proxy | |
RequestMethod | Re-export common types. |
ScrollBehaviour | |
WindowType |
Traits
Capabilities | |
ExtensionCommand | Re-export common types. |
WebDriverCommands | All browser-level W3C WebDriver commands are implemented under this trait. |
Functions
make_w3c_caps |
Type Definitions
WebDriver | The WebDriver struct represents a browser session. |