testcentricity_web 1.0.3 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 828ba7ccba0258caff9d05dbc66af20c6c87a915
-  data.tar.gz: 2a021784f3c899fdd34cebfcd490c6e44b911cfc
+  metadata.gz: 47950cb4c712070298ad6deb05d1b50ae5f18009
+  data.tar.gz: 567501e936e2fcbac0a57e1c866cb921afc5d7b2
 SHA512:
-  metadata.gz: 2ed47cdbaa73967009d8caf713d698ed17c541f569a4385416ba78d1a3a39992a1b1701b1ff814c0d2fe57a303390f207dd4b9acb8b46fdb6aa51a52070df33b
-  data.tar.gz: 3e30928f42b8a80a325f52b46e095cb34678183662f776cd8e27511227f80bb091f3e0da496c1e05e33fc8ee199c4b410a77740f98d39b0c4b936b92f2c705c7
+  metadata.gz: b13b00820983439f0bbe49be197f975d10ec163b8cfc72f27b4a0e4333fdb57697acd41276ec533036f4e8429d5dd420c9df7417db8201f223a9da7ebe7af7a5
+  data.tar.gz: 0bdcf538a51a41cd76150c5b424f013cf06fa1548b5b8a91c2eba2eb07f927104e8fa37ebf33a30936ca305386c69f15784e9f42b3e1cedb1df3b5b23880a42e

data/README.md

@@ -102,13 +102,18 @@ test automation project. You define new **Page Objects** as shown below:
     end
 
 
+    class RegistrationPage < TestCentricity::PageObject
+    end
+
+
 ### Adding Traits to your Page Object
 
 Web pages typically have names and URLs associated with them. Web pages also typically have a unique object or attribute that, when present,
 indicates that the page's contents have fully loaded.
 
 The `page_name` trait is registered with the **PageManager** object, which includes a `find_page` method that takes a page name as a
-parameter and returns an instance of the associated **Page Object**.
+parameter and returns an instance of the associated **Page Object**. If you intend to use the **PageManager**, you must define a `page_name`
+trait for each of the **Page Objects** to be registered.
 
 A `page_url` trait should be defined if a page can be directly loaded using a URL. If you set Capybara's `app_host`, or specify a base URL
 when calling the `WebDriverConnect.initialize_web_driver` method, then your `page_url` trait can be the relative URL slug that will
@@ -135,6 +140,13 @@ You define your page's **Traits** as shown below:
     end
 
 
+    class RegistrationPage < TestCentricity::PageObject
+      trait(:page_name)       { 'Registration' }
+      trait(:page_url)        { '/register' }
+      trait(:page_locator)    { 'body.registration' }
+    end
+
+
 ### Adding UI Elements to your Page Object
 
 **UI Elements** are added to your **Page Object** class definition as shown below:
@@ -196,6 +208,7 @@ the UI to hide implementation details, as shown below:
             password_field       => { :visible => true, :enabled => true, :value => '', :placeholder => 'Password' },
             remember_checkbox    => { :exists  => true, :enabled => true, :checked => false },
             forgot_password_link => { :visible => true, :value => 'Forgot your password?' },
+            error_message_label  => { :visible => false }
             }
         verify_ui_states(ui)
         super
@@ -331,6 +344,7 @@ to be instantiated by **PageManager**:
         { :login_page                => LoginPage,
           :home_page                 => HomePage,
           :registration_page         => RegistrationPage,
+          :search_results_page       => SearchResultsPage,
           :products_grid_page        => ProductsCollectionPage,
           :product_detail_page       => ProductDetailPage,
           :shopping_basket_page      => ShoppingBasketPage,
@@ -353,14 +367,75 @@ executed:
     include WorldPages
     WorldPages.instantiate_page_objects
     
+**NOTE:** If you intend to use the **PageManager**, you must define a `page_name` trait for each of the **Page Objects** to be registered.
+
+
+### Leveraging the PageManager from Cucumber
+
+
+
+    Scenario Outline:  Verify Home page navigation links
+      Given I am on the Home page
+      When I click the <page> navigation link
+      Then I expect the <page> page to be correctly displayed
+    
+      Examples:
+        |page                    |
+        |Registration            |
+        |My Account              |
+        |Terms & Conditions      |
+        |Privacy Policy          |
+        |FAQs                    |
+        |Refunds & Cancellations |
+        |Contact US              |
+
+
+Include the step definitions and code below in a `page_steps.rb` or `generic_steps.rb` file in the `features/step_definitions` folder:
+
+    include TestCentricity
+    
+    Given(/^I am (?:on|viewing) the ([^\"]*) page$/) do |page_name|
+      target_page = page_dispatcher(page_name)
+      target_page.load_page if target_page
+      PageManager.set_current_page(target_page)
+    end
+    
+    When(/^I click the ([^\"]*) navigation link$/) do |link_name|
+      target_page = page_dispatcher(link_name)
+      target_page.navigate_to if target_page
+    end
+    
+    Then(/^I expect to see the ([^\"]*) page$/) do |page_name|
+      target_page = page_dispatcher(page_name)
+      target_page.verify_page_exists if target_page
+      PageManager.set_current_page(target_page)
+    end
+    
+    Then(/^I expect the ([^\"]*) page to be correctly displayed$/) do |page_name|
+      target_page = page_dispatcher(page_name)
+      if target_page
+        target_page.verify_page_exists
+        target_page.verify_page_ui
+        PageManager.set_current_page(target_page)
+      end
+    end
+    
+    
+    # this method that takes a page name as a parameter and returns an instance of the associated Page Object
+    def page_dispatcher(page_name)
+      page = PageManager.find_page(page_name)
+      raise "No page object defined for page named '#{page_name}'" unless page
+      page
+    end
+
 
 
 ## Connecting to a Web Browser
 
-The `WebDriverConnect.initialize_web_driver` method configures the appropriate selenium-webdriver capabilities required to establish a
+The `TestCentricity::WebDriverConnect.initialize_web_driver` method configures the appropriate selenium-webdriver capabilities required to establish a
 connection with a target web browser, and sets the base host URL of the web site you are running your tests against.
 
-The `WebDriverConnect.initialize_web_driver` method accepts a single optional parameter - the base host URL. Cucumber **Environment
+The `TestCentricity::WebDriverConnect.initialize_web_driver` method accepts a single optional parameter - the base host URL. Cucumber **Environment
 Variables** are used to specify the target local or remote web browser, and the various webdriver capability parameters required to configure
 the connection.
 
@@ -427,8 +502,9 @@ to `chrome`.
 
 ### Mobile Safari browser on iOS Simulators
 
-You can run your mobile web tests against the mobile Safari browser on simulated iOS devices using Appium and XCode on OS X. You must install XCode
-and Appium, and ensure that the `appium_capybara` gem is installed and required as described in **section 2.4 (Setup - Using Appium)** above.
+You can run your mobile web tests against the mobile Safari browser on simulated iOS devices using Appium and XCode on OS X. You must install XCode, the
+iOS version-specific device simulators for XCode, and Appium. You must ensure that the `appium_capybara` gem is installed and required as described in
+**section 2.4 (Setup - Using Appium)** above.
 
 Appium must be running prior to invoking Cucumber to run your features/scenarios.
 
@@ -460,7 +536,8 @@ staging server inside your LAN, you must set the `TUNNELING` Environment Variabl
 #### Remote desktop browsers on the BrowserStack service
 
 For remotely hosted desktop web browsers on the BrowserStack service, the following **Environment Variables** must be set as described in
-the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities#capabilities-browserstack) for information regarding the specific capabilities.
+the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities#capabilities-browserstack)
+for information regarding the specific capabilities.
 
 **Environment Variable** | **Description**
 --------------- | ----------------
@@ -479,7 +556,8 @@ the table below. Refer to the [Browserstack-specific capabilities chart page](ht
 #### Remote mobile browsers on the BrowserStack service
 
 For remotely hosted mobile web browsers on the BrowserStack service, the following **Environment Variables** must be set as described in
-the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities#capabilities-browserstack) for information regarding the specific capabilities.
+the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities#capabilities-browserstack)
+for information regarding the specific capabilities.
 
 **Environment Variable** | **Description**
 --------------- | ----------------
@@ -497,7 +575,8 @@ the table below. Refer to the [Browserstack-specific capabilities chart page](ht
 #### Remote desktop browsers on the CrossBrowserTesting service
 
 For remotely hosted desktop web browsers on the CrossBrowserTesting service, the following **Environment Variables** must be set as described in
-the table below. Use the Configuration Wizard on the [Start a Selenium Test page](https://app.crossbrowsertesting.com/selenium/run) to obtain information regarding the specific capabilities.
+the table below. Use the Configuration Wizard on the [Start a Selenium Test page](https://app.crossbrowsertesting.com/selenium/run) to obtain
+information regarding the specific capabilities.
 
 **Environment Variable** | **Description**
 --------------- | ----------------
@@ -513,7 +592,8 @@ the table below. Use the Configuration Wizard on the [Start a Selenium Test page
 #### Remote mobile browsers on the CrossBrowserTesting service
 
 For remotely hosted mobile web browsers on the CrossBrowserTesting service, the following **Environment Variables** must be set as described in
-the table below. Use the Configuration Wizard on the [Start a Selenium Test page](https://app.crossbrowsertesting.com/selenium/run) to obtain information regarding the specific capabilities.
+the table below. Use the Configuration Wizard on the [Start a Selenium Test page](https://app.crossbrowsertesting.com/selenium/run) to obtain
+information regarding the specific capabilities.
 
 **Environment Variable** | **Description**
 --------------- | ----------------
@@ -529,7 +609,8 @@ the table below. Use the Configuration Wizard on the [Start a Selenium Test page
 #### Remote desktop browsers on the Sauce Labs service
 
 For remotely hosted desktop web browsers on the Sauce Labs service, the following **Environment Variables** must be set as described in
-the table below. Use the Selenium API on the [Platform Configurator page](https://wiki.saucelabs.com/display/DOCS/Platform+Configurator#/) to obtain information regarding the specific capabilities.
+the table below. Use the Selenium API on the [Platform Configurator page](https://wiki.saucelabs.com/display/DOCS/Platform+Configurator#/) to obtain
+information regarding the specific capabilities.
 
 **Environment Variable** | **Description**
 --------------- | ----------------
@@ -546,7 +627,8 @@ the table below. Use the Selenium API on the [Platform Configurator page](https:
 #### Remote mobile browsers on the Sauce Labs service
 
 For remotely hosted mobile web browsers on the Sauce Labs service, the following **Environment Variables** must be set as described in
-the table below. Use the Selenium API on the [Platform Configurator page](https://wiki.saucelabs.com/display/DOCS/Platform+Configurator#/) to obtain information regarding the specific capabilities.
+the table below. Use the Selenium API on the [Platform Configurator page](https://wiki.saucelabs.com/display/DOCS/Platform+Configurator#/) to obtain
+information regarding the specific capabilities.
 
 **Environment Variable** | **Description**
 --------------- | ----------------
@@ -564,7 +646,8 @@ the table below. Use the Selenium API on the [Platform Configurator page](https:
 #### Remote desktop browsers on the TestingBot service
 
 For remotely hosted desktop web browsers on the TestingBot service, the following **Environment Variables** must be set as described in
-the table below. Refer to the [TestingBot List of Available Browsers page](https://testingbot.com/support/getting-started/browsers.html) for information regarding the specific capabilities.
+the table below. Refer to the [TestingBot List of Available Browsers page](https://testingbot.com/support/getting-started/browsers.html) for information
+regarding the specific capabilities.
 
 **Environment Variable** | **Description**
 --------------- | ----------------

data/lib/testcentricity_web/browser_helper.rb

@@ -64,6 +64,14 @@ module TestCentricity
       Capybara.page.driver.browser.switch_to.window(Capybara.page.driver.browser.window_handles.last)
     end
 
+    def self.suppress_js_alerts
+      page.execute_script("window.alert = function() {}")
+    end
+
+    def self.suppress_js_leave_page_modal
+      page.execute_script('window.onbeforeunload = null')
+    end
+
     def self.delete_all_cookies
       if Capybara.current_driver == :selenium
         browser = Capybara.current_session.driver.browser

data/lib/testcentricity_web/elements/select_list.rb

@@ -80,6 +80,8 @@ module TestCentricity
       end
     end
 
+    alias :get_list_items :get_options
+
     # Return the number of options in a select box object.
     # Supports standard HTML select objects and Chosen select objects.
     #
@@ -97,6 +99,8 @@ module TestCentricity
       end
     end
 
+    alias :get_item_count :get_option_count
+
     def verify_options(expected, enqueue = false)
       actual = get_options
       enqueue ?
@@ -121,6 +125,8 @@ module TestCentricity
       end
     end
 
+    alias :selected? :get_selected_option
+
     # Select the specified option in a Siebel OUI select box object.
     #
     # @param option [String] text of option to select

data/lib/testcentricity_web/page_objects_helper.rb

@@ -12,7 +12,7 @@ module TestCentricity
     # @param block [&block] trait value
     # @example
     #   trait(:page_name)     { 'Shopping Basket' }
-    #   trait(:page_url)      { "/shopping_basket" }
+    #   trait(:page_url)      { '/shopping_basket' }
     #   trait(:page_locator)  { "//body[@class='shopping_baskets']" }
     #
     def self.trait(trait_name, &block)
@@ -31,30 +31,74 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :page);end))
     end
 
+    # Declare and instantiate a collection of generic UI Elements for this page object.
+    #
+    # @param element_hash [Hash] names of UI objects (as a symbol) and CSS selectors or XPath expressions that uniquely identifies objects
+    # @example
+    #   elements  profile_item:  'a#profile',
+    #             settings_item: 'a#userPreferencesTrigger',
+    #             log_out_item:  'a#logout'
+    #
+    def self.elements(element_hash)
+      element_hash.each do |element_name, locator|
+        element(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a button UI Element for this page object.
     #
     # @param element_name [Symbol] name of button object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
-    #   button :checkout_button, "button.checkout_button"
+    #   button :checkout_button, 'button.checkout_button'
     #   button :login_button,    "//input[@id='submit_button']"
     #
     def self.button(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Button.new(self, "#{locator}", :page);end))
     end
 
+    # Declare and instantiate a collection of buttons for this page object.
+    #
+    # @param element_hash [Hash] names of buttons (as a symbol) and CSS selectors or XPath expressions that uniquely identifies buttons
+    # @example
+    #     buttons      new_account_button:  'button#new-account',
+    #                  save_button:         'button#save',
+    #                  cancel_button:       'button#cancel'
+    #
+    def self.buttons(element_hash)
+      element_hash.each do |element_name, locator|
+        button(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a text field UI Element for this page object.
     #
     # @param element_name [Symbol] name of text field object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
     #   textfield :user_id_field,  "//input[@id='UserName']"
-    #   textfield :password_field, "consumer_password"
+    #   textfield :password_field, 'consumer_password'
     #
     def self.textfield(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::TextField.new(self, "#{locator}", :page);end))
     end
 
+    # Declare and instantiate a collection of text fields for this page object.
+    #
+    # @param element_hash [Hash] names of text fields (as a symbol) and CSS selectors or XPath expressions that uniquely identifies text fields
+    # @example
+    #       textfields  name_field:    'input#Name',
+    #                   title_field:   'input#Title',
+    #                   phone_field:   'input#PhoneNumber',
+    #                   fax_field:     'input#FaxNumber',
+    #                   email_field:   'input#Email'
+    #
+    def self.textfields(element_hash)
+      element_hash.each do |element_name, locator|
+        textfield(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a checkbox UI Element for this page object.
     #
     # @param element_name [Symbol] name of checkbox object (as a symbol)
@@ -62,12 +106,18 @@ module TestCentricity
     # @param proxy [Symbol] Optional name (as a symbol) of proxy object to receive click actions
     # @example
     #   checkbox :remember_checkbox,     "//input[@id='RememberUser']"
-    #   checkbox :accept_terms_checkbox, "#accept_terms_conditions", :accept_terms_label
+    #   checkbox :accept_terms_checkbox, 'input#accept_terms_conditions', :accept_terms_label
     #
     def self.checkbox(element_name, locator, proxy = nil)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::CheckBox.new(self, "#{locator}", :page, #{proxy});end))
     end
 
+    def self.checkboxes(element_hash)
+      element_hash.each do |element_name, locator|
+        checkbox(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a radio button UI Element for this page object.
     #
     # @param element_name [Symbol] name of radio object (as a symbol)
@@ -75,12 +125,18 @@ module TestCentricity
     # @param proxy [Symbol] Optional name (as a symbol) of proxy object to receive click actions
     # @example
     #   radio :accept_terms_radio,  "//input[@id='Accept_Terms']"
-    #   radio :decline_terms_radio, "#decline_terms_conditions", :decline_terms_label
+    #   radio :decline_terms_radio, '#decline_terms_conditions', :decline_terms_label
     #
     def self.radio(element_name, locator, proxy = nil)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Radio.new(self, "#{locator}", :page, #{proxy});end))
     end
 
+    def self.radios(element_hash)
+      element_hash.each do |element_name, locator|
+        radio(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a label UI Element for this page object.
     #
     # @param element_name [Symbol] name of label object (as a symbol)
@@ -93,22 +149,34 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Label.new(self, "#{locator}", :page);end))
     end
 
+    def self.labels(element_hash)
+      element_hash.each do |element_name, locator|
+        label(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a link UI Element for this page object.
     #
     # @param element_name [Symbol] name of link object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
-    #   link :registration_link,    "a.account-nav__link.register"
+    #   link :registration_link,    'a.account-nav__link.register'
     #   link :shopping_basket_link, "//a[@href='shopping_basket']"
     #
     def self.link(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Link.new(self, "#{locator}", :page);end))
     end
 
+    def self.links(element_hash)
+      element_hash.each do |element_name, locator|
+        link(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a table UI Element for this page object.
     #
     # @param element_name [Symbol] name of table object (as a symbol)
-    # @param locator [String] CSS selector or XPath expression that uniquely identifies object
+    # @param locator [String] XPath expression that uniquely identifies object
     # @example
     #   table :payments_table, "//table[@class='payments_table']"
     #
@@ -116,47 +184,71 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Table.new(self, "#{locator}", :page);end))
     end
 
+    def self.tables(element_hash)
+      element_hash.each do |element_name, locator|
+        table(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a select list UI Element for this page object.
     #
     # @param element_name [Symbol] name of select list object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
-    #   selectlist :category_selector, "#search_form_category_chosen"
+    #   selectlist :category_selector, 'select#search_form_category_chosen'
     #   selectlist :gender_select,     "//select[@id='customer_gender']"
     #
     def self.selectlist(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::SelectList.new(self, "#{locator}", :page);end))
     end
 
+    def self.selectlists(element_hash)
+      element_hash.each do |element_name, locator|
+        selectlist(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a list UI Element for this page object.
     #
     # @param element_name [Symbol] name of list object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
-    #   list :x_axis_list, "g.x-axis"
+    #   list :x_axis_list, 'g.x-axis'
     #
     def self.list(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::List.new(self, "#{locator}", :page);end))
     end
 
+    def self.lists(element_hash)
+      element_hash.each do |element_name, locator|
+        list(element_name, locator)
+      end
+    end
+
     # Declare and instantiate an image UI Element for this page object.
     #
     # @param element_name [Symbol] name of image object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
-    #   image :basket_item_image,    "div.product_image"
+    #   image :basket_item_image,    'div.product_image'
     #   image :corporate_logo_image, "//img[@alt='MyCompany_logo']"
     #
     def self.image(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Image.new(self, "#{locator}", :page);end))
     end
 
+    def self.images(element_hash)
+      element_hash.each do |element_name, locator|
+        image(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a File Field UI Element for this page object.
     #
     # @param element_name [Symbol] name of file field object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
-    #   filefield :attach_file, "s_SweFileName"
+    #   filefield :attach_file, 's_SweFileName'
     #
     def self.filefield(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::FileField.new(self, "#{locator}", :page);end))
@@ -173,6 +265,12 @@ module TestCentricity
       class_eval(%Q(def #{section_name.to_s};@#{section_name.to_s} ||= #{class_name.to_s}.new(self, "#{locator}", :page);end))
     end
 
+    def self.sections(section_hash)
+      section_hash.each do |section_name, class_name|
+        section(section_name, class_name)
+      end
+    end
+
     def open_portal
       environment = Environ.current
       environment.hostname.blank? ?
@@ -187,6 +285,7 @@ module TestCentricity
     end
 
     def verify_page_exists
+      raise "Page object #{self.class.name} does not have a page_locator trait defined" unless defined?(page_locator)
       unless page.has_selector?(page_locator)
         body_class = find(:xpath, '//body')[:class]
         error_message = "Expected page to have selector '#{page_locator}' but found '#{body_class}' instead.\nURL of page loaded = #{URI.parse(current_url)}"
@@ -224,6 +323,7 @@ module TestCentricity
     #   home_page.exists?
     #
     def exists?
+      raise "Page object #{self.class.name} does not have a page_locator trait defined" unless defined?(page_locator)
       saved_wait_time = Capybara.default_max_wait_time
       Capybara.default_max_wait_time = 0.1
       tries ||= 2
@@ -268,12 +368,8 @@ module TestCentricity
             when :checked
               actual = ui_object.checked?
             when :selected
-              if ui_object.get_object_type == :selectlist
-                actual = ui_object.get_selected_option
-              else
-                actual = ui_object.selected?
-              end
-            when :value
+              actual = ui_object.selected?
+            when :value, :caption
               actual = ui_object.get_value
             when :maxlength
               actual = ui_object.get_max_length
@@ -284,17 +380,9 @@ module TestCentricity
             when :placeholder
               actual = ui_object.get_placeholder
             when :options, :items, :list_items
-              if ui_object.get_object_type == :selectlist
-                actual = ui_object.get_options
-              else
-                actual = ui_object.get_list_items
-              end
+              actual = ui_object.get_list_items
             when :optioncount, :itemcount
-              if ui_object.get_object_type == :selectlist
-                actual = ui_object.get_option_count
-              else
-                actual = ui_object.get_item_count
-              end
+              actual = ui_object.get_item_count
             when :column_headers
               actual = ui_object.get_header_columns
             when :siebel_options
@@ -355,7 +443,7 @@ module TestCentricity
     #            email_field        => 'p.pumperknickle4876@google.com',
     #            mailing_list_check => 'Yes'
     #          }
-    #   registration_page.populate_data_fields(data)
+    #   populate_data_fields(data)
     #
     def populate_data_fields(data)
       data.each do | data_field, data_param |

data/lib/testcentricity_web/page_sections_helper.rb

@@ -33,36 +33,54 @@ module TestCentricity
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
     #   element :undo_record_item,  "//li[@rn='Undo Record']/a"
-    #   element :basket_header,     "div.basket_header"
+    #   element :basket_header,     'div.basket_header'
     #
     def self.element(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::UIElement.new(self, "#{locator}", :section);end))
     end
 
+    def self.elements(element_hash)
+      element_hash.each do |element_name, locator|
+        element(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a button UI Element for this page section.
     #
     # @param element_name [Symbol] name of button object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
-    #   button :checkout_button, "button.checkout_button"
+    #   button :checkout_button, 'button.checkout_button'
     #   button :login_button,    "//input[@id='submit_button']"
     #
     def self.button(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Button.new(self, "#{locator}", :section);end))
     end
 
+    def self.buttons(element_hash)
+      element_hash.each do |element_name, locator|
+        button(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a text field UI Element for this page section.
     #
     # @param element_name [Symbol] name of text field object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
     #   textfield :user_id_field,  "//input[@id='UserName']"
-    #   textfield :password_field, "#consumer_password"
+    #   textfield :password_field, 'input#consumer_password'
     #
     def self.textfield(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::TextField.new(self, "#{locator}", :section);end))
     end
 
+    def self.textfields(element_hash)
+      element_hash.each do |element_name, locator|
+        textfield(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a checkbox UI Element for this page section.
     #
     # @param element_name [Symbol] name of checkbox object (as a symbol)
@@ -70,12 +88,18 @@ module TestCentricity
     # @param proxy [Symbol] Optional name (as a symbol) of proxy object to receive click actions
     # @example
     #   checkbox :remember_checkbox,     "//input[@id='RememberUser']"
-    #   checkbox :accept_terms_checkbox, "#accept_terms_conditions", :accept_terms_label
+    #   checkbox :accept_terms_checkbox, 'input#accept_terms_conditions', :accept_terms_label
     #
     def self.checkbox(element_name, locator, proxy = nil)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::CheckBox.new(self, "#{locator}", :section, #{proxy});end))
     end
 
+    def self.checkboxes(element_hash)
+      element_hash.each do |element_name, locator|
+        checkbox(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a radio button UI Element for this page section.
     #
     # @param element_name [Symbol] name of radio object (as a symbol)
@@ -83,12 +107,18 @@ module TestCentricity
     # @param proxy [Symbol] Optional name (as a symbol) of proxy object to receive click actions
     # @example
     #   radio :accept_terms_radio,  "//input[@id='Accept_Terms']"
-    #   radio :decline_terms_radio, "#decline_terms_conditions", :decline_terms_label
+    #   radio :decline_terms_radio, 'input#decline_terms_conditions', :decline_terms_label
     #
     def self.radio(element_name, locator, proxy = nil)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Radio.new(self, "#{locator}", :section, #{proxy});end))
     end
 
+    def self.radios(element_hash)
+      element_hash.each do |element_name, locator|
+        radio(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a label UI Element for this page section.
     #
     # @param element_name [Symbol] name of label object (as a symbol)
@@ -101,18 +131,30 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Label.new(self, "#{locator}", :section);end))
     end
 
+    def self.labels(element_hash)
+      element_hash.each do |element_name, locator|
+        label(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a link UI Element for this page section.
     #
     # @param element_name [Symbol] name of link object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
-    #   link :registration_link,    "a.account-nav__link.register"
+    #   link :registration_link,    'a.account-nav__link.register'
     #   link :shopping_basket_link, "//a[@href='shopping_basket']"
     #
     def self.link(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Link.new(self, "#{locator}", :section);end))
     end
 
+    def self.links(element_hash)
+      element_hash.each do |element_name, locator|
+        link(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a table UI Element for this page section.
     #
     # @param element_name [Symbol] name of table object (as a symbol)
@@ -124,18 +166,30 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Table.new(self, "#{locator}", :section);end))
     end
 
+    def self.tables(element_hash)
+      element_hash.each do |element_name, locator|
+        table(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a select list UI Element for this page section.
     #
     # @param element_name [Symbol] name of select list object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
-    #   selectlist :category_selector, "#search_form_category_chosen"
+    #   selectlist :category_selector, 'select#search_form_category_chosen'
     #   selectlist :gender_select,     "//select[@id='customer_gender']"
     #
     def self.selectlist(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::SelectList.new(self, "#{locator}", :section);end))
     end
 
+    def self.selectlists(element_hash)
+      element_hash.each do |element_name, locator|
+        selectlist(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a list UI Element for this page section.
     #
     # @param element_name [Symbol] name of list object (as a symbol)
@@ -147,24 +201,36 @@ module TestCentricity
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::List.new(self, "#{locator}", :section);end))
     end
 
+    def self.lists(element_hash)
+      element_hash.each do |element_name, locator|
+        list(element_name, locator)
+      end
+    end
+
     # Declare and instantiate an image UI Element for this page section.
     #
     # @param element_name [Symbol] name of image object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
-    #   image :basket_item_image,    "div.product_image"
+    #   image :basket_item_image,    'div.product_image'
     #   image :corporate_logo_image, "//img[@alt='MyCompany_logo']"
     #
     def self.image(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::Image.new(self, "#{locator}", :section);end))
     end
 
+    def self.images(element_hash)
+      element_hash.each do |element_name, locator|
+        image(element_name, locator)
+      end
+    end
+
     # Declare and instantiate a File Field UI Element for this page section.
     #
     # @param element_name [Symbol] name of file field object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
-    #   filefield :attach_file, "s_SweFileName"
+    #   filefield :attach_file, 's_SweFileName'
     #
     def self.filefield(element_name, locator)
       class_eval(%Q(def #{element_name.to_s};@#{element_name.to_s} ||= TestCentricity::FileField.new(self, "#{locator}", :section);end))
@@ -181,6 +247,12 @@ module TestCentricity
       class_eval(%Q(def #{section_name.to_s};@#{section_name.to_s} ||= #{class_name.to_s}.new(self, "#{locator}", :section);end))
     end
 
+    def self.sections(section_hash)
+      section_hash.each do |section_name, class_name|
+        section(section_name, class_name)
+      end
+    end
+
     def get_locator
       (@locator.empty? && defined?(section_locator)) ? locator = section_locator : locator = @locator
       (@context == :section && !@parent.nil? && !@parent.get_locator.nil?) ? "#{@parent.get_locator}|#{locator}" : locator
@@ -308,12 +380,8 @@ module TestCentricity
             when :checked
               actual = ui_object.checked?
             when :selected
-              if ui_object.get_object_type == :selectlist
-                actual = ui_object.get_selected_option
-              else
-                actual = ui_object.selected?
-              end
-            when :value
+              actual = ui_object.selected?
+            when :value, :caption
               actual = ui_object.get_value
             when :maxlength
               actual = ui_object.get_max_length
@@ -324,17 +392,9 @@ module TestCentricity
             when :placeholder
               actual = ui_object.get_placeholder
             when :options, :items, :list_items
-              if ui_object.get_object_type == :selectlist
-                actual = ui_object.get_options
-              else
-                actual = ui_object.get_list_items
-              end
+              actual = ui_object.get_list_items
             when :optioncount, :itemcount
-              if ui_object.get_object_type == :selectlist
-                actual = ui_object.get_option_count
-              else
-                actual = ui_object.get_item_count
-              end
+              actual = ui_object.get_item_count
             when :column_headers
               actual = ui_object.get_header_columns
             when :siebel_options
@@ -396,7 +456,7 @@ module TestCentricity
     #            organ_donor_check  => 'Yes',
     #            dnr_on_file_check  => 'Yes'
     #          }
-    #   patient_record_page.personal_info_widget.populate_data_fields(data)
+    #   populate_data_fields(data)
     #
     def populate_data_fields(data)
       data.each do | data_field, data_param |

data/lib/testcentricity_web/ui_elements_helper.rb

@@ -276,6 +276,8 @@ module TestCentricity
       end
     end
 
+    alias :get_caption :get_value
+
     def verify_value(expected, enqueue = false)
       actual = get_value
       enqueue ?
@@ -283,6 +285,8 @@ module TestCentricity
           assert_equal(expected.strip, actual.strip, "Expected #{@locator} to display '#{expected}' but found '#{actual}'")
     end
 
+    alias :verify_caption :verify_value
+
     # Hover the cursor over an object
     #
     # @example

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '1.0.3'
+  VERSION = '1.0.4'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.4
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-17 00:00:00.000000000 Z
+date: 2016-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler