Skip to content

Commit

Permalink
added section on configuring drivers to readme
Browse files Browse the repository at this point in the history
  • Loading branch information
jnicklas committed Sep 16, 2010
1 parent 963190a commit d536eea
Showing 1 changed file with 21 additions and 0 deletions.
21 changes: 21 additions & 0 deletions README.rdoc
Original file line number Diff line number Diff line change
Expand Up @@ -422,6 +422,27 @@ The same thing goes for within:
end
end

== Configuring and adding drivers

Capybara makes it convenient to switch between different drivers. It also exposes
an API to tweak those drivers with whatever settings you want, or to add your own
drivers. This is how to switch the selenium driver to use chrome:

Capybara.register_driver :selenium do |app|
Capybara::Driver::Selenium.new(app, :browser => :chrome)
end

However, it's also possible to give this a different name, so tests can switch
between using different browsers effortlessly:

Capybara.register_driver :selenium_chrome do |app|
Capybara::Driver::Selenium.new(app, :browser => :chrome)
end

Whatever is returned from the block should conform to the API described by
Capybara::Driver::Base, it does not however have to inherit from this class.
Gems can use this API to add their own drivers to Capybara.

== Gotchas:

* Access to session and request is not possible from the test, Access to
Expand Down

0 comments on commit d536eea

Please sign in to comment.