test-page
test-page helps you to write easily maintainable integration tests by implementing Page Objects pattern.
Page Objects may be objects representing whole pages like LoginPage, ProfilePage or part of the pages like LoginForm, Header etc.
test-page can be described like:
- Is framework agnostic - you can use it with any library you want - Watir, Selenium, Capybara etc.
- Has really easy API - you can start testing right away instead of spending too much time to learn new framework.
- Has really small codebase - even if you can't remember that small API you can dig right into the code - it's less than 100 lines!
- Despite of its name you may use it with RSpec, Test::Unit or any other testing library.
Installation
Add this line to your application's Gemfile:
gem 'test-page'
And then execute:
$ bundle
Or install it yourself as:
$ gem install test-page
Usage
The following example uses Watir with RSpec, but you can use whichever library you like.
Check out Selenium example instead, if that's your flavor of choice.
This is the spec we are trying to run:
# spec/search_spec.rb
require "test/page"
require "watir"
require File.expand_path("search_page", File.dirname(__FILE__))
describe "Bing" do
let(:browser) { Watir::Browser.new }
let(:search_page) { SearchPage.new }
before { Test::Page.browser = browser }
after { browser.close }
it "finds Google" do
results_page = search_page.search "google"
results_page.should have(10).results
results_page.results[0].should =~ /google/i
end
it "finds Bing itself" do
results_page = search_page.search "bing"
results_page.results.should be_any { |result| result =~ /Bing/ }
end
end
Let's create the SearchPage object:
# spec/support/page/search_page.rb
require File.expand_path("results_page", File.dirname(__FILE__))
class SearchPage < Test::Page
element { browser.div(:id => "sbox") }
def setup
browser.goto "http://bing.com"
end
def search(term)
text_field(:id => "sb_form_q").set term
button(:id => "sb_form_go").click
redirect_to ResultsPage, browser.ul(:id => "wg0")
end
end
Let's create the ResultsPage object:
# spec/support/page/results_page.rb
class ResultsPage < Test::Page
def results
lis(:class => "sa_wr").map(&:text)
end
end
There you have it, a fully functional spec using two page objects. Reference to the API documentation for more usage information.
License
Copyright (c) Jarmo Pertman (jarmo@jarmopertman.com). See LICENSE for details.