Selenium-rs

About

Selenium-rs is a simple client for the selenium webdriver. Its built to work with the webdriver protocol (spec found here). It currently supports the chrome Driver, and Gecko (firefox) support is on the way.

Installation

```toml [dependencies] selenium-rs = "0.1.0"

```

Note that selenium-rs also requires a running instance of the selenium webdriver, which can be found here. Simply download the jar and run it to instantiate the selenium webdriver server.

Documentation: docs.rs

Sample Usage

Example - Navigating to a web page

```rust use selenium_rs::webdriver::{Browser,WebDriver};

let mut driver= WebDriver::new(Browser::Chrome); driver.start_session();

driver.navigate("https://www.rust-lang.org"); asserteq!(driver.getcurrent_url().unwrap(), String::from("https://www.rust-lang.org/")); ```

Performing a google search

```rust use selenium_rs::webdriver::{Browser, WebDriver, Selector}; let mut driver = WebDriver::new(Browser::Chrome);

driver.startsession(); driver.navigate("http://google.com"); let searchbar = driver.find_element(Selector::CSS, "input[maxlength=\"2048\"]").unwrap();

searchbar.typetext("selenium-rs github"); let searchbutton = driver.findelement(Selector::CSS, "input[name=\"btnK\"]").unwrap(); searchbutton.click(); searchbutton.click(); ```

Example - Inspecting attributes of an element

```rust use seleniumrs::webdriver::{Selector, Browser, WebDriver}; use seleniumrs::element::Element;

let mut driver = WebDriver::new(Browser::Chrome); driver.startsession(); driver.navigate("http://www.google.com"); let searchform = driver.findelement(Selector::CSS, "#searchform").unwrap(); assert!(searchform.getcssvalue("min-width").unwrap() == "980px"); ```

Current Status

Currently, the project supports many of the more important functionalities provided by the webdriver spec. However, it is still a fair bit away from complete. Support will get periodically added as I find the time to finish implementing everything described in the webdriver spec. In-progress features will be tracked here.

Note: Currently only tested with Selenium 3.14

Contribution

Pull requests are always welcome! Please see the issue tracker for currently in-progress features, improvements, and bugfixes.

Licence

This is provided under the MIT license.