testcentricity_web 4.6.9 → 4.6.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48391198c0afc8b42f948c2e3dd6dbf77b0b8ff486fa4e9746bbaf2ec34c0231
-  data.tar.gz: e377c0af90d0b0478ea4dcad9ef08b1df337facc87dabc0215cbbed6c2a51a31
+  metadata.gz: de6418809f79980fa606328879c38f0307e96d03d62abe5d1e1d2e7054a9a9fb
+  data.tar.gz: cb56e40775606d4d00557402656d98ff9e0b214d5bc58dad599bda6ed09c368a
 SHA512:
-  metadata.gz: 762285729fbfcfc5f56b56a060f5a32d0e23f9f865417733621be3241dc9da01ca6b562991aa0d871989702d6a1b54952f3f2a7c7d640e9f68c726e5dd1ad0f4
-  data.tar.gz: fc982517f54bf55c571f5b0062abd1237e6df518badda8711a9ac2812faebfaba58d59703d739c91b25a9bf9e4187399160dc15449fa637f6a5e4d263a9651e8
+  metadata.gz: c0c860cb2b14e91a790c9fedbaceeb722cc480b3379abf8a30a691c8d57b3e1e900ce410c7eea2b5e8202f1bdfb2f405a7f78e06a9747cb36632f722f0ba8775
+  data.tar.gz: 4ad95f8ceedaa1acbebb5eb1869067b25a7eca38a6cc9daae6a68733d98913a21d0dc2db76e6cf9077df596db53ee060d5808c374b4dc1ec8bb64d3aca65fa7a

data/CHANGELOG.md

@@ -2,6 +2,33 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.6.10] - 07-NOV-2025
+
+### Added
+
+* Added the following `Media` methods to support verification of media text tracks (subtitles, captions,
+  chapters, descriptions, or metadata):
+    * `active_track_cue_count`
+    * `track_cue_count`
+    * `active_cue_text`
+    * `cue_text`
+    * `active_cue_data`
+    * `all_cues_text`
+    * `all_cues_data`
+* Updated `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods to support verification of the following
+  `Media` properties:
+    * `:active_track_cue_count`
+    * `active_cue_text`
+    * `all_tracks_data`
+    * `active_cue_data`
+    * `all_cues_text`
+    * `all_cues_data`
+
+### Changed
+
+* `Media.current_time` and `Media.duration` now return `Float` rounded to nearest tenth.
+
+
 ## [4.6.9] - 31-OCT-2025
 
 ### Added

data/README.md

@@ -796,30 +796,36 @@ The `verify_ui_states` method supports the following property/state pairs:
 
 **Audio/Video Media Objects**
 
-    :autoplay              Boolean
-    :ended                 Boolean
-    :controls              Boolean
-    :loop                  Boolean
-    :muted                 Boolean
-    :default_muted         Boolean
-    :paused                Boolean
-    :seeking               Boolean
-    :src                   String
-    :current_time          Float
-    :default_playback_rate Float
-    :duration              Float
-    :playback_rate         Float
-    :ready_state           Integer
-    :volume                Float
-    :preload               String
-    :poster                String
-    :track_count           Integer
-    :active_track          Integer
-    :active_track_data     Hash
-    :all_tracks_data       Array of Hash
-    :track_data            Hash
-    :active_track_source   String
-    :track_source          String
+    :autoplay               Boolean
+    :ended                  Boolean
+    :controls               Boolean
+    :loop                   Boolean
+    :muted                  Boolean
+    :default_muted          Boolean
+    :paused                 Boolean
+    :seeking                Boolean
+    :src                    String
+    :current_time           Float
+    :default_playback_rate  Float
+    :duration               Float
+    :playback_rate          Float
+    :ready_state            Integer
+    :volume                 Float
+    :preload                String
+    :poster                 String
+    :track_count            Integer
+    :active_track           Integer
+    :active_track_data      Hash
+    :all_tracks_data        Array of Hash
+    :track_data             Hash
+    :active_track_source    String
+    :track_source           String
+    :active_track_cue_count Integer
+    :active_cue_text        String
+    :all_tracks_data        Array of Hash
+    :active_cue_data        Array of Hash
+    :all_cues_text          Array of Hash
+    :all_cues_data          Array of Hash
 
 #### ARIA Accessibility Property/State Pairs
 
@@ -1463,7 +1469,7 @@ If the optional `options` hash is not provided when calling the `TestCentricity:
 then **Environment Variables** must be used to specify the target local or remote web browser, and the various webdriver
 capability parameters required to establish a connection with a single target web browser.
 
-### Specifying Options and Capabilities in the `options` Hash
+### Specifying Options and Capabilities using the `options` Hash
 
 For those test scenarios requiring the instantiation of multiple WebDriver objects, or where cumbersome **Environment
 Variables** are less than ideal, call the `TestCentricity::WebDriverConnect.initialize_web_driver` method with an `options`
@@ -1523,7 +1529,7 @@ expects a driver name, specified as a `Symbol`.
 
 ### Setting Desktop Browser Window Size
 
-#### Using `:browser_size` in the `options` Hash
+#### Using `:browser_size` using the `options` Hash
 
 The size (width and height) of a desktop browser window can be specified in the `options` hash for browsers that are hosted
 locally, in a Selenium Grid, or by a cloud hosted browser service provider. You cannot set the size of a mobile device web
@@ -1597,7 +1603,7 @@ the following Environment Variables must be set as described in the table below:
 Refer to [**section 8.9 (Using Browser Specific Profiles in `cucumber.yml`)**](#using-browser-specific-profiles-in-cucumber-yml) below.
 
 
-#### Local Desktop Browser in the `options` Hash
+#### Local Desktop Browser using the `options` Hash
 
 When using the `options` hash, the following options and capabilities must be specified:
 - `driver:` must be set to `:webdriver`
@@ -1745,7 +1751,7 @@ then the following Environment Variables must be set as described in the table b
 Refer to [**section 8.9 (Using Browser Specific Profiles in `cucumber.yml`)**](#using-browser-specific-profiles-in-cucumber-yml) below.
 
 
-#### Local Emulated Mobile Browser in the `options` Hash
+#### Local Emulated Mobile Browser using the `options` Hash
 
 When using the `options` hash, the following options and capabilities must be specified:
 - `driver:` must be set to `:webdriver`
@@ -1853,7 +1859,7 @@ then the following Environment Variables must be set as described in the table b
 Refer to [**section 8.9 (Using Browser Specific Profiles in `cucumber.yml`)**](#using-browser-specific-profiles-in-cucumber-yml) below.
 
 
-#### Grid Browser in the `options` Hash
+#### Grid Browser using the `options` Hash
 
 When using the `options` hash, the following options and capabilities must be specified:
 - `driver:` must be set to `:grid`
@@ -1939,7 +1945,7 @@ from the Appium Server GUI app. A security violation error will occur without re
 Refer to [**section 8.9 (Using Browser Specific Profiles in `cucumber.yml`)**](#using-browser-specific-profiles-in-cucumber-yml) below.
 
 
-##### Local Mobile Safari Browser in the `options` Hash
+##### Local Mobile Safari Browser using the `options` Hash
 
 When using the `options` hash, the following options and capabilities must be specified:
 - `driver:` must be set to `:appium`
@@ -2025,7 +2031,7 @@ the following **Environment Variables** must be set as described in the table be
 Refer to [**section 8.9 (Using Browser Specific Profiles in `cucumber.yml`)**](#using-browser-specific-profiles-in-cucumber-yml) below.
 
 
-##### Local Mobile Android Browser in the `options` Hash
+##### Local Mobile Android Browser using the `options` Hash
 
 When using the `options` hash, the following options and capabilities must be specified:
 - `driver:` must be set to `:appium`
@@ -2187,7 +2193,7 @@ the following **Environment Variables** must be set as described in the table be
 | `NETWORK_LOGS`           | [Optional] Capture network logs (`true` or `false`)                                                                                                                        |
 
 
-##### BrowserStack Desktop Browser in the `options` Hash
+##### BrowserStack Desktop Browser using the `options` Hash
 
 When using the `options` hash, the following options and capabilities must be specified:
 - `driver:` must be set to `:browserstack`
@@ -2284,7 +2290,7 @@ the following **Environment Variables** must be set as described in the table be
 | `APPIUM_LOGS`            | [Optional] Generate Appium logs (`true` or `false`)                                                                                                                        |
 
 
-##### BrowserStack Mobile Browser in the `options` Hash
+##### BrowserStack Mobile Browser using the `options` Hash
 
 When using the `options` hash, the following options and capabilities must be specified:
 - `driver:` must be set to `:browserstack`
@@ -2374,7 +2380,7 @@ the following **Environment Variables** must be set as described in the table be
 | `RECORD_VIDEO`           | [Optional] Enable screen video recording during test execution (`true` or `false`)                                         |
 
 
-##### Sauce Labs Desktop Browser in the `options` Hash
+##### Sauce Labs Desktop Browser using the `options` Hash
 
 When using the `options` hash, the following options and capabilities must be specified:
 - `driver:` must be set to `:saucelabs`
@@ -2460,7 +2466,7 @@ the following **Environment Variables** must be set as described in the table be
 | `ORIENTATION`            | [Optional] Set to `PORTRAIT` or `LANDSCAPE`                                                                     |
 
 
-##### Sauce Labs Mobile Browser in the `options` Hash
+##### Sauce Labs Mobile Browser using the `options` Hash
 
 When using the `options` hash, the following options and capabilities must be specified:
 - `driver:` must be set to `:saucelabs`
@@ -2551,7 +2557,7 @@ the following **Environment Variables** must be set as described in the table be
 | `BROWSER_SIZE`           | [Optional] Specify width, height of browser window                                                                 |
 
 
-##### TestingBot Desktop Browser in the `options` Hash
+##### TestingBot Desktop Browser using the `options` Hash
 
 When using the `options` hash, the following options and capabilities must be specified:
 - `driver:` must be set to `:testingbot`
@@ -2631,7 +2637,7 @@ the following **Environment Variables** must be set as described in the table be
 | `ORIENTATION`            | [Optional] Set to `portrait` or `landscape`                                                     |
 
 
-##### TestingBot Mobile Browser in the `options` Hash
+##### TestingBot Mobile Browser using the `options` Hash
 
 When using the `options` hash, the following options and capabilities must be specified:
 - `driver:` must be set to `:testingbot`
@@ -2714,7 +2720,7 @@ the following **Environment Variables** must be set as described in the table be
 | `CONSOLE_LOGS`           | [Optional] Used to capture browser console logs.                                         |
 
 
-##### LambdaTest Desktop Browser in the `options` Hash
+##### LambdaTest Desktop Browser using the `options` Hash
 
 When using the `options` hash, the following options and capabilities must be specified:
 - `driver:` must be set to `:lambdatest`

data/lib/testcentricity_web/data_objects/environment.rb

@@ -65,7 +65,6 @@ module TestCentricity
     @session_id = Time.now.strftime('%d%H%M%S%L')
     @session_time_stamp = Time.now.strftime('%Y%m%d%H%M%S')
     @test_environment = ENV['TEST_ENVIRONMENT']
-    @a11y_standard = ENV['ACCESSIBILITY_STANDARD'] || 'best-practice'
     @locale = ENV['LOCALE'] || 'en'
     @language = ENV['LANGUAGE'] || 'English'
     @screen_shots = []
@@ -147,6 +146,7 @@ module TestCentricity
       @deep_link_prefix = data['DEEP_LINK_PREFIX']
       @ios_bundle_id    = data['IOS_BUNDLE_ID']
       @android_app_id   = data['ANDROID_APP_ID']
+      @a11y_standard = ENV['ACCESSIBILITY_STANDARD'] || 'best-practice'
 
       url = @hostname.blank? ? "#{@base_url}#{@append}" : "#{@hostname}/#{@base_url}#{@append}"
       @app_host = if @user_id.blank? || @password.blank?

data/lib/testcentricity_web/version.rb

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

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -149,8 +149,18 @@ module TestCentricity
                      ui_object.active_track_data
                    when :active_track_source
                      ui_object.active_track_source
+                   when :active_track_cue_count
+                     ui_object.active_track_cue_count
+                   when :active_cue_text
+                     ui_object.active_cue_text
                    when :all_tracks_data
                      ui_object.all_tracks_data
+                   when :active_cue_data
+                     ui_object.active_cue_data
+                   when :all_cues_text
+                     ui_object.all_cues_text
+                   when :all_cues_data
+                     ui_object.all_cues_data
                    when :preload
                      ui_object.preload
                    when :poster

data/lib/testcentricity_web/web_core/webdriver_helper.rb

@@ -198,12 +198,6 @@ module TestCentricity
       Environ.session_state = :running
     end
 
-    # :nocov:
-
-    def self.set_domain(url)
-      Capybara.app_host = url
-    end
-
     def self.close_tunnel
       unless @bs_local.nil?
         @bs_local.stop
@@ -214,6 +208,11 @@ module TestCentricity
         end
       end
     end
+
+    # :nocov:
+    def self.set_domain(url)
+      Capybara.app_host = url
+    end
     # :nocov:
 
     private
@@ -432,7 +431,6 @@ module TestCentricity
       end
       # specify endpoint url
       @endpoint = "https://#{ENV['BS_USERNAME']}:#{ENV['BS_AUTHKEY']}@hub-cloud.browserstack.com/wd/hub" if @endpoint.nil?
-      # :nocov:
       # enable tunneling if specified
       if ENV['TUNNELING']
         @bs_local = BrowserStack::Local.new
@@ -444,7 +442,6 @@ module TestCentricity
           puts 'BrowserStack Local instance failed to start'
         end
       end
-      # :nocov:
       # define BrowserStack options
       options = if @capabilities.nil?
                   Environ.os = "#{ENV['BS_OS']} #{ENV['BS_OS_VERSION']}"

data/lib/testcentricity_web/web_elements/media.rb

@@ -126,7 +126,7 @@ module TestCentricity
       def current_time
         obj, = find_element(visible = :all)
         object_not_found_exception(obj, @type)
-        obj.native.attribute('currentTime').to_f.round(2)
+        obj.native.attribute('currentTime').to_f.round(1)
       end
 
       # Return media defaultPlaybackRate property
@@ -150,7 +150,7 @@ module TestCentricity
       def duration
         obj, = find_element(visible = :all)
         object_not_found_exception(obj, @type)
-        obj.native.attribute('duration').to_f.round(2)
+        obj.native.attribute('duration').to_f.round(1)
       end
 
       # Return media playbackRate property
@@ -195,7 +195,7 @@ module TestCentricity
         wait = Selenium::WebDriver::Wait.new(timeout: timeout)
         wait.until do
           reset_mru_cache
-          ready_state == value
+          compare(value, ready_state)
         end
       rescue StandardError
         if post_exception
@@ -325,6 +325,124 @@ module TestCentricity
         track_obj[:src]
       end
 
+      # Return number of text cues of active text track of associated media
+      #
+      # @return [Integer] number of text cues
+      # @example
+      #   num_cues = media_player.active_track_cue_count
+      #
+      def active_track_cue_count
+        active = active_track
+        return nil if active.zero?
+
+        track_cue_count(active)
+      end
+
+      # Return number of text cues of specified text track of associated media
+      #
+      # @param track [Integer] index of requested track
+      # @return [Integer] number of text cues
+      # @example
+      #   num_cues = media_player.track_cue_count(2)
+      #
+      def track_cue_count(track)
+        obj, = find_element(visible = :all)
+        object_not_found_exception(obj, @type)
+        page.execute_script("return arguments[0].textTracks[#{track - 1}].cues.length", obj)
+       end
+
+      # Return cue text of active text track of associated media
+      #
+      # @return [String] cue text of active track
+      # @example
+      #   caption = media_player.active_cue_text
+      #
+      def active_cue_text
+        active = active_track
+        return nil if active.zero?
+
+        cue_text(active)
+      end
+
+      # Return text cue of specified text track of associated media
+      #
+      # @param track [Integer] index of requested track
+      # @return [String] cue text of requested track
+      # @example
+      #   caption = media_player.cue_text(2)
+      #
+      def cue_text(track)
+        obj, = find_element(visible = :all)
+        object_not_found_exception(obj, @type)
+        page.execute_script("return arguments[0].textTracks[#{track - 1}].activeCues[0].text", obj)
+      end
+
+      # Return properties of active text cue of associated media
+      #
+      # @return [Array of Hash] properties of active text cue (:text, :start, :end)
+      # @example
+      #   cue_data = media_player.active_cue_data
+      #
+      def active_cue_data
+        active = active_track
+        return nil if active.zero?
+
+        obj, = find_element(visible = :all)
+        object_not_found_exception(obj, @type)
+        {
+          text: page.execute_script('return arguments[0].textTracks[0].activeCues[0].text', obj),
+          start: page.execute_script('return arguments[0].textTracks[0].activeCues[0].startTime', obj),
+          end: page.execute_script('return arguments[0].textTracks[0].activeCues[0].endTime', obj)
+        }
+      end
+
+      # Return all text cues of active track of associated media
+      #
+      # @return [Array of Hash] all text cues
+      # @example
+      #   all_captions = media_player.all_cues_text
+      #
+      def all_cues_text
+        active = active_track
+        return nil if active.zero?
+
+        obj, = find_element(visible = :all)
+        object_not_found_exception(obj, @type)
+        num_cues = page.execute_script('return arguments[0].textTracks[0].cues.length', obj)
+        all_text = []
+        (1..num_cues).each do |cue|
+          all_text.push( { cue - 1 => page.execute_script("return arguments[0].textTracks[0].cues[#{cue - 1}].text", obj) })
+        end
+        all_text
+      end
+
+      # Return properties of all cues of active track of associated media
+      #
+      # @return [Array of Hash] properties of all active track cues (:text, :start, :end)
+      # @example
+      #   cue_data = media_player.all_cues_data
+      #
+      def all_cues_data
+        active = active_track
+        return nil if active.zero?
+
+        obj, = find_element(visible = :all)
+        object_not_found_exception(obj, @type)
+        num_cues = page.execute_script('return arguments[0].textTracks[0].cues.length', obj)
+        all_data = []
+        (1..num_cues).each do |cue|
+          all_data.push(
+            { cue - 1 => {
+              text: page.execute_script("return arguments[0].textTracks[0].cues[#{cue - 1}].text", obj),
+              start: page.execute_script("return arguments[0].textTracks[0].cues[#{cue - 1}].startTime", obj),
+              end: page.execute_script("return arguments[0].textTracks[0].cues[#{cue - 1}].endTime", obj)
+            }
+            }
+          )
+        end
+        all_data
+      end
+
       # Set the media currentTime property
       #
       # @param value [Float] time in seconds

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 4.6.9
+  version: 4.6.10
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-31 00:00:00.000000000 Z
+date: 2025-11-07 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: axe-core-cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement