Amira Džanović

Method chaining using Capybara and SitePrism   What are Capybara and SitePrism? Capybara is a Ruby library that is used for automating web pages in concert with an underlying web-based driver. It consists of a user-friendly DSL, used to describe actions that are then executed by the web driver. While the Capybara syntax is very easily readable as-is, it can be improved upon to produce tests that are more DRY. This is where the SitePrism gem comes in - a DSL on top of Capybara, used for implementing the Page Object Model. Out of the box, it comes with predefined classes for many common features of websites, such as pages and sections.  Finally, to produce easily maintainable and completely readable tests, we can use method chaining with these tools. So, on an example of a page consisting of a login form and search function, here’s how we would go about doing that. Setting up page objects Firstly, we need to define the elements that make up the pages in the flow we are testing. Starting with the homepage, we will first define the URL and elements present, using SitePrism’s set_url and element methods: class HomePage < SitePrism::Page     set_url 'https://www.testsite.com'     element :go_to_login, 'some-login-link'     element :search_bar, 'some-search-bar'     element :search_button, ‘some-search-icon' end Notice we are inheriting from SitePrism::Page class, a built-in abstract class within the SitePrism gem. It contains methods used for loading pages as well as checking different attributes, such as if a page is displayed, secure, on the expected URL, etc. After setting up the home page, we do the same for the login page: class LoginPage < SitePrism::Page     set_url 'https://www.testsite.com/login'     element :name, 'some-username-field'     element :password, 'some-password-field'     element :login_button, 'some-login-button' end Defining methods Now that we’ve described these different views on our page, we can, likewise, describe actions that we want to be performed on each. We will add these methods to our page objects, so starting with the Homepage, let’s define a way to access the login form: def go_to_login_page do   go_to_login.click   return(LoginPage.new) end Notice that our method returns a new instance of the LoginPage object. By doing this we avoid having to instantiate a new LoginPage within the test itself.  Then we add the login method to the LoginPage class, as well as a search method to the HomePage class: #In the LoginPage class: def log_in_user(user_name, user_password) do     fill_in(name, with: user_name)     fill_in(password, with: user_password)     login_button.click     return(HomePage.new) end #In the HomePage class: def search_for_something(query) do     fill_in(search_bar, with: query)     search_button.click     return(SearchResults.new) end Method chaining in action Finally, in our spec, we need to require the objects we’ve created and write some tests. In our case, the user should be able to log in and get search results for their query: require_relative './page_objects/HomePage.rb' require_relative './page_objects/LoginPage.rb' describe 'test' do     it 'should login and return search results' do         @app.go_to_login_page           .log_in_user('1337_Jane', 'aLamePassword420')           .search_for_something('Tasty Donuts w chocolate glaze')         expect(page).to have_content('Some results related to the search query')     end end   "Method chaining using Capybara and SitePrism" Tech Bite was brought to you by Amira Džanović, Test Engineer at Atlantbh. (more…)