Capybara is a web-based test automation software that simulates scenarios for user stories and automates web application testing for behavior-driven software development. It is written in the Ruby programming language.
| Developer(s) | Thomas Walpole |
|---|---|
| Stable release | 3.40.0[1] 
/ 27 January 2024 |
| Repository | |
| Written in | Ruby |
| Operating system | Cross-platform |
| Type | Behavior driven development framework / Test tool |
| License | MIT License |
| Website | teamcapybara |
Capybara can mimic actions of real users interacting with web-based applications. It can receive pages, parse the HTML and submit forms.[2]
Background and motivation
editDuring the software development process (especially in the Agile and Test-driven Development environments), as the size of the tests increase, it becomes difficult to manage tests which are complex and not modular.[2]
By extending the human-readable behavior-driven development style of frameworks such as Cucumber and RSpec into the automation code itself, Capybara aims to develop simple web-based automated tests.[3]
Anatomy of Capybara
editCapybara is a Ruby library (also referred to as a gem) that is used with an underlying web-based driver. It consists of a user-friendly DSL (Domain Specific Language) which describe actions that are executed by the underlying web driver.[4]
When the page is loaded using the DSL (and underlying web driver), Capybara will attempt to locate the relevant element in the DOM (Document Object Model) and execute an action such as click button, link, etc.
Drivers
editBy default, Capybara uses the :rack_test driver which does not have any support for executing JavaScript. Drivers can be switched in Before and After blocks. Some of the web drivers supported by Capybara are mentioned below.
RackTest
editWritten in Ruby, Capybara's default driver RackTest does not require a server to be started since it directly interacts with Rack interfaces. Consequently, it can only be used for Rack applications.
Selenium
editSelenium-webdriver, which is mostly used in web-based automation frameworks, is supported by Capybara. Unlike Capybara's default driver, it supports JavaScript, can access HTTP resources outside of application and can also be set up for testing in headless mode which is especially useful for CI scenarios.[4]
Capybara-webkit
editCapybara-webkit driver (a gem) is used for true headless browser testing with JavaScript support. It uses QtWebKit and it is significantly faster than Selenium as it does not load the entire browser.
Matchers
editCapybara locates an element either using Domain-specific language or XPath/CSS Selectors. Partial matches can lead to unexpected results. Two or more matches can even result in a failure with an Ambiguous match error. The following are the matching strategies supported by Capybara:[4]
first: Pick the first element which matches. Not advisable to use.
one: Allow only one element match. Error raised if more than one match.
smart: If Capybara.exact is true, it behaves like the above option (one). If Capybara.exact is false, it will first try to find an exact match. Ambiguous exception is raised if more than one match is found. If no element is found, a new search for inexact matches is commenced. Again, an ambiguous exception is raised if more than one match is found.
prefer_exact: Finds all matching (exact and which are not exact) elements. If multiple matches are found then the first exactly matching element is returned discarding other matches.
Usage
editUser-registration process
editHere is an example of how user registration test is done using Capybara. There is a test to see if the user can continue with the registration process or if there are any holds on him. If he has the requisite credentials, he will be registered and then redirected to the 'Welcome' page.[5]
describe 'UserRegistration' do
it 'allows a user to register' do
visit new_user_registration_path
fill_in 'First name', :with => 'New'
fill_in 'Last name', :with => 'User'
fill_in 'Email', :with => 'newuser@example.com'
fill_in 'Password', :with => 'userpassword'
fill_in 'Password Confirmation', :with => 'userpassword'
click_button 'Register'
page.should have_content 'Welcome'
end
end
Capybara with Cucumber
editAn example of a Capybara feature used with Cucumber:
When /^I want to add/ do
fill_in 'a', :with => 100
fill_in 'b', :with => 100
click_button 'Add'
end
Capybara with RSpec
editSome minute integration is required in order to use Capybara with RSpec[4][6]
describe 'go to home page' do
it 'opens the home page' do
visit (get_homepage)
expect(page).to have_content('Welcome')
end
end
Similar tools
editSee also
edit
References
edit- ^ "Release 3.40.0". 27 January 2024. Retrieved 19 February 2024.
- ^ a b Fox, Armando; Patterson, David A. (2013). Engineering Software as a Service: An Agile Approach Using Cloud Computing. Strawberry Canyon LLC. ISBN 9780984881246.
- ^ Application Testing with Capybara. ISBN 9781783281268.
- ^ a b c d "The Basics of Capybara and Improving Your Tests". SitePoint. 18 August 2014. Retrieved 2016-02-08.
- ^ "Integration testing Devise with RSpec and Capybara". garyrafferty.com. Archived from the original on 2016-01-21. Retrieved 2016-02-16.
- ^ Liss, Jo. "Capybara (and Selenium) with RSpec & Rails 3: quick tutorial". www.opinionatedprogrammer.com. Retrieved 2016-02-08.