Selenium client for interacting with web pages for browser automation.
Add the dependency to your
dependencies: selenium: github: matthewmcgarvey/selenium.cr
Creating a Driver
driver = Selenium::Driver.for(:chrome, base_url: "http://localhost:9515")
Creating a driver this way assumes that you have the driver running already.
- :chrome (using chromedriver)
- :firefox (using geckodriver)
- :remote (general purpose)
Running with a service
Rather than running chromedriver yourself, you can give the driver a service which will run the process for you.
service = Selenium::Service.chrome(driver_path: File.expand_path("~/.webdrivers/chromedriver", home: true)) driver = Selenium::Driver.for(:chrome, service: service)
You must call
driver.stop when you are finished or it will leave the service running.
Consider using webdrivers.cr for automatically installing drivers and managing the driver path for you.
Creating a Session
capabilities = Selenium::Chrome::Capabilities.new capabilities.chrome_options.args = ["no-sandbox", "headless", "disable-gpu"] driver.create_session(capabilities)
Use the appropriate
Capabilities class for whichever browser you choose.
crystal spec to run the tests. It will run the tests in headless mode.
To run the tests with chrome headlessly:
SELENIUM_BROWSER=chrome crystal spec --tag "~chrome"
To run the tests with firefox headlessly:
SELENIUM_BROWSER=firefox crystal spec --tag "~firefox"
The tag skips any specs that are know to break with those browsers.
crystal spec will use chrome.
- Fork it (https://github.com/matthewmcgarvey/selenium.cr/fork)
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Add some feature')
- Push to the branch (
git push origin my-new-feature)
- Create a new Pull Request
- Matthew McGarvey - creator and maintainer