Use Chrome with Cucumber & Capybara

Photo by Tambako the Jaguar, used under Creative Commons

We frequently swap out Firefox for Chrome in our selenium (@javascript) cucumber tests. It is actually very easy, but not widely known.

Update: I got some questions about why we’d use Chrome. Speed hasn’t been the issue (use capybara-webkit for that) but we have found some things that work better in Chrome vs Firefox (and vice-versa). Also, you get different rendering options and different standards support (for example, websockets). If you’re having test problems, switching probably isn’t your solution, but you can always try.

Step 1 - Tell Capybara about Chrome

Inside your features/support/env.rb add these lines:

Capybara.register_driver :chrome do |app|, :browser => :chrome)

Capybara.javascript_driver = :chrome

Step 2 - Install chromedriver

If you’re using homebrew on OS X (and why wouldn’t you?) simply install using:

brew install chromedriver

Otherwise, download it manually and make sure it is in your path (I typically put it in /usr/local/bin).

Step 3 - Run the features

Run your features and anything tagged with @javascript or @selenium is now running in Chrome instead of Firefox. Yay!

Photo of Daniel Morrison

Daniel founded Collective Idea in 2005 to put a name to his growing and already full-time freelance work. He works hard writing code, teaching, and mentoring.


    September 27, 2012 at 4:31 AM

    Thanks mate, this works fiine, but do you know how to override the user agent of the chrome browser? i’ve seen alot of tutorials but only with Firefox, but i much rather do it with chrome browser.

  2. December 17, 2012 at 16:31 PM

    @glenn: see

    March 27, 2013 at 0:09 AM

    no able to find inner html of an element

    Hello World

    not able o get value “Hello World”
    Using cucumber, capybara and crome driver
    All Latest versions

  4. November 16, 2013 at 2:31 AM

    Does not work on mavricks

    October 16, 2014 at 17:57 PM

    My env.rb looks like this:

    Capybara.default_selector = :css
    Capybara.register_driver :selenium do |app|, :browser => :chrome, :switches => %w[–test-type]) #comment it out!!!
    ActionController::Base.allow_rescue = false
    DatabaseCleaner.strategy = :transaction
    rescue NameError
    raise “You need to add database_cleaner to your Gemfile (in the :test group) if you wish to use it.”
    Cucumber::Rails::Database.javascript_strategy = :truncation

    that’s the parts that are not commented out anyway. It works great. I would like to test in firefox as well, and ideally eventually with other browsers. How do I switch back to firefox? 


  6. November 10, 2018 at 8:52 AM

    You completed a few nice points there. I did a search on the theme and found nearly all persons will consent with your blog.

  7. November 12, 2018 at 5:53 AM

    Thank you!!!! I did not install Mercury Reader because I use Firefox but it has an add on simply titled “Reader” and it is fantastic. Your article motivated me to look it up.