testcentricity 2.3.14 → 2.3.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 57c238014ed1bde365574c49dfd63c8e9716ea5e
-  data.tar.gz: a6bbe0079660a63178e943152ebac311c710f9f5
+  metadata.gz: c527d51d9b0ba53c2c6f7358138def57dc66fde9
+  data.tar.gz: 80c832950b2faf935c688bdcab670a165337a014
 SHA512:
-  metadata.gz: 0f758a336d3f13a2257a7661160f2019725b98ec108146e9ec2b4c3ae540608721d246ac0b4c559f227234aae2238815b9a08f11ebeb2ac637fed6530e17222e
-  data.tar.gz: d06d2ffca2e97581347f713eefe91b5ed177ba350419c85f3b75dc549c04a507dd5da982db3f1e3800567df1adc42aa5d56f4112a921c5442f546e57147b6f9f
+  metadata.gz: f874c255a407a3b3204d7936d1450a939964ed214b5d20dc43962d957f379f7f5f9bba79c81aafae8bc4d661df3d7f49709f3667fbe4da89b58d799f6a18519f
+  data.tar.gz: 8cd9c7c077a5649f3ff477288b3fb49c4f66bad4b1b3db9c840b0babd321dd981aac664008e98068f418b0e7f18e38374d33c2ca7ecc9df6482eb959130160b6

data/README.md

@@ -1,6 +1,6 @@
-# TestCentricity™
+# TestCentricity™ Web
 
-[![Gem Version](https://badge.fury.io/rb/testcentricity_web.svg)](https://badge.fury.io/rb/testcentricity_web)  [![License (3-Clause BSD)](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg?style=flat-square)](http://opensource.org/licenses/BSD-3-Clause)
+[![Gem Version](https://badge.fury.io/rb/testcentricity.svg)](https://badge.fury.io/rb/testcentricity)  [![License (3-Clause BSD)](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg?style=flat-square)](http://opensource.org/licenses/BSD-3-Clause)
 
 
 The TestCentricity™ Web core generic framework for desktop and mobile web site testing implements a Page Object and Data Object Model DSL for
@@ -28,6 +28,14 @@ hosted instances of Chrome, Firefox, Safari, and IE web browsers.
 
 
 ## What's New
+###Version 2.3.16
+
+* Added `PageSection.double_click`, `PageObject.right_click`, and `PageObject.send_keys` methods.
+
+###Version 2.3.15
+
+* Added `PageObject.wait_until_exists` and `PageObject.wait_until_gone` methods.
+
 ###Version 2.3.14
 
 * Updated device profiles for iPhone 7 (iOS 10) with MS Edge browser.
@@ -132,6 +140,12 @@ use the [parallel_tests gem](https://rubygems.org/gems/parallel_tests) to decrea
 
 
 ## What's Fixed
+
+###Version 2.3.15
+
+* Fixed bug in `UIElement.get_object_type` method that could result in a `NoMethodError obj not defined` error.
+* Fixed bug in `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods that failed to enqueue errors when UI elements could not be found.
+
 ###Version 2.3.8
 
 * Fixed locator resolution for **Indexed PageSection Objects**.

data/lib/devices/devices.yml

@@ -77,7 +77,7 @@
   :css_width: 375
   :css_height: 667
   :default_orientation: portrait
-  :user_agent: "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Version/10.0 EdgiOS/41.10.1.0 Mobile/14G60 Safari/603.3.8"
+  :user_agent: "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Version/10.0 EdgiOS/41.11.0.0 Mobile/14G60 Safari/603.3.8"
 :iphone8:
   :name: "iPhone 8"
   :os: ios

data/lib/testcentricity.rb

@@ -53,6 +53,7 @@ require 'testcentricity/app_elements/switch'
 require 'testcentricity/app_elements/textfield'
 require 'testcentricity/app_elements/list'
 require 'testcentricity/app_elements/image'
+require 'testcentricity/app_elements/select_list'
 require 'testcentricity/app_elements/alert'
 
 

data/lib/testcentricity/app_core/appium_connect_helper.rb

@@ -170,7 +170,7 @@ module TestCentricity
 
     def self.webview_context
       contexts = available_contexts
-      set_context(contexts[1])
+      set_context(contexts.last)
     end
   end
 end

data/lib/testcentricity/app_core/screen_objects_helper.rb

@@ -85,6 +85,16 @@ module TestCentricity
       end
     end
 
+    def self.selectlist(element_name, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppSelectList.new("#{element_name}", self, #{locator}, :page);end))
+    end
+
+    def self.selectlists(element_hash)
+      element_hash.each do |element_name, locator|
+        selectlist(element_name, locator)
+      end
+    end
+
     def self.image(element_name, locator)
       class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppImage.new("#{element_name}", self, #{locator}, :page);end))
     end
@@ -138,6 +148,14 @@ module TestCentricity
       false
     end
 
+    def wait_until_exists(seconds = nil)
+      timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { exists? }
+    rescue
+      raise "Screen object #{self.class.name} not found after #{timeout} seconds" unless exists?
+    end
+
     def wait_until_gone(seconds = nil)
       timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
@@ -249,6 +267,9 @@ module TestCentricity
           end
         end
       end
+    rescue ObjectNotFoundError => e
+      ExceptionQueue.enqueue_exception(e.message)
+    ensure
       ExceptionQueue.post_exceptions
     end
 

data/lib/testcentricity/app_core/screen_sections_helper.rb

@@ -146,6 +146,16 @@ module TestCentricity
       end
     end
 
+    def self.selectlist(element_name, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppSelectList.new("#{element_name}", self, #{locator}, :section);end))
+    end
+
+    def self.selectlists(element_hash)
+      element_hash.each do |element_name, locator|
+        selectlist(element_name, locator)
+      end
+    end
+
     def self.image(element_name, locator)
       class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppImage.new("#{element_name}", self, #{locator}, :section);end))
     end
@@ -376,6 +386,9 @@ module TestCentricity
           end
         end
       end
+    rescue ObjectNotFoundError => e
+      ExceptionQueue.enqueue_exception(e.message)
+    ensure
       ExceptionQueue.post_exceptions
     end
 

data/lib/testcentricity/app_elements/app_element_helper.rb

@@ -331,7 +331,7 @@ module TestCentricity
 
     def object_not_found_exception(obj)
       @type.nil? ? object_type = 'Object' : object_type = @type
-      raise "#{object_type} named '#{@name}' (#{get_locator}) not found" unless obj
+      raise ObjectNotFoundError.new("#{object_type} named '#{@name}' (#{get_locator}) not found") unless obj
     end
 
     def object_ref_message

data/lib/testcentricity/app_elements/select_list.rb

@@ -0,0 +1,147 @@
+module TestCentricity
+  class AppSelectList < UIElement
+    attr_accessor :list_item
+    attr_accessor :selected_item
+
+    def initialize(name, parent, locator, context)
+      super
+      @type = :selectlist
+      list_spec = {
+          :list_item     => 'option',
+          :selected_item => 'option[selected]'
+      }
+      define_list_elements(list_spec)
+    end
+
+    def define_list_elements(element_spec)
+      element_spec.each do |element, value|
+        case element
+        when :list_item
+          @list_item = value
+        when :selected_item
+          @selected_item = value
+        else
+          raise "#{element} is not a recognized selectlist element"
+        end
+      end
+    end
+
+    # Select the specified option in a select box object. Accepts a String or Hash.
+    # Supports standard HTML select objects and Chosen select objects.
+    #
+    # @param option [String] text of option to select
+    #             OR
+    # @param option [Hash] :value, :index, or :text of option to select
+    #
+    # @example
+    #   province_select.choose_option('Alberta')
+    #   province_select.choose_option(:value => 'AB')
+    #   state_select.choose_option(:index => 24)
+    #   state_select.choose_option(:text => 'Maryland')
+    #
+    def choose_option(option)
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      obj.click
+      if first(:css, "li[class*='active-result']")
+        if option.is_a?(Array)
+          option.each do |item|
+            page.find(:css, "li[class*='active-result']", text: item.strip).click
+          end
+        else
+          if option.is_a?(Hash)
+            page.find(:css, "li[class*='active-result']:nth-of-type(#{option[:index]})").click if option.has_key?(:index)
+          else
+            options = obj.all("li[class*='active-result']").collect(&:text)
+            sleep(2) unless options.include?(option)
+            first(:css, "li[class*='active-result']", text: option).click
+          end
+        end
+      else
+        if option.is_a?(Array)
+          option.each do |item|
+            select_item(obj, item)
+          end
+        else
+          select_item(obj, option)
+        end
+      end
+    end
+
+    # Return array of strings of all options in a select box object.
+    # Supports standard HTML select objects and Chosen select objects.
+    #
+    # @return [Array]
+    # @example
+    #   all_colors = color_select.get_options
+    #
+    def get_options
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      if first(:css, "li[class*='active-result']")
+        obj.all("li[class*='active-result']").collect(&:text)
+      else
+        obj.all(@list_item).collect(&:text)
+      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.
+    #
+    # @return [Integer]
+    # @example
+    #   num_colors = color_select.get_option_count
+    #
+    def get_option_count
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      if first(:css, "li[class*='active-result']")
+        obj.all("li[class*='active-result']").count
+      else
+        obj.all(@list_item).count
+      end
+    end
+
+    alias get_item_count get_option_count
+
+    def verify_options(expected, enqueue = false)
+      actual = get_options
+      enqueue ?
+          ExceptionQueue.enqueue_assert_equal(expected, actual, "Expected list of options in list #{object_ref_message}") :
+          assert_equal(expected, actual, "Expected list of options in list #{object_ref_message} to be #{expected} but found #{actual}")
+    end
+
+    # Return text of first selected option in a select box object.
+    # Supports standard HTML select objects and Chosen select objects.
+    #
+    # @return [String]
+    # @example
+    #   current_color = color_select.get_selected_option
+    #
+    def get_selected_option
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      if first(:css, "li[class*='active-result']")
+        obj.first(:css, "li[class*='result-selected']").text
+      else
+        obj.first(@selected_item).text
+      end
+    end
+
+    alias selected? get_selected_option
+
+    private
+
+    def select_item(obj, option)
+      if option.is_a?(Hash)
+        obj.find("option[value='#{option[:value]}']").click if option.has_key?(:value)
+        obj.find(:xpath, "option[#{option[:index]}]").select_option if option.has_key?(:index)
+        obj.select option[:text] if option.has_key?(:text)
+      else
+        obj.select option
+      end
+    end
+  end
+end

data/lib/testcentricity/exception_queue_helper.rb

@@ -48,4 +48,11 @@ module TestCentricity
       Environ.save_screen_shot(screen_shot)
     end
   end
+
+
+  class ObjectNotFoundError < StandardError
+    def initialize(message)
+      super(message)
+    end
+  end
 end

data/lib/testcentricity/version.rb

@@ -1,3 +1,3 @@
 module TestCentricity
-  VERSION = '2.3.14'
+  VERSION = '2.3.16'
 end

data/lib/testcentricity/web_core/page_objects_helper.rb

@@ -458,6 +458,36 @@ module TestCentricity
       Capybara.default_max_wait_time = saved_wait_time
     end
 
+    # Wait until the page object exists, or until the specified wait time has expired. If the wait time is nil, then the wait
+    # time will be Capybara.default_max_wait_time.
+    #
+    # @param seconds [Integer or Float] wait time in seconds
+    # @example
+    #   home_page.wait_until_exists(15)
+    #
+    def wait_until_exists(seconds = nil)
+      timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { exists? }
+    rescue
+      raise "Page object #{self.class.name} not found after #{timeout} seconds" unless exists?
+    end
+
+    # Wait until the page object no longer exists, or until the specified wait time has expired. If the wait time is nil, then
+    # the wait time will be Capybara.default_max_wait_time.
+    #
+    # @param seconds [Integer or Float] wait time in seconds
+    # @example
+    #   verifying_page.wait_until_gone(15)
+    #
+    def wait_until_gone(seconds = nil)
+      timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { !exists? }
+    rescue
+      raise "Page object #{self.class.name} remained visible after #{timeout} seconds" if exists?
+    end
+
     # Is current Page object URL secure?
     #
     # @return [Boolean]
@@ -472,137 +502,137 @@ module TestCentricity
       ui_states.each do |ui_object, object_states|
         object_states.each do |property, state|
           case property
-          when :class
-            actual = ui_object.get_attribute(:class)
-          when :exists
-            actual = ui_object.exists?
-          when :enabled
-            actual = ui_object.enabled?
-          when :disabled
-            actual = ui_object.disabled?
-          when :visible
-            actual = ui_object.visible?
-          when :hidden
-            actual = ui_object.hidden?
-          when :displayed
-            actual = ui_object.displayed?
-          when :width
-            actual = ui_object.width
-          when :height
-            actual = ui_object.height
-          when :x
-            actual = ui_object.x
-          when :y
-            actual = ui_object.y
-          when :readonly
-            actual = ui_object.read_only?
-          when :checked
-            actual = ui_object.checked?
-          when :selected
-            actual = ui_object.selected?
-          when :value, :caption
-            actual = ui_object.get_value
-          when :maxlength
-            actual = ui_object.get_max_length
-          when :rowcount
-            actual = ui_object.get_row_count
-          when :columncount
-            actual = ui_object.get_column_count
-          when :placeholder
-            actual = ui_object.get_placeholder
-          when :min
-            actual = ui_object.get_min
-          when :max
-            actual = ui_object.get_max
-          when :step
-            actual = ui_object.get_step
-          when :options, :items, :list_items
-            actual = ui_object.get_list_items
-          when :optioncount, :itemcount
-            actual = ui_object.get_item_count
-          when :all_items, :all_list_items
-            actual = ui_object.get_all_list_items
-          when :all_items_count
-            actual = ui_object.get_all_items_count
-          when :column_headers
-            actual = ui_object.get_header_columns
-          when :siebel_options
-            actual = ui_object.get_siebel_options
-          else
-            if property.is_a?(Hash)
-              property.each do |key, value|
-                case key
-                when :cell
-                  actual = ui_object.get_table_cell(value[0].to_i, value[1].to_i)
-                when :row
-                  actual = ui_object.get_table_row(value.to_i)
-                when :column
-                  actual = ui_object.get_table_column(value.to_i)
-                when :item
-                  actual = ui_object.get_list_item(value.to_i)
-                when :attribute
-                  actual = ui_object.get_attribute(value)
-                when :native_attribute
-                  actual = ui_object.get_native_attribute(value)
-                end
-              end
+            when :class
+              actual = ui_object.get_attribute(:class)
+            when :exists
+              actual = ui_object.exists?
+            when :enabled
+              actual = ui_object.enabled?
+            when :disabled
+              actual = ui_object.disabled?
+            when :visible
+              actual = ui_object.visible?
+            when :hidden
+              actual = ui_object.hidden?
+            when :displayed
+              actual = ui_object.displayed?
+            when :width
+              actual = ui_object.width
+            when :height
+              actual = ui_object.height
+            when :x
+              actual = ui_object.x
+            when :y
+              actual = ui_object.y
+            when :readonly
+              actual = ui_object.read_only?
+            when :checked
+              actual = ui_object.checked?
+            when :selected
+              actual = ui_object.selected?
+            when :value, :caption
+              actual = ui_object.get_value
+            when :maxlength
+              actual = ui_object.get_max_length
+            when :rowcount
+              actual = ui_object.get_row_count
+            when :columncount
+              actual = ui_object.get_column_count
+            when :placeholder
+              actual = ui_object.get_placeholder
+            when :min
+              actual = ui_object.get_min
+            when :max
+              actual = ui_object.get_max
+            when :step
+              actual = ui_object.get_step
+            when :options, :items, :list_items
+              actual = ui_object.get_list_items
+            when :optioncount, :itemcount
+              actual = ui_object.get_item_count
+            when :all_items, :all_list_items
+              actual = ui_object.get_all_list_items
+            when :all_items_count
+              actual = ui_object.get_all_items_count
+            when :column_headers
+              actual = ui_object.get_header_columns
+            when :siebel_options
+              actual = ui_object.get_siebel_options
             else
-              props = property.to_s.split('_')
-              case props[0].to_sym
-              when :cell
-                cell = property.to_s.delete('cell_')
-                cell = cell.split('_')
-                actual = ui_object.get_table_cell(cell[0].to_i, cell[1].to_i)
-              when :row
-                row = property.to_s.delete('row_')
-                actual = ui_object.get_table_row(row.to_i)
-              when :column
-                column = property.to_s.delete('column_')
-                actual = ui_object.get_table_column(column.to_i)
-              when :item
-                item = property.to_s.delete('item_')
-                actual = ui_object.get_list_item(item.to_i)
+              if property.is_a?(Hash)
+                property.each do |key, value|
+                  case key
+                    when :cell
+                      actual = ui_object.get_table_cell(value[0].to_i, value[1].to_i)
+                    when :row
+                      actual = ui_object.get_table_row(value.to_i)
+                    when :column
+                      actual = ui_object.get_table_column(value.to_i)
+                    when :item
+                      actual = ui_object.get_list_item(value.to_i)
+                    when :attribute
+                      actual = ui_object.get_attribute(value)
+                    when :native_attribute
+                      actual = ui_object.get_native_attribute(value)
+                  end
+                end
+              else
+                props = property.to_s.split('_')
+                case props[0].to_sym
+                  when :cell
+                    cell = property.to_s.delete('cell_')
+                    cell = cell.split('_')
+                    actual = ui_object.get_table_cell(cell[0].to_i, cell[1].to_i)
+                  when :row
+                    row = property.to_s.delete('row_')
+                    actual = ui_object.get_table_row(row.to_i)
+                  when :column
+                    column = property.to_s.delete('column_')
+                    actual = ui_object.get_table_column(column.to_i)
+                  when :item
+                    item = property.to_s.delete('item_')
+                    actual = ui_object.get_list_item(item.to_i)
+                end
               end
-            end
           end
 
           if state.is_a?(Hash) && state.length == 1
             error_msg = "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) #{property} property to"
             state.each do |key, value|
               case key
-              when :lt, :less_than
-                ExceptionQueue.enqueue_exception("#{error_msg} be less than #{value} but found '#{actual}'") unless actual < value
-              when :lt_eq, :less_than_or_equal
-                ExceptionQueue.enqueue_exception("#{error_msg} be less than or equal to #{value} but found '#{actual}'") unless actual <= value
-              when :gt, :greater_than
-                ExceptionQueue.enqueue_exception("#{error_msg} be greater than #{value} but found '#{actual}'") unless actual > value
-              when :gt_eq, :greater_than_or_equal
-                ExceptionQueue.enqueue_exception("#{error_msg} be greater than or equal to  #{value} but found '#{actual}'") unless actual >= value
-              when :starts_with
-                ExceptionQueue.enqueue_exception("#{error_msg} start with '#{value}' but found '#{actual}'") unless actual.start_with?(value)
-              when :ends_with
-                ExceptionQueue.enqueue_exception("#{error_msg} end with '#{value}' but found '#{actual}'") unless actual.end_with?(value)
-              when :contains
-                ExceptionQueue.enqueue_exception("#{error_msg} contain '#{value}' but found '#{actual}'") unless actual.include?(value)
-              when :not_contains, :does_not_contain
-                ExceptionQueue.enqueue_exception("#{error_msg} not contain '#{value}' but found '#{actual}'") if actual.include?(value)
-              when :not_equal
-                ExceptionQueue.enqueue_exception("#{error_msg} not equal '#{value}' but found '#{actual}'") if actual == value
-              when :like, :is_like
-                actual_like = actual.delete("\n")
-                actual_like = actual_like.delete("\r")
-                actual_like = actual_like.delete("\t")
-                actual_like = actual_like.delete(' ')
-                actual_like = actual_like.downcase
-                expected    = value.delete("\n")
-                expected    = expected.delete("\r")
-                expected    = expected.delete("\t")
-                expected    = expected.delete(' ')
-                expected    = expected.downcase
-                ExceptionQueue.enqueue_exception("#{error_msg} be like '#{value}' but found '#{actual}'") unless actual_like.include?(expected)
-              when :translate
-                expected = I18n.t(value)
-                ExceptionQueue.enqueue_assert_equal(expected, actual, "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) translated #{property} property")
+                when :lt, :less_than
+                  ExceptionQueue.enqueue_exception("#{error_msg} be less than #{value} but found '#{actual}'") unless actual < value
+                when :lt_eq, :less_than_or_equal
+                  ExceptionQueue.enqueue_exception("#{error_msg} be less than or equal to #{value} but found '#{actual}'") unless actual <= value
+                when :gt, :greater_than
+                  ExceptionQueue.enqueue_exception("#{error_msg} be greater than #{value} but found '#{actual}'") unless actual > value
+                when :gt_eq, :greater_than_or_equal
+                  ExceptionQueue.enqueue_exception("#{error_msg} be greater than or equal to  #{value} but found '#{actual}'") unless actual >= value
+                when :starts_with
+                  ExceptionQueue.enqueue_exception("#{error_msg} start with '#{value}' but found '#{actual}'") unless actual.start_with?(value)
+                when :ends_with
+                  ExceptionQueue.enqueue_exception("#{error_msg} end with '#{value}' but found '#{actual}'") unless actual.end_with?(value)
+                when :contains
+                  ExceptionQueue.enqueue_exception("#{error_msg} contain '#{value}' but found '#{actual}'") unless actual.include?(value)
+                when :not_contains, :does_not_contain
+                  ExceptionQueue.enqueue_exception("#{error_msg} not contain '#{value}' but found '#{actual}'") if actual.include?(value)
+                when :not_equal
+                  ExceptionQueue.enqueue_exception("#{error_msg} not equal '#{value}' but found '#{actual}'") if actual == value
+                when :like, :is_like
+                  actual_like = actual.delete("\n")
+                  actual_like = actual_like.delete("\r")
+                  actual_like = actual_like.delete("\t")
+                  actual_like = actual_like.delete(' ')
+                  actual_like = actual_like.downcase
+                  expected    = value.delete("\n")
+                  expected    = expected.delete("\r")
+                  expected    = expected.delete("\t")
+                  expected    = expected.delete(' ')
+                  expected    = expected.downcase
+                  ExceptionQueue.enqueue_exception("#{error_msg} be like '#{value}' but found '#{actual}'") unless actual_like.include?(expected)
+                when :translate
+                  expected = I18n.t(value)
+                  ExceptionQueue.enqueue_assert_equal(expected, actual, "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) translated #{property} property")
               end
             end
           else
@@ -610,6 +640,9 @@ module TestCentricity
           end
         end
       end
+    rescue ObjectNotFoundError => e
+      ExceptionQueue.enqueue_exception(e.message)
+    ensure
       ExceptionQueue.post_exceptions
     end
 
@@ -648,18 +681,18 @@ module TestCentricity
             data_field.clear
           else
             case data_field.get_object_type
-            when :checkbox
-              data_field.set_checkbox_state(data_param.to_bool)
-            when :selectlist
-              data_field.get_siebel_object_type == 'JComboBox' ?
-                  data_field.set("#{data_param}\t") :
-                  data_field.choose_option(data_param)
-            when :radio
-              data_field.set_selected_state(data_param.to_bool)
-            when :textfield
-              data_field.set("#{data_param}\t")
-            when :section
-              data_field.set(data_param)
+              when :checkbox
+                data_field.set_checkbox_state(data_param.to_bool)
+              when :selectlist
+                data_field.get_siebel_object_type == 'JComboBox' ?
+                    data_field.set("#{data_param}\t") :
+                    data_field.choose_option(data_param)
+              when :radio
+                data_field.set_selected_state(data_param.to_bool)
+              when :textfield
+                data_field.set("#{data_param}\t")
+              when :section
+                data_field.set(data_param)
             end
           end
         end

data/lib/testcentricity/web_core/page_sections_helper.rb

@@ -48,10 +48,10 @@ module TestCentricity
         locator = "#{@parent_list.get_locator}|#{locator}"
         unless @list_index.nil?
           case @locator_type
-          when :xpath
-            locator = "(#{locator})[#{@list_index}]"
-          when :css
-            locator = "#{locator}:nth-of-type(#{@list_index})"
+            when :xpath
+              locator = "(#{locator})[#{@list_index}]"
+            when :css
+              locator = "#{locator}:nth-of-type(#{@list_index})"
           end
         end
       end
@@ -527,7 +527,7 @@ module TestCentricity
     #
     def disabled?
       section, = find_section
-      raise "Section object '#{get_name}' (#{get_locator}) not found" unless section
+      section_not_found_exception(section)
       section.disabled?
     end
 
@@ -564,7 +564,7 @@ module TestCentricity
     #
     def displayed?
       section, = find_section
-      raise "Section object '#{get_name}' (#{get_locator}) not found" unless section
+      section_not_found_exception(section)
       section.displayed?
     end
 
@@ -628,6 +628,43 @@ module TestCentricity
       raise "Section object '#{get_name}' (#{get_locator}) remained visible after #{timeout} seconds" if visible?
     end
 
+    # Click on a Section object
+    #
+    # @example
+    #   bar_chart_section.click
+    #
+    def click
+      section, = find_section
+      section_not_found_exception(section)
+      begin
+        section.click
+      rescue
+        section.click_at(10, 10) unless Capybara.current_driver == :poltergeist
+      end
+    end
+
+    # Double-click on a Section object
+    #
+    # @example
+    #   bar_chart_section.double_click
+    #
+    def double_click
+      section, = find_section
+      section_not_found_exception(section)
+      page.driver.browser.action.double_click(section.native).perform
+    end
+
+    # Right-click on a Section object
+    #
+    # @example
+    #   bar_chart_section.right_click
+    #
+    def right_click
+      section, = find_section
+      section_not_found_exception(section)
+      page.driver.browser.action.context_click(section.native).perform
+    end
+
     # Click at a specific location within a Section object
     #
     # @param x [Integer] X offset
@@ -637,145 +674,157 @@ module TestCentricity
     #
     def click_at(x, y)
       section, = find_section
-      raise "Section object '#{get_name}' (#{get_locator}) not found" unless section
+      section_not_found_exception(section)
       section.click_at(x, y)
     end
 
+    # Send keystrokes to a Section object
+    #
+    # @param keys [String] keys
+    # @example
+    #   bar_chart_section.send_keys(:enter)
+    #
+    def send_keys(*keys)
+      section, = find_section
+      section_not_found_exception(section)
+      section.send_keys(*keys)
+    end
+
     def verify_ui_states(ui_states)
       ui_states.each do |ui_object, object_states|
         object_states.each do |property, state|
           case property
-          when :class
-            actual = ui_object.get_attribute(:class)
-          when :exists
-            actual = ui_object.exists?
-          when :enabled
-            actual = ui_object.enabled?
-          when :disabled
-            actual = ui_object.disabled?
-          when :visible
-            actual = ui_object.visible?
-          when :hidden
-            actual = ui_object.hidden?
-          when :displayed
-            actual = ui_object.displayed?
-          when :width
-            actual = ui_object.width
-          when :height
-            actual = ui_object.height
-          when :x
-            actual = ui_object.x
-          when :y
-            actual = ui_object.y
-          when :readonly
-            actual = ui_object.read_only?
-          when :checked
-            actual = ui_object.checked?
-          when :selected
-            actual = ui_object.selected?
-          when :value, :caption
-            actual = ui_object.get_value
-          when :maxlength
-            actual = ui_object.get_max_length
-          when :rowcount
-            actual = ui_object.get_row_count
-          when :columncount
-            actual = ui_object.get_column_count
-          when :placeholder
-            actual = ui_object.get_placeholder
-          when :min
-            actual = ui_object.get_min
-          when :max
-            actual = ui_object.get_max
-          when :step
-            actual = ui_object.get_step
-          when :options, :items, :list_items
-            actual = ui_object.get_list_items
-          when :optioncount, :itemcount
-            actual = ui_object.get_item_count
-          when :all_items, :all_list_items
-            actual = ui_object.get_all_list_items
-          when :all_items_count
-            actual = ui_object.get_all_items_count
-          when :column_headers
-            actual = ui_object.get_header_columns
-          when :siebel_options
-            actual = ui_object.get_siebel_options
-          else
-            if property.is_a?(Hash)
-              property.each do |key, value|
-                case key
-                when :cell
-                  actual = ui_object.get_table_cell(value[0].to_i, value[1].to_i)
-                when :row
-                  actual = ui_object.get_table_row(value.to_i)
-                when :column
-                  actual = ui_object.get_table_column(value.to_i)
-                when :item
-                  actual = ui_object.get_list_item(value.to_i)
-                when :attribute
-                  actual = ui_object.get_attribute(value)
-                when :native_attribute
-                  actual = ui_object.get_native_attribute(value)
-                end
-              end
+            when :class
+              actual = ui_object.get_attribute(:class)
+            when :exists
+              actual = ui_object.exists?
+            when :enabled
+              actual = ui_object.enabled?
+            when :disabled
+              actual = ui_object.disabled?
+            when :visible
+              actual = ui_object.visible?
+            when :hidden
+              actual = ui_object.hidden?
+            when :displayed
+              actual = ui_object.displayed?
+            when :width
+              actual = ui_object.width
+            when :height
+              actual = ui_object.height
+            when :x
+              actual = ui_object.x
+            when :y
+              actual = ui_object.y
+            when :readonly
+              actual = ui_object.read_only?
+            when :checked
+              actual = ui_object.checked?
+            when :selected
+              actual = ui_object.selected?
+            when :value, :caption
+              actual = ui_object.get_value
+            when :maxlength
+              actual = ui_object.get_max_length
+            when :rowcount
+              actual = ui_object.get_row_count
+            when :columncount
+              actual = ui_object.get_column_count
+            when :placeholder
+              actual = ui_object.get_placeholder
+            when :min
+              actual = ui_object.get_min
+            when :max
+              actual = ui_object.get_max
+            when :step
+              actual = ui_object.get_step
+            when :options, :items, :list_items
+              actual = ui_object.get_list_items
+            when :optioncount, :itemcount
+              actual = ui_object.get_item_count
+            when :all_items, :all_list_items
+              actual = ui_object.get_all_list_items
+            when :all_items_count
+              actual = ui_object.get_all_items_count
+            when :column_headers
+              actual = ui_object.get_header_columns
+            when :siebel_options
+              actual = ui_object.get_siebel_options
             else
-              props = property.to_s.split('_')
-              case props[0].to_sym
-              when :cell
-                cell = property.to_s.delete('cell_')
-                cell = cell.split('_')
-                actual = ui_object.get_table_cell(cell[0].to_i, cell[1].to_i)
-              when :row
-                row = property.to_s.delete('row_')
-                actual = ui_object.get_table_row(row.to_i)
-              when :column
-                column = property.to_s.delete('column_')
-                actual = ui_object.get_table_column(column.to_i)
-              when :item
-                item = property.to_s.delete('item_')
-                actual = ui_object.get_list_item(item.to_i)
+              if property.is_a?(Hash)
+                property.each do |key, value|
+                  case key
+                    when :cell
+                      actual = ui_object.get_table_cell(value[0].to_i, value[1].to_i)
+                    when :row
+                      actual = ui_object.get_table_row(value.to_i)
+                    when :column
+                      actual = ui_object.get_table_column(value.to_i)
+                    when :item
+                      actual = ui_object.get_list_item(value.to_i)
+                    when :attribute
+                      actual = ui_object.get_attribute(value)
+                    when :native_attribute
+                      actual = ui_object.get_native_attribute(value)
+                  end
+                end
+              else
+                props = property.to_s.split('_')
+                case props[0].to_sym
+                  when :cell
+                    cell = property.to_s.delete('cell_')
+                    cell = cell.split('_')
+                    actual = ui_object.get_table_cell(cell[0].to_i, cell[1].to_i)
+                  when :row
+                    row = property.to_s.delete('row_')
+                    actual = ui_object.get_table_row(row.to_i)
+                  when :column
+                    column = property.to_s.delete('column_')
+                    actual = ui_object.get_table_column(column.to_i)
+                  when :item
+                    item = property.to_s.delete('item_')
+                    actual = ui_object.get_list_item(item.to_i)
+                end
               end
-            end
           end
 
           if state.is_a?(Hash) && state.length == 1
             error_msg = "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) #{property} property to"
             state.each do |key, value|
               case key
-              when :lt, :less_than
-                ExceptionQueue.enqueue_exception("#{error_msg} be less than #{value} but found '#{actual}'") unless actual < value
-              when :lt_eq, :less_than_or_equal
-                ExceptionQueue.enqueue_exception("#{error_msg} be less than or equal to #{value} but found '#{actual}'") unless actual <= value
-              when :gt, :greater_than
-                ExceptionQueue.enqueue_exception("#{error_msg} be greater than #{value} but found '#{actual}'") unless actual > value
-              when :gt_eq, :greater_than_or_equal
-                ExceptionQueue.enqueue_exception("#{error_msg} be greater than or equal to  #{value} but found '#{actual}'") unless actual >= value
-              when :starts_with
-                ExceptionQueue.enqueue_exception("#{error_msg} start with '#{value}' but found '#{actual}'") unless actual.start_with?(value)
-              when :ends_with
-                ExceptionQueue.enqueue_exception("#{error_msg} end with '#{value}' but found '#{actual}'") unless actual.end_with?(value)
-              when :contains
-                ExceptionQueue.enqueue_exception("#{error_msg} contain '#{value}' but found '#{actual}'") unless actual.include?(value)
-              when :not_contains, :does_not_contain
-                ExceptionQueue.enqueue_exception("#{error_msg} not contain '#{value}' but found '#{actual}'") if actual.include?(value)
-              when :not_equal
-                ExceptionQueue.enqueue_exception("#{error_msg} not equal '#{value}' but found '#{actual}'") if actual == value
-              when :like, :is_like
-                actual_like = actual.delete("\n")
-                actual_like = actual_like.delete("\r")
-                actual_like = actual_like.delete("\t")
-                actual_like = actual_like.delete(' ')
-                actual_like = actual_like.downcase
-                expected    = value.delete("\n")
-                expected    = expected.delete("\r")
-                expected    = expected.delete("\t")
-                expected    = expected.delete(' ')
-                expected    = expected.downcase
-                ExceptionQueue.enqueue_exception("#{error_msg} be like '#{value}' but found '#{actual}'") unless actual_like.include?(expected)
-              when :translate
-                expected = I18n.t(value)
-                ExceptionQueue.enqueue_assert_equal(expected, actual, "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) translated #{property} property")
+                when :lt, :less_than
+                  ExceptionQueue.enqueue_exception("#{error_msg} be less than #{value} but found '#{actual}'") unless actual < value
+                when :lt_eq, :less_than_or_equal
+                  ExceptionQueue.enqueue_exception("#{error_msg} be less than or equal to #{value} but found '#{actual}'") unless actual <= value
+                when :gt, :greater_than
+                  ExceptionQueue.enqueue_exception("#{error_msg} be greater than #{value} but found '#{actual}'") unless actual > value
+                when :gt_eq, :greater_than_or_equal
+                  ExceptionQueue.enqueue_exception("#{error_msg} be greater than or equal to  #{value} but found '#{actual}'") unless actual >= value
+                when :starts_with
+                  ExceptionQueue.enqueue_exception("#{error_msg} start with '#{value}' but found '#{actual}'") unless actual.start_with?(value)
+                when :ends_with
+                  ExceptionQueue.enqueue_exception("#{error_msg} end with '#{value}' but found '#{actual}'") unless actual.end_with?(value)
+                when :contains
+                  ExceptionQueue.enqueue_exception("#{error_msg} contain '#{value}' but found '#{actual}'") unless actual.include?(value)
+                when :not_contains, :does_not_contain
+                  ExceptionQueue.enqueue_exception("#{error_msg} not contain '#{value}' but found '#{actual}'") if actual.include?(value)
+                when :not_equal
+                  ExceptionQueue.enqueue_exception("#{error_msg} not equal '#{value}' but found '#{actual}'") if actual == value
+                when :like, :is_like
+                  actual_like = actual.delete("\n")
+                  actual_like = actual_like.delete("\r")
+                  actual_like = actual_like.delete("\t")
+                  actual_like = actual_like.delete(' ')
+                  actual_like = actual_like.downcase
+                  expected    = value.delete("\n")
+                  expected    = expected.delete("\r")
+                  expected    = expected.delete("\t")
+                  expected    = expected.delete(' ')
+                  expected    = expected.downcase
+                  ExceptionQueue.enqueue_exception("#{error_msg} be like '#{value}' but found '#{actual}'") unless actual_like.include?(expected)
+                when :translate
+                  expected = I18n.t(value)
+                  ExceptionQueue.enqueue_assert_equal(expected, actual, "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) translated #{property} property")
               end
             end
           else
@@ -783,6 +832,9 @@ module TestCentricity
           end
         end
       end
+    rescue ObjectNotFoundError => e
+      ExceptionQueue.enqueue_exception(e.message)
+    ensure
       ExceptionQueue.post_exceptions
     end
 
@@ -822,18 +874,18 @@ module TestCentricity
             data_field.clear
           else
             case data_field.get_object_type
-            when :checkbox
-              data_field.set_checkbox_state(data_param.to_bool)
-            when :selectlist
-              data_field.get_siebel_object_type == 'JComboBox' ?
-                  data_field.set("#{data_param}\t") :
-                  data_field.choose_option(data_param)
-            when :radio
-              data_field.set_selected_state(data_param.to_bool)
-            when :textfield
-              data_field.set("#{data_param}\t")
-            when :section
-              data_field.set(data_param)
+              when :checkbox
+                data_field.set_checkbox_state(data_param.to_bool)
+              when :selectlist
+                data_field.get_siebel_object_type == 'JComboBox' ?
+                    data_field.set("#{data_param}\t") :
+                    data_field.choose_option(data_param)
+              when :radio
+                data_field.set_selected_state(data_param.to_bool)
+              when :textfield
+                data_field.set("#{data_param}\t")
+              when :section
+                data_field.set(data_param)
             end
           end
         end
@@ -842,13 +894,13 @@ module TestCentricity
 
     def get_attribute(attrib)
       section, = find_section
-      raise "Section object '#{get_name}' (#{get_locator}) not found" unless section
+      section_not_found_exception(section)
       section[attrib]
     end
 
     def get_native_attribute(attrib)
       section, = find_section
-      raise "Section object '#{get_name}' (#{get_locator}) not found" unless section
+      section_not_found_exception(section)
       section.native.attribute(attrib)
     end
 
@@ -862,5 +914,10 @@ module TestCentricity
     rescue
       [nil, nil]
     end
+
+    def section_not_found_exception(section)
+      raise ObjectNotFoundError.new("Section object '#{get_name}' (#{get_locator}) not found") unless section
+    end
+
   end
 end

data/lib/testcentricity/web_elements/ui_elements_helper.rb

@@ -68,10 +68,14 @@ module TestCentricity
     def get_object_type
       if @type
         @type
-      elsif obj.tag_name
-        obj.tag_name
-      elsif obj.native.attribute('type')
-        obj.native.attribute('type')
+      else
+        obj, type = find_element
+        object_not_found_exception(obj, type)
+        if obj.tag_name
+          obj.tag_name
+        elsif obj.native.attribute('type')
+          obj.native.attribute('type')
+        end
       end
     end
 
@@ -150,7 +154,7 @@ module TestCentricity
     # Send keystrokes to this object.
     #
     # @param keys [String] keys
-     # @example
+    # @example
     #   comment_field.send_keys(:enter)
     #
     def send_keys(*keys)
@@ -389,10 +393,10 @@ module TestCentricity
       obj, type = find_element(visible)
       object_not_found_exception(obj, type)
       case obj.tag_name.downcase
-      when 'input', 'select', 'textarea'
-        obj.value
-      else
-        obj.text
+        when 'input', 'select', 'textarea'
+          obj.value
+        else
+          obj.text
       end
     end
 
@@ -476,7 +480,7 @@ module TestCentricity
     def object_not_found_exception(obj, obj_type)
       @alt_locator.nil? ? locator = @locator : locator = @alt_locator
       obj_type.nil? ? object_type = 'Object' : object_type = obj_type
-      raise "#{object_type} named '#{@name}' (#{locator}) not found" unless obj
+      raise ObjectNotFoundError.new("#{object_type} named '#{@name}' (#{locator}) not found") unless obj
     end
 
     def invalid_object_type_exception(obj, obj_type)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity
 version: !ruby/object:Gem::Version
-  version: 2.3.14
+  version: 2.3.16
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-02-28 00:00:00.000000000 Z
+date: 2018-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -259,6 +259,7 @@ files:
 - lib/testcentricity/app_elements/image.rb
 - lib/testcentricity/app_elements/label.rb
 - lib/testcentricity/app_elements/list.rb
+- lib/testcentricity/app_elements/select_list.rb
 - lib/testcentricity/app_elements/switch.rb
 - lib/testcentricity/app_elements/textfield.rb
 - lib/testcentricity/browser_helper.rb