testcentricity_web 4.1.6 → 4.1.9

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -65,6 +65,8 @@ module TestCentricity
                      ui_object.hidden?
                    when :displayed
                      ui_object.displayed?
+                   when :obscured
+                     ui_object.obscured?
                    when :focused
                      ui_object.focused?
                    when :width
@@ -296,7 +298,7 @@ module TestCentricity
     def populate_data_fields(data, wait_time = nil, integrity_check = false)
       timeout = wait_time.nil? ? 5 : wait_time
       data.each do |data_field, data_param|
-        unless data_param.blank?
+        unless data_param != false && data_param.blank?
           # make sure the intended UI target element is visible before trying to set its value
           data_field.wait_until_visible(timeout)
           if data_param == '!DELETE'
@@ -312,7 +314,7 @@ module TestCentricity
               check_state = data_param.is_a?(String) ? data_param.to_bool : data_param
               data_field.set_selected_state(check_state)
             when :textfield
-              if data_field.get_attribute(:type) == 'color'
+              if %w[color number].include?(data_field.get_attribute(:type))
                 data_field.set(data_param)
               else
                 data_field.set("#{data_param}\t")

data/lib/testcentricity_web/web_core/page_section.rb

@@ -234,7 +234,7 @@ module TestCentricity
     #   radio :accept_terms_radio,  "//input[@id='Accept_Terms']"
     #   radio :decline_terms_radio, 'input#decline_terms_conditions'
     #
-    def self.radio(element_name, locator, proxy = nil)
+    def self.radio(element_name, locator)
       define_element(element_name, TestCentricity::Radio, locator)
     end
 

data/lib/testcentricity_web/web_core/webdriver_helper.rb

@@ -29,10 +29,12 @@ module TestCentricity
       # set downloads folder path
       @downloads_path = "#{Dir.pwd}/downloads"
       if ENV['PARALLEL']
+        # :nocov:
         Environ.parallel = true
         Environ.process_num = ENV['TEST_ENV_NUMBER']
         @downloads_path = "#{@downloads_path}/#{ENV['TEST_ENV_NUMBER']}"
         Dir.mkdir(@downloads_path) unless Dir.exist?(@downloads_path)
+        # :nocov:
       else
         Environ.parallel = false
       end
@@ -50,6 +52,7 @@ module TestCentricity
                 when :appium
                   initialize_appium
                   'Appium'
+                # :nocov:
                 when :browserstack
                   initialize_browserstack
                   'Browserstack cloud service'
@@ -62,6 +65,7 @@ module TestCentricity
                 when :testingbot
                   initialize_testingbot
                   'TestingBot cloud service'
+                # :nocov:
                 else
                   if ENV['SELENIUM'] == 'remote'
                     initialize_remote
@@ -91,11 +95,13 @@ module TestCentricity
     def self.initialize_browser_size
       # tile browser windows if running in multiple parallel threads and BROWSER_TILE environment variable is true
       if ENV['PARALLEL'] && ENV['BROWSER_TILE']
+        # :nocov:
         thread = ENV['TEST_ENV_NUMBER'].to_i
         if thread > 1
           Browsers.set_browser_window_position(100 * thread - 1, 100 * thread - 1)
           sleep(1)
         end
+        # :nocov:
       else
         Browsers.set_browser_window_position(10, 10)
         sleep(1)
@@ -116,6 +122,7 @@ module TestCentricity
       Environ.session_state = :running
     end
 
+    # :nocov:
     def self.close_tunnel
       unless @bs_local.nil?
         @bs_local.stop
@@ -126,6 +133,7 @@ module TestCentricity
         end
       end
     end
+    # :nocov:
 
     private
 
@@ -147,10 +155,12 @@ module TestCentricity
       desired_capabilities[:avd] = ENV['APP_DEVICE'] if Environ.device_os == :android
       desired_capabilities[:automationName] = ENV['AUTOMATION_ENGINE'] if ENV['AUTOMATION_ENGINE']
       if ENV['UDID']
+        # :nocov:
         Environ.device = :device
         desired_capabilities[:udid] = ENV['UDID']
         desired_capabilities[:xcodeOrgId] = ENV['TEAM_ID'] if ENV['TEAM_ID']
         desired_capabilities[:xcodeSigningId] = ENV['TEAM_NAME'] if ENV['TEAM_NAME']
+        # :nocov:
       else
         Environ.device = :simulator
         desired_capabilities[:orientation] = Environ.device_orientation.upcase if Environ.device_orientation
@@ -179,11 +189,13 @@ module TestCentricity
       desired_capabilities[:chromedriverExecutable] = ENV['CHROMEDRIVER_EXECUTABLE'] if ENV['CHROMEDRIVER_EXECUTABLE']
       # set wdaLocalPort (iOS) or systemPort (Android) if PARALLEL_PORT is true
       if ENV['PARALLEL'] && ENV['PARALLEL_PORT']
+        # :nocov:
         if Environ.device_os == :ios
           desired_capabilities[:wdaLocalPort] = 8100 + ENV['TEST_ENV_NUMBER'].to_i
         else
           desired_capabilities[:systemPort] = 8200 + ENV['TEST_ENV_NUMBER'].to_i
         end
+        # :nocov:
       else
         desired_capabilities[:wdaLocalPort] = ENV['WDA_LOCAL_PORT'] if ENV['WDA_LOCAL_PORT']
         desired_capabilities[:systemPort]   = ENV['SYSTEM_PORT'] if ENV['SYSTEM_PORT']
@@ -255,6 +267,51 @@ module TestCentricity
       Capybara.default_driver = :selenium
     end
 
+    def self.initialize_remote
+      Environ.grid = :selenium_grid
+      browser  = ENV['WEB_BROWSER'].downcase.to_sym
+      @endpoint = ENV['REMOTE_ENDPOINT'] || 'http://127.0.0.1:4444/wd/hub' if @endpoint.nil?
+
+      case browser
+      when :safari
+        options = Selenium::WebDriver::Safari::Options.new
+      when :ie
+        options = Selenium::WebDriver::IE::Options.new
+      when :firefox, :firefox_headless
+        options = firefox_options(browser)
+      when :chrome, :chrome_headless, :edge, :edge_headless
+        options = chrome_edge_options(browser)
+      else
+        if ENV['HOST_BROWSER'] && ENV['HOST_BROWSER'].downcase.to_sym == :chrome
+          Environ.platform = :mobile
+          Environ.device_name = Browsers.mobile_device_name(ENV['WEB_BROWSER'])
+          user_agent = Browsers.mobile_device_agent(ENV['WEB_BROWSER'])
+          options = Selenium::WebDriver::Chrome::Options.new(options: {'excludeSwitches' => ['enable-automation']})
+          options.add_argument('--disable-dev-shm-usage')
+          options.add_argument("--user-agent='#{user_agent}'")
+          options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
+        else
+          raise "Requested browser '#{browser}' is not supported on Selenium Grid"
+        end
+      end
+
+      Capybara.register_driver :remote_browser do |app|
+        Capybara::Selenium::Driver.new(app,
+                                       browser: :remote,
+                                       url: @endpoint,
+                                       capabilities: [options]).tap do |driver|
+          # configure file_detector for remote uploads
+          driver.browser.file_detector = lambda do |args|
+            str = args.first.to_s
+            str if File.exist?(str)
+          end
+        end
+      end
+      Capybara.current_driver = :remote_browser
+      Capybara.default_driver = :remote_browser
+    end
+
+    # :nocov:
     def self.initialize_browserstack
       browser = ENV['BS_BROWSER']
       Environ.grid = :browserstack
@@ -401,50 +458,6 @@ module TestCentricity
       config_file_uploads
     end
 
-    def self.initialize_remote
-      Environ.grid = :selenium_grid
-      browser  = ENV['WEB_BROWSER'].downcase.to_sym
-      @endpoint = ENV['REMOTE_ENDPOINT'] || 'http://127.0.0.1:4444/wd/hub' if @endpoint.nil?
-
-      case browser
-      when :safari
-        options = Selenium::WebDriver::Safari::Options.new
-      when :ie
-        options = Selenium::WebDriver::IE::Options.new
-      when :firefox, :firefox_headless
-        options = firefox_options(browser)
-      when :chrome, :chrome_headless, :edge, :edge_headless
-        options = chrome_edge_options(browser)
-      else
-        if ENV['HOST_BROWSER'] && ENV['HOST_BROWSER'].downcase.to_sym == :chrome
-          Environ.platform = :mobile
-          Environ.device_name = Browsers.mobile_device_name(ENV['WEB_BROWSER'])
-          user_agent = Browsers.mobile_device_agent(ENV['WEB_BROWSER'])
-          options = Selenium::WebDriver::Chrome::Options.new(options: {'excludeSwitches' => ['enable-automation']})
-          options.add_argument('--disable-dev-shm-usage')
-          options.add_argument("--user-agent='#{user_agent}'")
-          options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
-        else
-          raise "Requested browser '#{browser}' is not supported on Selenium Grid"
-        end
-      end
-
-      Capybara.register_driver :remote_browser do |app|
-        Capybara::Selenium::Driver.new(app,
-                                       browser: :remote,
-                                       url: @endpoint,
-                                       capabilities: [options]).tap do |driver|
-          # configure file_detector for remote uploads
-          driver.browser.file_detector = lambda do |args|
-            str = args.first.to_s
-            str if File.exist?(str)
-          end
-        end
-      end
-      Capybara.current_driver = :remote_browser
-      Capybara.default_driver = :remote_browser
-    end
-
     def self.initialize_saucelabs
       browser = ENV['SL_BROWSER']
       Environ.grid = :saucelabs
@@ -554,6 +567,7 @@ module TestCentricity
       # configure file_detector for remote uploads if target is desktop web browser
       config_file_uploads unless ENV['TB_PLATFORM']
     end
+    # :nocov:
 
     def self.chrome_edge_options(browser)
       options = case browser
@@ -599,6 +613,7 @@ module TestCentricity
       options
     end
 
+    # :nocov:
     def self.test_context_message
       context_message = if ENV['TEST_CONTEXT']
                           "#{Environ.test_environment.to_s.upcase} - #{ENV['TEST_CONTEXT']}"
@@ -636,5 +651,6 @@ module TestCentricity
         str if File.exist?(str)
       end
     end
+    # :nocov:
   end
 end

data/lib/testcentricity_web/web_elements/checkbox.rb

@@ -2,11 +2,13 @@ module TestCentricity
   class CheckBox < UIElement
     attr_accessor :proxy
     attr_accessor :label
+    attr_accessor :input
 
     def initialize(name, parent, locator, context)
       super
       @type = :checkbox
       check_spec = {
+        input: nil,
         proxy: nil,
         label: nil
       }
@@ -16,6 +18,8 @@ module TestCentricity
     def define_custom_elements(element_spec)
       element_spec.each do |element, value|
         case element
+        when :input
+          @input = value
         when :proxy
           @proxy = value
         when :label
@@ -44,9 +48,14 @@ module TestCentricity
     #   remember_me_checkbox.checked?
     #
     def checked?
-      obj, = find_element(:all)
-      object_not_found_exception(obj, 'Checkbox')
-      obj.checked?
+      @base_object, = find_element(:all)
+      object_not_found_exception(@base_object, 'Checkbox')
+      chk = if @input.nil?
+              @base_object
+            else
+              find_component(@input, 'checkbox')
+            end
+      chk.checked?
     end
 
     # Is checkbox state indeterminate?
@@ -67,7 +76,14 @@ module TestCentricity
     #   remember_me_checkbox.visible?
     #
     def visible?
-      @proxy.nil? ? super : page.find(:css, @proxy).visible?
+      if @proxy.nil?
+        super
+      else
+        @base_object, = find_element(:all)
+        object_not_found_exception(@base_object, 'Checkbox')
+        proxy = find_component(@proxy, 'checkbox proxy')
+        proxy.visible?
+      end
     end
 
     # Is checkbox disabled (not enabled)?
@@ -77,10 +93,14 @@ module TestCentricity
     #   remember_me_checkbox.disabled?
     #
     def disabled?
-      visibility = @proxy.nil? ? true : :all
-      obj, type = find_element(visibility)
-      object_not_found_exception(obj, type)
-      obj.disabled?
+      if @input.nil?
+        super
+      else
+        @base_object, = find_element(:all)
+        object_not_found_exception(@base_object, 'Checkbox')
+        chk = find_component(@input, 'checkbox')
+        chk.disabled?
+      end
     end
 
     # Return checkbox caption
@@ -91,9 +111,15 @@ module TestCentricity
     #
     def get_value
       if @label.nil?
-        @proxy.nil? ? super : page.find(:css, @proxy).text
+        if @proxy.nil?
+          super
+        else
+          proxy = find_component(@proxy, 'checkbox proxy')
+          proxy.text
+        end
       else
-        page.find(:css, @label).text
+        label = find_component(@label, 'checkbox label')
+        label.text
       end
     end
 
@@ -108,18 +134,22 @@ module TestCentricity
     #   remember_me_checkbox.set_checkbox_state(true)
     #
     def set_checkbox_state(state)
-      obj, = find_element(:all)
-      object_not_found_exception(obj, 'Checkbox')
-      invalid_object_type_exception(obj, 'checkbox')
-      if @proxy.nil?
-        if obj.native.attribute('ot') == 'JCheckBox'
-          expected = state.to_bool
-          obj.click unless expected == obj.checked?
+      @base_object, = find_element(:all)
+      object_not_found_exception(@base_object, 'Checkbox')
+      proxy = find_component(@proxy, 'checkbox proxy') unless @proxy.nil?
+      chk = find_component(@input, 'checkbox') unless @input.nil?
+      if @input.nil?
+        if @proxy.nil?
+          @base_object.click unless state == @base_object.checked?
         else
-          obj.set(state)
+          proxy.click unless state == @base_object.checked?
         end
       else
-        page.find(:css, @proxy).click unless state == obj.checked?
+        if @proxy.nil?
+          @base_object.click unless state == chk.checked?
+        else
+          proxy.click unless state == chk.checked?
+        end
       end
     end
 

data/lib/testcentricity_web/web_elements/file_field.rb

@@ -5,17 +5,19 @@ module TestCentricity
       @type = :filefield
     end
 
+    def file_upload(file_path)
+      obj, = find_element(visible = false)
+      obj.send_keys(file_path)
+    end
+
+    # :nocov:
+
     def file_attach(file_path)
       Capybara.ignore_hidden_elements = false
       page.attach_file(@locator, file_path)
       Capybara.ignore_hidden_elements = true
     end
 
-    def file_upload(file_path)
-      obj, = find_element(visible = false)
-      obj.send_keys(file_path)
-    end
-
     def drop_files(files)
       js_script = 'fileList = Array();'
       files.count.times do |i|
@@ -41,5 +43,7 @@ module TestCentricity
       # trigger the fake drop event
       page.execute_script(js_script)
     end
+
+    # :nocov:
   end
 end

data/lib/testcentricity_web/web_elements/image.rb

@@ -14,7 +14,8 @@ module TestCentricity
     def loaded?
       obj, = find_element
       object_not_found_exception(obj, nil)
-      obj.native.attribute('complete')
+      state = obj.native.attribute('complete')
+      state.boolean? ? state : state == 'true'
     end
 
     alias is_loaded? loaded?

data/lib/testcentricity_web/web_elements/media.rb

@@ -125,7 +125,7 @@ module TestCentricity
     def current_time
       obj, = find_element(visible = :all)
       object_not_found_exception(obj, @type)
-      obj.native.attribute('currentTime').to_f
+      obj.native.attribute('currentTime').to_f.round(2)
     end
 
     # Return media defaultPlaybackRate property
@@ -137,7 +137,7 @@ module TestCentricity
     def default_playback_rate
       obj, = find_element(visible = :all)
       object_not_found_exception(obj, @type)
-      obj.native.attribute('defaultPlaybackRate')
+      obj.native.attribute('defaultPlaybackRate').to_f
     end
 
     # Return media duration property
@@ -149,7 +149,7 @@ module TestCentricity
     def duration
       obj, = find_element(visible = :all)
       object_not_found_exception(obj, @type)
-      obj.native.attribute('duration').to_f
+      obj.native.attribute('duration').to_f.round(2)
     end
 
     # Return media playbackRate property
@@ -161,7 +161,7 @@ module TestCentricity
     def playback_rate
       obj, = find_element(visible = :all)
       object_not_found_exception(obj, @type)
-      obj.native.attribute('playbackRate')
+      obj.native.attribute('playbackRate').to_f
     end
 
     # Return media readyState property
@@ -178,7 +178,7 @@ module TestCentricity
     def ready_state
       obj, = find_element(visible = :all)
       object_not_found_exception(obj, @type)
-      obj.native.attribute('readyState').to_i
+      page.execute_script('return arguments[0].readyState', obj)
     end
 
     # Wait until the media object's readyState value equals the specified value, or until the specified wait time has expired. If the wait
@@ -195,7 +195,7 @@ module TestCentricity
       wait.until { ready_state == value }
     rescue StandardError
       if post_exception
-        raise "Ready state of Audio #{object_ref_message} failed to equal '#{value}' after #{timeout} seconds" unless get_value == value
+        raise "Ready state of media #{object_ref_message} failed to equal '#{value}' after #{timeout} seconds" unless get_value == value
       else
         ready_state == value
       end
@@ -247,16 +247,50 @@ module TestCentricity
       page.execute_script('arguments[0].pause()', obj)
     end
 
-    # Return media crossorigin property
+    # Mute the media's audio
     #
-    # @return crossorigin value
     # @example
-    #   with_creds = media_player.crossorigin == 'use-credentials'
+    #   media_player.mute
     #
-    def crossorigin
-      obj, = find_element
+    def mute
+      obj, = find_element(visible = :all)
+      object_not_found_exception(obj, @type)
+      page.execute_script('arguments[0].muted = true;', obj)
+    end
+
+    # Unmute the media's audio
+    #
+    # @example
+    #   media_player.unmute
+    #
+    def unmute
+      obj, = find_element(visible = :all)
+      object_not_found_exception(obj, @type)
+      page.execute_script('arguments[0].muted = false;', obj)
+    end
+
+    # Set the media playbackRate property
+    #
+    # @param value [Float]
+    # @example
+    #   media_player.playback_rate = 1.5
+    #
+    def playback_rate=(value)
+      obj, = find_element(visible = :all)
+      object_not_found_exception(obj, @type)
+      page.execute_script('arguments[0].playbackRate = arguments[1]', obj, value)
+    end
+
+    # Set the media volume property
+    #
+    # @param value [Float] between 0 and 1
+    # @example
+    #   media_player.volume = 0.5
+    #
+    def volume=(value)
+      obj, = find_element(visible = :all)
       object_not_found_exception(obj, @type)
-      obj.native.attribute('crossorigin')
+      page.execute_script('arguments[0].volume = arguments[1]', obj, value)
     end
 
     # Return media preload property

data/lib/testcentricity_web/web_elements/radio.rb

@@ -2,11 +2,13 @@ module TestCentricity
   class Radio < UIElement
     attr_accessor :proxy
     attr_accessor :label
+    attr_accessor :input
 
     def initialize(name, parent, locator, context)
       super
       @type = :radio
       radio_spec = {
+        input: nil,
         proxy: nil,
         label: nil
       }
@@ -16,6 +18,8 @@ module TestCentricity
     def define_custom_elements(element_spec)
       element_spec.each do |element, value|
         case element
+        when :input
+          @input = value
         when :proxy
           @proxy = value
         when :label
@@ -44,9 +48,14 @@ module TestCentricity
     #   accept_terms_radio.selected?
     #
     def selected?
-      obj, = find_element(:all)
-      object_not_found_exception(obj, 'Radio')
-      obj.checked?
+      @base_object, = find_element(:all)
+      object_not_found_exception(@base_object, 'Radio')
+      rad = if @input.nil?
+              @base_object
+            else
+              find_component(@input, 'Radio')
+            end
+      rad.checked?
     end
 
     # Is radio button visible?
@@ -56,7 +65,14 @@ module TestCentricity
     #   accept_terms_radio.visible?
     #
     def visible?
-      @proxy.nil? ? super : page.find(:css, @proxy).visible?
+      if @proxy.nil?
+        super
+      else
+        @base_object, = find_element(:all)
+        object_not_found_exception(@base_object, 'Radio')
+        proxy = find_component(@proxy, 'radio proxy')
+        proxy.visible?
+      end
     end
 
     # Is radio button disabled (not enabled)?
@@ -66,10 +82,14 @@ module TestCentricity
     #   accept_terms_radio.disabled?
     #
     def disabled?
-      visibility = @proxy.nil? ? true : :all
-      obj, type = find_element(visibility)
-      object_not_found_exception(obj, type)
-      obj.disabled?
+      if @input.nil?
+        super
+      else
+        @base_object, = find_element(:all)
+        object_not_found_exception(@base_object, 'Radio')
+        rad = find_component(@input, 'radio')
+        rad.disabled?
+      end
     end
 
     # Return radio button caption
@@ -80,9 +100,15 @@ module TestCentricity
     #
     def get_value
       if @label.nil?
-        @proxy.nil? ? super : page.find(:css, @proxy).text
+        if @proxy.nil?
+          super
+        else
+          proxy = find_component(@proxy, 'radio proxy')
+          proxy.text
+        end
       else
-        page.find(:css, @label).text
+        label = find_component(@label, 'radio label')
+        label.text
       end
     end
 
@@ -97,13 +123,22 @@ module TestCentricity
     #   accept_terms_radio.set_selected_state(true)
     #
     def set_selected_state(state)
-      obj, = find_element(:all)
-      object_not_found_exception(obj, 'Radio')
-      invalid_object_type_exception(obj, 'radio')
-      if @proxy.nil?
-        obj.set(state)
+      @base_object, = find_element(:all)
+      object_not_found_exception(@base_object, 'Radio')
+      proxy = find_component(@proxy, 'radio proxy') unless @proxy.nil?
+      rad = find_component(@input, 'radio') unless @input.nil?
+      if @input.nil?
+        if @proxy.nil?
+          @base_object.click unless state == @base_object.checked?
+        else
+          proxy.click unless state == @base_object.checked?
+        end
       else
-        page.find(:css, @proxy).click unless state == obj.checked?
+        if @proxy.nil?
+          @base_object.click unless state == rad.checked?
+        else
+          proxy.click unless state == rad.checked?
+        end
       end
     end