Test::Right - Opinionated full-stack browser testing
Test::Right is a testing framework designed to help users get maximum value out of browser testing. It provides a flexible Page Object model for building robust, reliable tests quickly and easily. No more slogging through XPaths in Selenium IDE: Test::Right is the right way to build browser tests.
gem install test_right cd MY_APP test_right install
The test_right executable will create a default directory structure in test/right for you to put your tests in.
Begin by setting the base_url setting in test/right/config.yml to the base URL of your application staging environment. Then add the necessary code to reset your application state and launch your server to setup.rb.
Tests are defined in terms of actions and properties on widgets. A widget is a piece of functionality present on one more more pages of your application. A single page can have many widgets, and multiple copies of a widget may appear on the same page.
To get started, add widget definitions to the widgets/ directory. A widget defines its elements in terms of standard Selenium 2 selectors and actions in terms of those elements. For example, something like this in test/right/widgets/login.rb:
class LoginWidget < Test::Right::Widget field :username, :id => 'username' button :login, :css => "input[type=submit]" action :login do |username, password| fill_in :username, username click :login end end class CartWidget < Test::Right::Widget element :count, :id => 'item_count' property :number_of_items do get_element(:count).text end end
Once your widgets are setup, write tests for features of your application in test/right/features. For example, something like this would go in test/right/features/shopping_cart.rb:
class ShoppingCartFeature < Test::Right::Feature def setup with LoginWidget do |w| w.login end end def test_adding_item with ItemWidget do |w| w.add_an_item end with CartWidget do |w| assert_equal 1, w.number_of_items end end end
Learn more on the Test::Right wiki at https://github.com/saucelabs/test_right/wiki