Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/saresend/selenium-rs
A Rust Client for the Selenium webdriver (WIP)
https://github.com/saresend/selenium-rs
rust selenium testing
Last synced: 8 days ago
JSON representation
A Rust Client for the Selenium webdriver (WIP)
- Host: GitHub
- URL: https://github.com/saresend/selenium-rs
- Owner: saresend
- License: mit
- Created: 2018-08-11T18:51:11.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-09T16:39:04.000Z (over 1 year ago)
- Last Synced: 2024-03-14T20:21:53.821Z (8 months ago)
- Topics: rust, selenium, testing
- Language: Rust
- Homepage:
- Size: 66.4 KB
- Stars: 174
- Watchers: 5
- Forks: 31
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Selenium-rs
[](https://github.com/saresend/selenium-rs/issues)
## About
Selenium-rs is a simple client for the [selenium webdriver](https://www.seleniumhq.org/). Its built to work with the webdriver protocol (spec found [here](https://www.w3.org/TR/webdriver1/)). 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](https://www.seleniumhq.org/download/). 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](https://docs.rs/selenium-rs/0.1.0/selenium_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");
assert_eq!(driver.get_current_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.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
```rust
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](https://github.com/saresend/selenium-rs/issues).
**Note:** Currently only tested with Selenium 3.14
## Contribution
Pull requests are always welcome! Please see the [issue tracker](https://github.com/saresend/selenium-rs/issues) for currently in-progress features, improvements, and bugfixes.
## Licence
This is provided under the [MIT](https://github.com/saresend/selenium-rs/blob/master/LICENSE) license.