Run Selenium tests more easily with automatic installation and updates for all supported webdrivers.
webdrivers downloads drivers and directs Selenium to use them. Currently supports:
In your Gemfile:
gem 'webdrivers', '~> 3.0'
In your project:
The drivers will now be automatically downloaded or updated when you launch a browser through Selenium.
If you want webdrivers to only manage specific drivers you can specify as follows:
require 'webdrivers/chromedriver' require 'webdrivers/iedriver'
The default download location is
~/.webdrivers directory, and this is configurable:
Webdrivers.install_dir = '/webdrivers/install/dir'
If you would like to use a specific (older or beta) version, you can specify it for each driver. Otherwise, the latest (stable) driver will be downloaded and passed to Selenium.
# Chrome Webdrivers::Chromedriver.required_version = '2.46' # Firefox Webdrivers::Geckodriver.required_version = '0.23.0' # Microsoft Internet Explorer Webdrivers::IEdriver.required_version = '3.14.0' # Microsoft Edge Webdrivers::MSWebdriver.required_version = '17134'
You can explicitly trigger the update in your code, but this will happen automatically when the driver is initialized:
You can set Webdrivers to only look for updates if the previous check was longer ago than a specified number of seconds.
Webdrivers.cache_time = 86_400
The default in 3.9 is zero, and the default for 4.x will be 24 hours (86,400 seconds)
If there is a proxy between you and the Internet then you will need to configure
the gem to use the proxy. You can do this by calling the
Webdrivers.configure do |config| config.proxy_addr = 'myproxy_address.com' config.proxy_port = '8080' config.proxy_user = 'username' config.proxy_pass = 'password' end
If you are getting an error like this (especially common on Windows):
SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed
Add the following to your Gemfile:
Add the following to your code:
Other solutions are documented on the RubyGems website.
The logging level can be configured for debugging purpose:
Webdrivers.logger.level = :DEBUG
Browser Specific Notes
The version of
chromedriver will depend on the version of Chrome you are using it with:
- For versions >= 70, the downloaded version of
chromedriverwill match the installed version of Google Chrome. More information here.
- For versions <= 69,
chromedriverversion 2.46 will be downloaded.
- For beta versions, you'll have to set the desired beta version of
The gem, by default, looks for the Google Chrome version. You can override this by providing a path to the Chromium binary:
Selenium::WebDriver::Chrome.path = '/chromium/install/path/to/binary'
This is also required if Google Chrome is not installed in its default location.
Microsoft Edge support has been removed for now, as it is currently unreliable.
To use Microsoft Edge, please visit the Downloads and Installation page
Please see the wiki for solutions to commonly reported issues.
The gem is available as open source under the terms of the MIT License, see LICENSE.txt for full details and copyright.
Bug reports and pull requests are welcome on GitHub. Run
bundle exec rake and squash the commits in your PRs.
Copyright (c) 2017-2019 Titus Fortner See LICENSE for details