README.md

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

[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.

Setup

Start selenium server in one window

java -jar selenium-server-standalone-3.141.59.jar

Download Chrome Driver - unpack and put on PATH

http://chromedriver.chromium.org/downloads

Documentation: docs.rs

Sample Usage

Example - Navigating to a web page

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

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

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

Performing a google search

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

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

search_bar.type_text("selenium-rs github");
let search_button = driver.find_element(Selector::CSS, "input[name=\"btnK\"]").unwrap();
search_button.click();
search_button.click();

Example - Inspecting attributes of an element

use selenium_rs::webdriver::{Selector, Browser, WebDriver};
use selenium_rs::element::Element;

let mut driver = WebDriver::new(Browser::Chrome);
driver.start_session();
driver.navigate("http://www.google.com");
let search_form =  driver.find_element(Selector::CSS, "#searchform").unwrap();
assert!(search_form.get_css_value("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.