Pageify

Lets you define page objects for your UI tests, written in Ruby.

Example

Page definition looks like this

home_page: ".home"
  login: "div.login"
    user_name: "input.user"
    password: "input.password"
    submit: "[name='submit']"
  profile_name: "a.profile"
  settings: "a.settings"
  sign_up: "a.sign_up"

Test steps looks like this

home_page.login.user_name[].set "hi"
home_page.login.password[].set "bla"
home_page.login.submit[].click

home_page.profile_name[].should match_text "hi"
hoem_page.settings[].should be_visible

We will be able element whose locators are dynamic

products_page: ".products"
  product: ".product[name='%s']"
    details_row: ".row:nth-of-type(%s)"
      cost: ".cost"

products_page.product("candy").details_row(1).cost[].should have_text "Rs.10"
products_page.product("tyres").details_row(2).cost[].should have_text "Rs.20"

Key benefits

• Your test will be more readable.
• Eliminates duplicate definition of selectors across test.
• Easy Maintenance.

Usage

In your project Gemfile add

gem 'pageify'

Cucumber

In env.rb

 require 'pageify'
 require 'pageify/capybara'
 include Pageify

 pageify("features/pages")

Place all the page defenitions under "features/pages"

Methods

Get Element '[]'

home_page.login.user_name[] #=> user_name text box
home_page.login.user_name[].set "hi" # set text box value
home_page.login.user_name[].should have_value "hi" # assert value
home_page.login.submit[].click

Get Selector 'p'

At times we would need selector of the object

home_page.login.user_name.p #=> ".home div.login input.user"

#check element doesn't exist
page.should_not have_selector home_page.login.user_name.p

#using capybara actions
fill_in  home_page.login.user_name.p, :with=> "hi"
click_on home_page.login.submit.p