page_object 1.1.1

data/features/support/persistent_browser.rb

@@ -0,0 +1,70 @@
+require 'selenium/webdriver/remote/http/persistent'
+
+module PageObject
+  module PersistantBrowser
+    @@browser = false
+    def self.get_browser
+      if !@@browser
+        target = ENV['BROWSER']
+        target = 'firefox_local' unless target
+
+        if is_remote?(target)
+          require File.dirname(__FILE__) + "/targets/#{target}"
+          extend Target
+        end
+        
+        @@browser =  watir_browser(target) if ENV['DRIVER'] == 'WATIR'
+        @@browser =  selenium_browser(target) if ENV['DRIVER'] == 'SELENIUM'
+      end
+      @@browser
+    end
+    
+    def self.quit
+      @@browser.quit
+    end
+
+    private
+
+    def self.is_remote?(target)
+      not target.include? 'local'
+    end
+
+    def self.watir_browser(target)
+      if is_remote?(target)
+        Watir::Browser.new(:remote,
+                           :http_client => client,
+                           :url => url,
+                           :desired_capabilities => desired_capabilities)
+      else
+        Watir::Browser.new :firefox, :http_client => client
+      end
+    end
+
+    def self.selenium_browser(target)
+      if is_remote?(target)
+        Selenium::WebDriver.for(:remote,
+                                :http_client => client,
+                                :url => url,
+                                :desired_capabilities => desired_capabilities)
+      else
+        Selenium::WebDriver.for :firefox, :http_client => client
+      end
+    end
+
+    def self.client
+      Selenium::WebDriver::Remote::Http::Persistent.new
+    end
+
+    def self.capabilities(browser, version, platform, name)
+      caps = Selenium::WebDriver::Remote::Capabilities.send browser
+      caps.version = version
+      caps.platform = platform
+      caps[:name] = name
+      caps
+    end
+
+    def self.url
+      "http://pageobject:18002ee8-963b-472e-9425-2baf0a2b6d95@ondemand.saucelabs.com:80/wd/hub"
+    end
+  end
+end

data/features/support/targets/firefox14_osx.rb

@@ -0,0 +1,6 @@
+module Target
+  def desired_capabilities
+    capabilities(:firefox, '14', 'Mac 10.6', 'Testing page-object with Firefox 14 on OS X')
+  end
+end
+

data/features/support/targets/firefox14_windows7.rb

@@ -0,0 +1,6 @@
+module Target
+  def desired_capabilities
+    capabilities(:firefox, '14', 'Windows 2008', 'Testing page-object with Firefox 14 on Windows 7')
+  end
+end
+

data/features/support/url_helper.rb

@@ -0,0 +1,57 @@
+module UrlHelper
+  class << self
+    def html
+      File.expand_path("#{File.dirname(__FILE__)}/../html")
+    end
+
+    def files
+      target = ENV['BROWSER']
+      return "file://#{html}" if target.nil? or target.include? 'local'
+      'http://ec2-107-22-131-88.compute-1.amazonaws.com'
+    end
+
+    def static_elements
+      "#{files}/static_elements.html"
+    end
+    
+    def frame_elements
+      "#{files}/frames.html"      
+    end
+    
+    def iframe_elements
+      "#{files}/iframes.html"
+    end
+    
+    def nested_frame_elements
+      "#{files}/nested_frames.html"
+    end
+    
+    def nested_elements
+      "#{files}/nested_elements.html"
+    end
+    
+    def modal
+      "#{files}/modal.html"
+    end
+
+    def async
+      "#{files}/async.html"
+    end
+
+    def multi
+      "#{files}/multi_elements.html"
+    end
+
+    def indexed
+      "#{files}/indexed_property.html"
+    end
+
+    def hover
+      "#{files}/hover.html"
+    end
+
+    def double_click
+      "#{files}/double_click.html"
+    end
+  end
+end

data/features/table.feature

@@ -0,0 +1,122 @@
+Feature: Table
+  In order to interact with tables
+  Testers will need access and interrogation ability
+
+
+  Background:
+    Given I am on the static elements page
+
+  Scenario: Retrieve a table
+    When I retrieve a table element
+    Then I should know it is visible
+
+  Scenario: Determine if a table exists
+    When I retrieve a table element
+    Then I should know it exists
+
+  Scenario: Retrieve the data from a table
+    When I retrieve a table element
+    Then the data for row "2" should be "Data1" and "Data2"
+    And the data for row "3" should be "Data3" and "Data4"
+    And the table should have "3" rows
+    And row "2" should have "2" columns
+    And the data for the second row should be "Data1" and "Data2"
+    And the data for the last row should be "Data3" and "Data4"
+    
+  Scenario: Retrieve data from a table using a row header
+    When I retrieve a table element
+    Then the data for row "Data3" should be "Data3" and "Data4"
+
+  Scenario: Retrieve data from a table using a partial row header
+    When I retrieve a table element
+    Then the data for row "ata3" should be "Data3" and "Data4"
+
+  Scenario: Retrieve data from a table using a row header in the 2nd column
+    When I retrieve a table element
+    Then the data for row "Data4" should be "Data3" and "Data4"
+
+  Scenario: Retrieve data from a table using a partial row header in the 2nd column
+    When I retrieve a table element
+    Then the data for row "ata4" should be "Data3" and "Data4"
+
+  Scenario: Retrieve data from a table using a column header
+    When I retrieve a table element
+    Then the data for column "Header" and row "3" should be "Data4"
+
+  Scenario: Retrieve data from a table with a thead using a column header
+    When I retrieve a table with thead element
+    Then the data for column "Col1" and row "2" should be "Data1"
+
+  Scenario: Retrieve data from the first row of a table with a thead using a column header
+    When I retrieve a table with thead element
+    Then the data for column "Col1" and row "1" should be "Col1"
+
+  Scenario: Retrieve data from a table using a partial column header
+    When I retrieve a table element
+    Then the data for column "eader" and row "3" should be "Data4"
+
+  Scenario: Retrieve data from a table using both headers
+    When I retrieve a table element
+    Then the data for row "Data3" and column "eader" should be "Data4"
+
+  Scenario: Retrieve data from a table with an incorrect row header
+    When I retrieve a table element
+    Then the data for row "Data20" should be nil
+
+  Scenario: Retrieve data from a table with an incorrect column header
+    When I retrieve a table element
+    Then the data for row "Data3" and column "Data20" should be nil
+
+  Scenario: Retrieve data from a table that does not have a cell which corresponds to a column header
+    When I retrieve a table with thead element
+    Then the data for row "Data5" and column "Col2" should be nil
+
+  Scenario Outline: Locating table cells on the Page
+    When I retrieve a table element by "<search_by>"
+    Then the data for row "2" should be "Data1" and "Data2"
+
+  Scenarios:
+    | search_by |
+    | id        |
+    | class     |
+    | xpath     |
+    | index     |
+    | name      |
+
+  Scenario: Matching the expected table with the table on the Page
+    When I retrieve a table element
+    Then the table should be like the expected one
+      | Table | Header |
+      | Data1 | Data2  |
+      | Data3 | Data4  |
+
+
+  @selenium_only
+  Scenario Outline: Locating table cells on the Page
+    When I retrieve a table element by "<search_by>"
+    Then the data for row "2" should be "Data1" and "Data2"
+
+  Scenarios:
+    | search_by |
+    | css       |
+
+  Scenario Outline: Locating table using multiple parameters
+    When I retrieve a table element by "<param1>" and "<param2>"
+    Then the data for row "2" should be "Data1" and "Data2"
+
+  Scenarios:
+    | param1 | param2 |
+    | class  | index  |
+    | name   | index  |
+
+  Scenario: Finding a table dynamically
+    When I retrieve a table element while the script is executing
+    And the data for row "2" should be "Data1" and "Data2"
+
+  @watir_only
+  Scenario: Finding an existing table
+    Then I should see that the table exists
+
+  Scenario: Getting the text from a table
+    Then I should see the text includes "Data1" when I retrieve it by "id"
+    And I should see the text includes "Data2" when I retrieve it by "id"

data/features/table_cell.feature

@@ -0,0 +1,45 @@
+Feature: Table Cell
+
+
+  Background:
+    Given I am on the static elements page
+
+  Scenario: Retrieving the text from a table cell
+    When I retrieve the data from the table cell
+    Then the cell data should be 'Data4'
+
+  Scenario Outline: Locating table cells on the Page
+    When I search for the table cell by "<search_by>"
+    Then the cell data should be 'Data4'
+
+  Scenarios:
+    | search_by |
+    | id        |
+    | class     |
+    | xpath     |
+    | name      |
+    | text      |
+    | css       |
+
+  @watir_only
+  Scenario Outline: Locating table cells on the Page with watir
+    When I search for the table cell by "<search_by>"
+    Then the cell data should be 'Data4'
+
+  Scenarios:
+    | search_by |
+    | index     |
+
+  Scenario Outline: Locating table cell using multiple parameters
+    When I retrieve a table cell element by "<param1>" and "<param2>"
+    Then the cell data should be 'Data4'
+
+  Scenarios:
+    | param1 | param2 |
+    | class  | index  |
+    | name   | index  |
+
+  Scenario: Finding a table cell dynamically
+    When I retrieve a table cell element while the script is executing
+    Then I should see that the cell exists
+    And the cell data should be 'Data4'

data/features/table_row.feature

@@ -0,0 +1,43 @@
+Feature: Table Row
+  
+  Background:
+    Given I am on the static elements page
+
+  Scenario: Retrieving the text from a table row
+    When I retrieve the data from the table row
+    Then the row data should be 'Data1 Data2'
+
+  Scenario Outline: Locating table rows on the Page
+    When I search for the table row by "<search_by>"
+    Then the row data should be 'Data1 Data2'
+
+    Scenarios:
+      | search_by |
+      | id        |
+      | class     |
+      | xpath     |
+      | css       |
+
+
+  @watir_only
+  Scenario: Locating table rows on the Page by text
+    When I search for the table row by "text"
+    Then the row data should be 'Data1 Data2'
+
+  @watir_only
+  Scenario Outline: Locating table rows on the Page with watir
+    When I search for the table row by "<search_by>"
+    Then the row data should be 'Data1 Data2'
+
+    Scenarios:
+      | search_by |
+      | index     |
+
+  Scenario: Locating table row using multiple parameters
+    When I retrieve a table row element by "class" and "index"
+    Then the row data should be 'Data1 Data2'
+
+  Scenario: Finding a table row dynamically
+    When I retrieve a table row element while the script is executing
+    Then I should see that the row exists
+    And the row data should be 'Data1 Data2'

data/features/text_area.feature

@@ -0,0 +1,51 @@
+Feature: Text Area
+
+
+  Background:
+    Given I am on the static elements page
+
+  Scenario: Setting and getting a value from a text area
+    When I type "abcdefghijklmnop" into the text area
+    Then the text area should contain "abcdefghijklmnop"
+
+  Scenario Outline: Locating text area on the Page
+    When I search for the text area by "<search_by>"
+    Then I should be able to type "I found it" into the area
+
+  Scenarios:
+    | search_by |
+    | id        |
+    | class     |
+    | name      |
+    | xpath     |
+    | index     |
+    | label     |
+
+  @selenium_only
+  Scenario Outline: Locating text area on the Page
+    When I search for the text area by "<search_by>"
+    Then I should be able to type "I found it" into the area
+
+  Scenarios:
+    | search_by |
+    | css       |
+
+  Scenario Outline: Locating a text area using multiple parameters
+    When I search for the text area by "<param1>" and "<param2>"
+    Then I should be able to type "I found it" into the area
+
+  Scenarios:
+    | param1 | param2 |
+    | class  | index  |
+    | name   | index  |
+
+  Scenario: Finding a text area dynamically
+    When I find a text area while the script is executing
+    Then I should see that the text area exists
+    And I should be able to type "I found it" into the area element
+
+  Scenario: Clearing the text area
+    When I type "abcdefghijklmnop" into the text area
+    Then the text area should contain "abcdefghijklmnop"
+    When I clear the text area
+    Then the text area should contain ""

data/features/text_field.feature

@@ -0,0 +1,70 @@
+Feature: Text Fields
+  In order to interact with text fields
+  Testers will need access and interrogation ability
+
+
+  Background:
+    Given I am on the static elements page
+
+  Scenario: Setting and getting a value from a text field
+    When I type "abcDEF" into the text field
+    Then the text field should contain "abcDEF"
+
+  Scenario Outline: Locating text fields on the Page
+    When I search for the text field by "<search_by>"
+    Then I should be able to type "I found it" into the field
+
+  Examples:
+    | search_by  |
+    | id         |
+    | class      |
+    | name       |
+    | xpath      |
+    | index      |
+    | title      |
+    | text       |
+    | label      |
+
+
+  @watir_only
+  Scenario Outline: Locating text fields on the Page using Watir
+    When I search for the text field by "<search_by>"
+    Then I should be able to type "I found it" into the field
+  Examples:
+    | search_by  |
+    | data_field |
+
+  @selenium_only
+  Scenario Outline: Locating text fields on the Page using Selenium
+    When I search for the text field by "<search_by>"
+    Then I should be able to type "I found it" into the field
+
+  Examples:
+    | search_by |
+    | css       |
+
+
+  Scenario Outline: Locating a text field using multiple parameters
+    When I search for the text field by "<param1>" and "<param2>"
+    Then I should be able to type "I found it" into the field
+
+  Examples:
+    | param1 | param2 |
+    | class  | index  |
+    | name   | index  |
+
+  Scenario: Retrieve a text field
+    When I retrieve a text field
+    Then I should know it exists
+    And I should know it is visible
+
+  Scenario: Finding a text field dynamically
+    When I find a text field while the script is executing
+    Then I should see that the text field exists
+    And I should be able to type "I found it" into the field element
+
+  Scenario: Appending text to a text field
+    When I type "abcd" into the text field
+    And I append "efg" to the text field
+    Then the text field should contain "abcdefg"
+