Shard Detail

selenium v0.10.0

Selenium library for Crystal
selenium testing crystal

Install & Use

Add the following code to your project's shard.yml under:

dependencies to use in production
- OR -
development_dependencies to use in development

  github: matthewmcgarvey/


Selenium client for interacting with web pages for browser automation.

API Documentation


  1. Add the dependency to your shard.yml:

        github: matthewmcgarvey/
  2. Run shards install


require "selenium"

Creating a Driver

driver = Selenium::Driver.for(:chrome, base_url: "http://localhost:9515")

Available drivers:

  • :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.

driver = Selenium::Driver.for(:chrome, service: "~/.webdrivers/chromedriver"))

You must call driver.stop when you are finished or it will leave the service running. Consider using for automatically installing drivers and managing the driver path for you.

Creating a Session

capabilities =
capabilities.args(["no-sandbox", "headless", "disable-gpu"])

Use the appropriate Capabilities class for whichever browser you choose.


Run 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. Running just crystal spec will use chrome.


  1. Fork it (
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request