testcentricity_web 4.6.7 → 4.6.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 182dd10878593e23060b0db2787e26b0819f7d87750e6dfe9607d2c63c903713
-  data.tar.gz: 78c8c0b47ae8a5f7b75bf1121c945f738ed3e5ab1d3996fe520f86a93b3c631c
+  metadata.gz: 48391198c0afc8b42f948c2e3dd6dbf77b0b8ff486fa4e9746bbaf2ec34c0231
+  data.tar.gz: e377c0af90d0b0478ea4dcad9ef08b1df337facc87dabc0215cbbed6c2a51a31
 SHA512:
-  metadata.gz: 237057b41a1f58832c386b7707ea4f5e95c1b72c72b343f52327cdf7d69008c015df149501ff79ac0572965b3f159d0d77b0690a22e10e31c5ee08ce8c7800a1
-  data.tar.gz: 447075ba7e918097d53316ff73bc9939f25688057ac0f6cab0c001b47282f512178b7354eaeb2a8e2e2f0a1eed29f5b8c38c2eed960d2c1f64f9410b9cbabfbe
+  metadata.gz: 762285729fbfcfc5f56b56a060f5a32d0e23f9f865417733621be3241dc9da01ca6b562991aa0d871989702d6a1b54952f3f2a7c7d640e9f68c726e5dd1ad0f4
+  data.tar.gz: fc982517f54bf55c571f5b0062abd1237e6df518badda8711a9ac2812faebfaba58d59703d739c91b25a9bf9e4187399160dc15449fa637f6a5e4d263a9651e8

data/CHANGELOG.md

@@ -2,6 +2,41 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.6.9] - 31-OCT-2025
+
+### Added
+
+* Added `Table.get_footer_columns` and `Table.get_footer_column`methods.
+* Updated `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods to support verification of the following
+  `Table` properties:
+    * `:column_footers`
+    * `:column_footer`
+    * `:column_header`
+
+### Changed
+
+* `UIElement.get_max` now works with HTML `<progress>` elements.
+
+
+## [4.6.8] - 27-OCT-2025
+
+### Changed
+
+* `UIElement.aria_valuemax`, `UIElement.aria_valuemin`, and `UIElement.aria_valuenow` now return `Integer` or `Float`
+  instead of `String` result.
+* `UIElement.aria_rowcount` and `UIElement.aria_colcount` now return `Integer` instead of `String` result.
+
+### Added
+* Updated `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods to support verification of the following
+  `Table` properties:
+    * `:cell_attribute`
+    * `:row_attribute`
+    * `:aria_rowindex`
+
+### Fixed
+* `Table.get_row_data` and `Table.get_row_attribute` methods now return data for row 1 instead of `nil`.
+
+
 ## [4.6.7] - 21-OCT-2025
 
 ### Added

data/README.md

@@ -24,7 +24,7 @@ The TestCentricity™ For Web gem supports connecting to, and running automated
   * [TestingBot](https://testingbot.com/features)
   * [LambdaTest](https://www.lambdatest.com/selenium-automation)
 * web portals utilizing JavaScript front end application frameworks like Ember, React, Angular, and GWT
-* web pages containing HTML5 Video and Audio objects
+* web pages containing HTML5 Video and Audio objects, including text caption tracks
 * locally hosted emulated iOS Mobile Safari, Android, Windows Phone, or Blackberry mobile browsers (running within a local instance of Chrome)
 
 
@@ -40,15 +40,15 @@ Cucumber can be found [here](https://github.com/TestCentricity/tc_multi_webdrive
 
 ### Which gem should I use?
 
-* The [TestCentricity For **Web** gem](https://rubygems.org/gems/testcentricity_web) supports testing of web interfaces via desktop and mobile web browsers
+* The [TestCentricity For **Web** gem](https://rubygems.org/gems/testcentricity_web) supports testing of web apps via desktop and mobile web browsers
 * The [TestCentricity For **Mobile** gem](https://rubygems.org/gems/testcentricity_mobile) supports testing of native iOS and Android mobile apps
 * The [TestCentricity For **Apps** gem](https://rubygems.org/gems/testcentricity_apps) supports testing of MacOS desktop apps and native iOS and Android mobile apps
 
-| Tested platforms                            | TestCentricity For Web | TestCentricity For Mobile | TestCentricity For Apps |
-|---------------------------------------------|:-:|:-:|:-:|
-| Desktop/mobile web browsers only            | Yes                    | No                        | No                      |
-| Native mobile iOS and/or Android apps only  | No                     | Yes                       | Yes                     |
-| MacOS desktop apps                          | No                     | No                        | Yes                     |
+| Tested platforms                           | TestCentricity For Web | TestCentricity For Mobile | TestCentricity For Apps |
+|--------------------------------------------|:----------------------:|:-------------------------:|:-----------------------:|
+| Desktop/mobile web apps only               |          Yes           |            No             |           No            |
+| Native mobile iOS and/or Android apps only |           No           |            Yes            |           Yes           |
+| MacOS desktop apps                         |           No           |            No             |           Yes           |
 
 
 ## Installation
@@ -781,12 +781,18 @@ The `verify_ui_states` method supports the following property/state pairs:
 
 **Tables**
 
-    :rowcount      Integer
-    :columncount   Integer
-    :columnheaders Array of String
-    :cell          Hash
-    :row           Hash
-    :column        Hash
+    :rowcount       Integer
+    :columncount    Integer
+    :columnheaders  Array of String
+    :columnfooters  Array of String
+    :cell           Hash
+    :row            Hash
+    :column         Hash
+    :column_header  Hash
+    :column_footer  Hash
+    :cell_attribute Integer, Float, or String
+    :row_attribute  Integer, Float, or String
+    :aria_rowindex  Integer
 
 **Audio/Video Media Objects**
 

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '4.6.7'
+  VERSION = '4.6.9'
 end

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -151,8 +151,6 @@ module TestCentricity
                      ui_object.active_track_source
                    when :all_tracks_data
                      ui_object.all_tracks_data
-                   when :crossorigin
-                     ui_object.crossorigin
                    when :preload
                      ui_object.preload
                    when :poster
@@ -167,6 +165,8 @@ module TestCentricity
                      ui_object.get_group_headings
                    when :column_headers
                      ui_object.get_header_columns
+                   when :column_footers
+                     ui_object.get_footer_columns
                    when :count, :count_visible
                      ui_object.count(visible = true)
                    when :all_items, :all_list_items
@@ -177,19 +177,43 @@ module TestCentricity
                      ui_object.style
                    when :href
                      ui_object.href
+                   when :content_editable
+                     ui_object.content_editable?
                    when :role
                      ui_object.role
                    when :aria_disabled
                      ui_object.aria_disabled?
-                   # :nocov:
-                   when :count_all
-                     ui_object.count(visible = :all)
                    when :aria_label
                      ui_object.aria_label
-                   when :tabindex
-                     ui_object.tabindex
                    when :aria_labelledby
                      ui_object.aria_labelledby
+                   when :aria_required
+                     ui_object.aria_required?
+                   when :aria_checked
+                     ui_object.aria_checked?
+                   when :aria_readonly
+                     ui_object.aria_readonly?
+                   when :aria_rowcount
+                     ui_object.aria_rowcount
+                   when :aria_colcount
+                     ui_object.aria_colcount
+                   when :aria_valuemax
+                     ui_object.aria_valuemax
+                   when :aria_valuemin
+                     ui_object.aria_valuemin
+                   when :aria_valuenow
+                     ui_object.aria_valuenow
+                   when :aria_orientation
+                     ui_object.aria_orientation
+                   when :aria_multiline
+                     ui_object.aria_multiline?
+                   when :aria_multiselectable
+                     ui_object.aria_multiselectable?
+                     # :nocov:
+                   when :count_all
+                     ui_object.count(visible = :all)
+                   when :tabindex
+                     ui_object.tabindex
                    when :aria_describedby
                      ui_object.aria_describedby
                    when :aria_live
@@ -202,34 +226,16 @@ module TestCentricity
                      ui_object.aria_hidden?
                    when :aria_expanded
                      ui_object.aria_expanded?
-                   when :aria_required
-                     ui_object.aria_required?
-                   when :aria_invalid
+                    when :aria_invalid
                      ui_object.aria_invalid?
-                   when :aria_checked
-                     ui_object.aria_checked?
-                   when :aria_readonly
-                     ui_object.aria_readonly?
                    when :aria_pressed
                      ui_object.aria_pressed?
                    when :aria_haspopup
                      ui_object.aria_haspopup?
                    when :aria_sort
                      ui_object.aria_sort
-                   when :aria_rowcount
-                     ui_object.aria_rowcount
-                   when :aria_colcount
-                     ui_object.aria_colcount
-                   when :aria_valuemax
-                     ui_object.aria_valuemax
-                   when :aria_valuemin
-                     ui_object.aria_valuemin
-                   when :aria_valuenow
-                     ui_object.aria_valuenow
                    when :aria_valuetext
                      ui_object.aria_valuetext
-                   when :aria_orientation
-                     ui_object.aria_orientation
                    when :aria_keyshortcuts
                      ui_object.aria_keyshortcuts
                    when :aria_roledescription
@@ -240,12 +246,8 @@ module TestCentricity
                      ui_object.aria_controls
                    when :aria_modal
                      ui_object.aria_modal?
-                   when :aria_multiline
-                     ui_object.aria_multiline?
-                   when :aria_multiselectable
-                     ui_object.aria_multiselectable?
-                   when :content_editable
-                     ui_object.content_editable?
+                   when :crossorigin
+                     ui_object.crossorigin
                    # :nocov:
                    when :validation_message
                      ui_object.validation_message
@@ -281,12 +283,22 @@ module TestCentricity
                            ui_object.get_table_row(value.to_i)
                          when :column
                            ui_object.get_table_column(value.to_i)
+                         when :column_header
+                           ui_object.get_header_column(value.to_i)
+                         when :column_footer
+                           ui_object.get_footer_column(value.to_i)
                          when :item
                            ui_object.get_list_item(value.to_i)
                          when :attribute
                            ui_object.get_attribute(value)
                          when :native_attribute
                            ui_object.get_native_attribute(value)
+                         when :cell_attribute
+                           ui_object.get_cell_attribute(value[0].to_i, value[1].to_i, value[2])
+                         when :row_attribute
+                           ui_object.get_row_attribute(value[0].to_i, value[1])
+                         when :aria_rowindex
+                           ui_object.get_row_attribute(value.to_i, 'aria-rowindex')
                          else
                            raise "#{key} is not a valid property key"
                          end

data/lib/testcentricity_web/web_elements/table.rb

@@ -8,6 +8,9 @@ module TestCentricity
       attr_accessor :table_header
       attr_accessor :header_row
       attr_accessor :header_column
+      attr_accessor :table_footer
+      attr_accessor :footer_row
+      attr_accessor :footer_column
       attr_accessor :row_header
       attr_accessor :tree_expand
       attr_accessor :tree_collapse
@@ -24,6 +27,9 @@ module TestCentricity
           table_header:  'thead',
           header_row:    'tr',
           header_column: 'th',
+          table_footer:  'tfoot',
+          footer_row:    'tr',
+          footer_column: 'th',
           row_header:    nil
         }
 
@@ -55,6 +61,12 @@ module TestCentricity
             @header_row = value
           when :header_column
             @header_column = value
+          when :table_footer
+            @table_footer = value
+          when :footer_row
+            @footer_row = value
+          when :footer_column
+            @footer_column = value
           when :row_header
             @row_header = value
           when :tree_expand
@@ -317,13 +329,9 @@ module TestCentricity
         raise "Row #{row} exceeds number of rows (#{row_count}) in table #{object_ref_message}" if row > row_count
         case @locator_type
         when :xpath
-          row > 1 ?
-            set_alt_locator("#{@locator}/#{@table_body}/#{@table_row}[#{row}]") :
-            set_alt_locator("#{@locator}/#{@table_body}/#{@table_row}")
+          set_alt_locator("#{@locator}/#{@table_body}/#{@table_row}[#{row}]")
         when :css
-          row > 1 ?
-            set_alt_locator("#{@locator} > #{@table_body} > #{@table_row}:nth-of-type(#{row})") :
-            set_alt_locator("#{@locator} > #{@table_body} > #{@table_row}")
+          set_alt_locator("#{@locator} > #{@table_body} > #{@table_row}:nth-of-type(#{row})")
         end
         value = get_value if exists?
         clear_alt_locator
@@ -431,7 +439,15 @@ module TestCentricity
         set_table_cell_locator(row, column)
         result = get_native_attribute(attrib)
         clear_alt_locator
-        result
+        unless result.blank?
+          if result.is_int?
+            result.to_i
+          elsif result.is_float?
+            result.to_f
+          else
+            result
+          end
+        end
       end
 
       def get_row_attribute(row, attrib)
@@ -439,17 +455,21 @@ module TestCentricity
         raise "Row #{row} exceeds number of rows (#{row_count}) in table #{object_ref_message}" if row > row_count
         case @locator_type
         when :xpath
-          row > 1 ?
-            set_alt_locator("#{@locator}/#{@table_body}/#{@table_row}[#{row}]") :
-            set_alt_locator("#{@locator}/#{@table_body}/#{@table_row}")
+          set_alt_locator("#{@locator}/#{@table_body}/#{@table_row}[#{row}]")
         when :css
-          row > 1 ?
-            set_alt_locator("#{@locator} > #{@table_body} > #{@table_row}:nth-of-type(#{row})") :
-            set_alt_locator("#{@locator} > #{@table_body} > #{@table_row}")
+          set_alt_locator("#{@locator} > #{@table_body} > #{@table_row}:nth-of-type(#{row})")
         end
         result = get_native_attribute(attrib)
         clear_alt_locator
-        result
+        unless result.blank?
+          if result.is_int?
+            result.to_i
+          elsif result.is_float?
+            result.to_f
+          else
+            result
+          end
+        end
       end
 
       def find_row_attribute(attrib, search_value)
@@ -568,6 +588,36 @@ module TestCentricity
         columns
       end
 
+      def get_footer_column(column)
+        column_count = get_column_count
+        raise "Column #{column} exceeds number of columns (#{column_count}) in table footer #{object_ref_message}" if column > column_count
+        case @locator_type
+        when :xpath
+          set_alt_locator("#{@locator}//#{@table_footer}/#{@footer_row}/#{@footer_column}[#{column}]")
+        when :css
+          set_alt_locator("#{@locator} #{@table_footer} > #{@footer_row} > #{@footer_column}:nth-of-type(#{column})")
+        end
+        value = get_value(:all) if exists?(:all)
+        clear_alt_locator
+        value
+      end
+
+      def get_footer_columns
+        columns = []
+        column_count = get_column_count
+        (1..column_count).each do |column|
+          case @locator_type
+          when :xpath
+            set_alt_locator("#{@locator}//#{@table_footer}/#{@footer_row}/#{@footer_column}[#{column}]")
+          when :css
+            set_alt_locator("#{@locator} #{@table_footer} > #{@footer_row} > #{@footer_column}:nth-of-type(#{column})")
+          end
+          columns.push(get_value(:all)) if exists?(:all)
+        end
+        clear_alt_locator
+        columns
+      end
+
       def is_table_row_expanded?(row, column)
         row_count = get_row_count
         raise "Row #{row} exceeds number of rows (#{row_count}) in table #{object_ref_message}" if row > row_count

data/lib/testcentricity_web/web_elements/textfield.rb

@@ -92,27 +92,6 @@ module TestCentricity
         end
       end
 
-      # Return max attribute of a number type text field.
-      #
-      # @return [Integer]
-      # @example
-      #   max_points_value = points_field.get_max
-      #
-      def get_max
-        obj, = find_element
-        object_not_found_exception(obj, nil)
-        max = obj.native.attribute('max')
-        unless max.blank?
-          if max.is_int?
-            max.to_i
-          elsif max.is_float?
-            max.to_f
-          else
-            max
-          end
-        end
-      end
-
       # Return step attribute of a number type text field.
       #
       # @return [Integer]

data/lib/testcentricity_web/web_elements/ui_element.rb

@@ -577,13 +577,15 @@ module TestCentricity
       def get_value(visible = true)
         obj, type = find_element(visible)
         object_not_found_exception(obj, type)
-        text = case obj.tag_name.downcase
-               when 'input', 'select', 'textarea'
-                 obj.value
-               else
-                 obj.text
-               end
-        text.gsub(/[[:space:]]+/, ' ').strip unless text.nil?
+        value = case obj.tag_name.downcase
+                when 'input', 'select', 'textarea'
+                  obj.value
+                when 'progress'
+                  obj.value.to_i
+                else
+                  obj.text
+                end
+        value.is_a?(String) ? value.gsub(/[[:space:]]+/, ' ').strip : value
       end
 
       alias get_caption get_value
@@ -700,6 +702,27 @@ module TestCentricity
         )
       end
 
+      # Return max attribute of a number type text field or a progress bar.
+      #
+      # @return [Integer]
+      # @example
+      #   max_points_value = points_field.get_max
+      #
+      def get_max
+        obj, = find_element
+        object_not_found_exception(obj, nil)
+        max = obj.native.attribute('max')
+        unless max.blank?
+          if max.is_int?
+            max.to_i
+          elsif max.is_float?
+            max.to_f
+          else
+            max
+          end
+        end
+      end
+
       # Return UI object's style property
       #
       # @return [String]
@@ -787,7 +810,14 @@ module TestCentricity
       #   user_grid.aria_rowcount
       #
       def aria_rowcount
-        get_attribute('aria-rowcount')
+        rows = get_attribute('aria-rowcount')
+        unless rows.blank?
+          if rows.is_int?
+            rows.to_i
+          else
+            rows
+          end
+        end
       end
 
       # Return state of UI object's aria-colcount property
@@ -797,7 +827,14 @@ module TestCentricity
       #   user_grid.aria_colcount
       #
       def aria_colcount
-        get_attribute('aria-colcount')
+        cols = get_attribute('aria-colcount')
+        unless cols.blank?
+          if cols.is_int?
+            cols.to_i
+          else
+            cols
+          end
+        end
       end
 
       # Return state of UI object's aria-valuemax property
@@ -807,7 +844,16 @@ module TestCentricity
       #   volume_slider.aria_valuemax
       #
       def aria_valuemax
-        get_attribute('aria-valuemax')
+        max = get_attribute('aria-valuemax')
+        unless max.blank?
+          if max.is_int?
+            max.to_i
+          elsif max.is_float?
+            max.to_f
+          else
+            max
+          end
+        end
       end
 
       # Return state of UI object's aria-valuemin property
@@ -817,7 +863,16 @@ module TestCentricity
       #   volume_slider.aria_valuemin
       #
       def aria_valuemin
-        get_attribute('aria-valuemin')
+        min = get_attribute('aria-valuemin')
+        unless min.blank?
+          if min.is_int?
+            min.to_i
+          elsif min.is_float?
+            min.to_f
+          else
+            min
+          end
+        end
       end
 
       # Return state of UI object's aria-valuenow property
@@ -827,12 +882,21 @@ module TestCentricity
       #   volume_slider.aria_valuenow
       #
       def aria_valuenow
-        get_attribute('aria-valuenow')
+        result = get_attribute('aria-valuenow')
+        unless result.blank?
+          if result.is_int?
+            result.to_i
+          elsif result.is_float?
+            result.to_f
+          else
+            result
+          end
+        end
       end
 
       # Return state of UI object's aria-valuetext property
       #
-      # @return [Integer]
+      # @return [String]
       # @example
       #   volume_slider.aria_valuetext
       #
@@ -842,7 +906,7 @@ module TestCentricity
 
       # Return state of UI object's aria-orientation property
       #
-      # @return [Integer]
+      # @return [String]
       # @example
       #   volume_slider.aria_orientation
       #
@@ -852,7 +916,7 @@ module TestCentricity
 
       # Return state of UI object's aria-keyshortcuts property
       #
-      # @return [Integer]
+      # @return [String]
       # @example
       #   play_button.aria_keyshortcuts
       #
@@ -862,7 +926,7 @@ module TestCentricity
 
       # Return state of UI object's aria-roledescription property
       #
-      # @return [Integer]
+      # @return [String]
       # @example
       #   editor_button.aria_roledescription
       #
@@ -872,7 +936,7 @@ module TestCentricity
 
       # Return state of UI object's aria-autocomplete property
       #
-      # @return [Integer]
+      # @return [Boolean]
       # @example
       #   email_field.aria_autocomplete
       #
@@ -882,7 +946,7 @@ module TestCentricity
 
       # Return state of UI object's aria-controls property
       #
-      # @return [Integer]
+      # @return [String]
       # @example
       #   video_menu.aria_controls
       #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 4.6.7
+  version: 4.6.9
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-20 00:00:00.000000000 Z
+date: 2025-10-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -142,14 +142,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.37.0
+        version: 4.38.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.37.0
+        version: 4.38.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement