testcentricity_web 4.1.9 → 4.3.0

data/lib/testcentricity_web/web_core/webdriver_helper.rb

@@ -24,16 +24,23 @@ module TestCentricity
         @endpoint = options[:endpoint] if options.key?(:endpoint)
         @capabilities = options[:desired_capabilities] if options.key?(:desired_capabilities)
       end
-
-      browser = ENV['WEB_BROWSER']
+      # determine browser type and driver
+      Environ.browser = ENV['WEB_BROWSER'] if ENV['WEB_BROWSER']
+      Environ.driver = if ENV['DRIVER']
+                         ENV['DRIVER'].downcase.to_sym
+                       else
+                         :webdriver
+                       end
       # 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)
+        if Dir.exist?(@downloads_path)
+          @downloads_path = "#{@downloads_path}/#{ENV['TEST_ENV_NUMBER']}"
+          Dir.mkdir(@downloads_path) unless Dir.exist?(@downloads_path)
+        end
         # :nocov:
       else
         Environ.parallel = false
@@ -41,18 +48,16 @@ module TestCentricity
       @downloads_path = @downloads_path.tr('/', "\\") if OS.windows?
 
       # assume that we're testing within a local desktop web browser
-      Environ.driver      = :webdriver
       Environ.platform    = :desktop
-      Environ.browser     = browser
       Environ.headless    = false
       Environ.device      = :web
       Environ.device_name = 'browser'
 
-      context = case browser.downcase.to_sym
+      context = case Environ.driver
                 when :appium
                   initialize_appium
                   'Appium'
-                # :nocov:
+                  # :nocov:
                 when :browserstack
                   initialize_browserstack
                   'Browserstack cloud service'
@@ -65,8 +70,7 @@ module TestCentricity
                 when :testingbot
                   initialize_testingbot
                   'TestingBot cloud service'
-                # :nocov:
-                else
+                when :webdriver
                   if ENV['SELENIUM'] == 'remote'
                     initialize_remote
                     'Selenium Grid'
@@ -138,70 +142,75 @@ module TestCentricity
     private
 
     def self.initialize_appium
-      Environ.platform    = :mobile
+      Environ.platform = :mobile
+      Environ.device = :simulator
+      Environ.browser = ENV['APP_BROWSER']
       Environ.device_name = ENV['APP_DEVICE']
-      Environ.device_os   = ENV['APP_PLATFORM_NAME'].downcase.to_sym
+      Environ.device_os = ENV['APP_PLATFORM_NAME'].downcase.to_sym
       Environ.device_type = ENV['DEVICE_TYPE'] if ENV['DEVICE_TYPE']
       Environ.device_os_version = ENV['APP_VERSION']
       Environ.device_orientation = ENV['ORIENTATION'] if ENV['ORIENTATION']
       Capybara.default_driver = :appium
       Environ.driver = :appium
-      desired_capabilities = {
-          platformName:    Environ.device_os,
-          platformVersion: Environ.device_os_version,
-          browserName:     ENV['APP_BROWSER'],
-          deviceName:      Environ.device_name
-      }
-      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
-        if Environ.device_os == :ios
-          desired_capabilities[:language] = Environ.language if Environ.language
-          desired_capabilities[:locale] = Environ.locale.gsub('-', '_') if Environ.locale
-        end
-      end
-      desired_capabilities[:safariIgnoreFraudWarning] = ENV['APP_IGNORE_FRAUD_WARNING'] if ENV['APP_IGNORE_FRAUD_WARNING']
-      desired_capabilities[:safariInitialUrl] = ENV['APP_INITIAL_URL'] if ENV['APP_INITIAL_URL']
-      desired_capabilities[:safariAllowPopups] = ENV['APP_ALLOW_POPUPS'] if ENV['APP_ALLOW_POPUPS']
-      desired_capabilities[:shutdownOtherSimulators] = ENV['SHUTDOWN_OTHER_SIMS'] if ENV['SHUTDOWN_OTHER_SIMS']
-      desired_capabilities[:forceSimulatorSoftwareKeyboardPresence] = ENV['SHOW_SIM_KEYBOARD'] if ENV['SHOW_SIM_KEYBOARD']
-
-      desired_capabilities[:autoAcceptAlerts] = ENV['AUTO_ACCEPT_ALERTS'] if ENV['AUTO_ACCEPT_ALERTS']
-      desired_capabilities[:autoDismissAlerts] = ENV['AUTO_DISMISS_ALERTS'] if ENV['AUTO_DISMISS_ALERTS']
-      desired_capabilities[:isHeadless] = ENV['HEADLESS'] if ENV['HEADLESS']
-
-      desired_capabilities[:newCommandTimeout] = ENV['NEW_COMMAND_TIMEOUT'] if ENV['NEW_COMMAND_TIMEOUT']
-      desired_capabilities[:noReset] = ENV['APP_NO_RESET'] if ENV['APP_NO_RESET']
-      desired_capabilities[:fullReset] = ENV['APP_FULL_RESET'] if ENV['APP_FULL_RESET']
-      desired_capabilities[:webkitDebugProxyPort] = ENV['WEBKIT_DEBUG_PROXY_PORT'] if ENV['WEBKIT_DEBUG_PROXY_PORT']
-      desired_capabilities[:webDriverAgentUrl] = ENV['WEBDRIVER_AGENT_URL'] if ENV['WEBDRIVER_AGENT_URL']
-      desired_capabilities[:usePrebuiltWDA] = ENV['USE_PREBUILT_WDA'] if ENV['USE_PREBUILT_WDA']
-      desired_capabilities[:useNewWDA] = ENV['USE_NEW_WDA'] if ENV['USE_NEW_WDA']
-      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']
-      end
-
-      desired_capabilities = @capabilities unless @capabilities.nil?
+      # define capabilites
+      desired_capabilities = if @capabilities.nil?
+                               desired_capabilities = {
+                                 platformName: Environ.device_os,
+                                 platformVersion: Environ.device_os_version,
+                                 browserName: Environ.browser,
+                                 deviceName: Environ.device_name
+                               }
+                               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
+                                 desired_capabilities[:orientation] = Environ.device_orientation.upcase if Environ.device_orientation
+                                 if Environ.device_os == :ios
+                                   desired_capabilities[:language] = Environ.language if Environ.language
+                                   desired_capabilities[:locale] = Environ.locale.gsub('-', '_') if Environ.locale
+                                 end
+                               end
+                               desired_capabilities[:safariIgnoreFraudWarning] = ENV['APP_IGNORE_FRAUD_WARNING'] if ENV['APP_IGNORE_FRAUD_WARNING']
+                               desired_capabilities[:safariInitialUrl] = ENV['APP_INITIAL_URL'] if ENV['APP_INITIAL_URL']
+                               desired_capabilities[:safariAllowPopups] = ENV['APP_ALLOW_POPUPS'] if ENV['APP_ALLOW_POPUPS']
+                               desired_capabilities[:shutdownOtherSimulators] = ENV['SHUTDOWN_OTHER_SIMS'] if ENV['SHUTDOWN_OTHER_SIMS']
+                               desired_capabilities[:forceSimulatorSoftwareKeyboardPresence] = ENV['SHOW_SIM_KEYBOARD'] if ENV['SHOW_SIM_KEYBOARD']
+
+                               desired_capabilities[:autoAcceptAlerts] = ENV['AUTO_ACCEPT_ALERTS'] if ENV['AUTO_ACCEPT_ALERTS']
+                               desired_capabilities[:autoDismissAlerts] = ENV['AUTO_DISMISS_ALERTS'] if ENV['AUTO_DISMISS_ALERTS']
+                               desired_capabilities[:isHeadless] = ENV['HEADLESS'] if ENV['HEADLESS']
+
+                               desired_capabilities[:newCommandTimeout] = ENV['NEW_COMMAND_TIMEOUT'] if ENV['NEW_COMMAND_TIMEOUT']
+                               desired_capabilities[:noReset] = ENV['APP_NO_RESET'] if ENV['APP_NO_RESET']
+                               desired_capabilities[:fullReset] = ENV['APP_FULL_RESET'] if ENV['APP_FULL_RESET']
+                               desired_capabilities[:webkitDebugProxyPort] = ENV['WEBKIT_DEBUG_PROXY_PORT'] if ENV['WEBKIT_DEBUG_PROXY_PORT']
+                               desired_capabilities[:webDriverAgentUrl] = ENV['WEBDRIVER_AGENT_URL'] if ENV['WEBDRIVER_AGENT_URL']
+                               desired_capabilities[:usePrebuiltWDA] = ENV['USE_PREBUILT_WDA'] if ENV['USE_PREBUILT_WDA']
+                               desired_capabilities[:useNewWDA] = ENV['USE_NEW_WDA'] if ENV['USE_NEW_WDA']
+                               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']
+                               end
+                               desired_capabilities
+                             else
+                               @capabilities
+                             end
       # specify endpoint url
       @endpoint = 'http://localhost:4723/wd/hub' if @endpoint.nil?
 
@@ -225,7 +234,7 @@ module TestCentricity
                    else
                      'unknown'
                    end
-      browser = ENV['WEB_BROWSER'].downcase.to_sym
+      browser = Environ.browser.downcase.to_sym
 
       case browser
       when :firefox, :chrome, :ie, :safari, :edge
@@ -235,7 +244,7 @@ module TestCentricity
         Environ.headless = true
       else
         Environ.platform = :mobile
-        Environ.device_name = Browsers.mobile_device_name(ENV['WEB_BROWSER'])
+        Environ.device_name = Browsers.mobile_device_name(Environ.browser)
       end
 
       Capybara.register_driver :selenium do |app|
@@ -253,8 +262,8 @@ module TestCentricity
           Capybara::Selenium::Driver.new(app, browser: :edge, capabilities: [options])
         else
           if ENV['HOST_BROWSER'] && ENV['HOST_BROWSER'].downcase.to_sym == :chrome
-            user_agent = Browsers.mobile_device_agent(ENV['WEB_BROWSER'])
-            options = Selenium::WebDriver::Chrome::Options.new(options: {'excludeSwitches' => ['enable-automation']})
+            user_agent = Browsers.mobile_device_agent(Environ.browser)
+            options = Selenium::WebDriver::Chrome::Options.new
             options.add_argument('--disable-dev-shm-usage')
             options.add_argument("--user-agent='#{user_agent}'")
             options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
@@ -269,7 +278,7 @@ module TestCentricity
 
     def self.initialize_remote
       Environ.grid = :selenium_grid
-      browser  = ENV['WEB_BROWSER'].downcase.to_sym
+      browser  = Environ.browser.downcase.to_sym
       @endpoint = ENV['REMOTE_ENDPOINT'] || 'http://127.0.0.1:4444/wd/hub' if @endpoint.nil?
 
       case browser
@@ -284,9 +293,9 @@ module TestCentricity
       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']})
+          Environ.device_name = Browsers.mobile_device_name(Environ.browser)
+          user_agent = Browsers.mobile_device_agent(Environ.browser)
+          options = Selenium::WebDriver::Chrome::Options.new
           options.add_argument('--disable-dev-shm-usage')
           options.add_argument("--user-agent='#{user_agent}'")
           options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
@@ -390,7 +399,7 @@ module TestCentricity
                   else
                     # define desktop browser options
                     bs_options[:resolution] = ENV['RESOLUTION'] if ENV['RESOLUTION']
-                    bs_options[:seleniumVersion] = '4.1.0'
+                    bs_options[:seleniumVersion] = '4.3.0'
                     {
                       browserName: browser,
                       browserVersion: ENV['BS_VERSION'],
@@ -488,7 +497,7 @@ module TestCentricity
                   # define mobile device options
                   if ENV['SL_PLATFORM']
                     sl_options[:deviceOrientation] = ENV['ORIENTATION'].upcase if ENV['ORIENTATION']
-                    sl_options[:appiumVersion] = '1.22.0'
+                    sl_options[:appiumVersion] = '1.22.3'
                     {
                       browserName: browser,
                       platformName: ENV['SL_PLATFORM'],
@@ -572,9 +581,9 @@ module TestCentricity
     def self.chrome_edge_options(browser)
       options = case browser
                 when :chrome, :chrome_headless
-                  Selenium::WebDriver::Chrome::Options.new(options: {'excludeSwitches' => ['enable-automation']})
+                  Selenium::WebDriver::Chrome::Options.new
                 when :edge, :edge_headless
-                  Selenium::WebDriver::Edge::Options.new(options: {'excludeSwitches' => ['enable-automation']})
+                  Selenium::WebDriver::Edge::Options.new
                 end
       prefs = {
         prompt_for_download: false,

data/lib/testcentricity_web/web_elements/media.rb

@@ -213,6 +213,114 @@ module TestCentricity
       obj.native.attribute('volume').to_f
     end
 
+    # Return number of text tracks of associated media
+    #
+    # @return [Integer] number of text tracks
+    # @example
+    #   num_tracks = media_player.track_count
+    #
+    def track_count
+      obj, = find_element(visible = :all)
+      object_not_found_exception(obj, @type)
+      page.execute_script('return arguments[0].textTracks.length', obj)
+    end
+
+    # Return index of active text track of associated media
+    #
+    # @return [Integer] number of active text track
+    # @example
+    #   track_num = media_player.active_track
+    #
+    def active_track
+      num_tracks = track_count
+      return 0 if num_tracks.zero?
+
+      obj, = find_element(visible = :all)
+      object_not_found_exception(obj, @type)
+      (0..num_tracks).each do |track|
+        track_info = page.execute_script("return arguments[0].textTracks[#{track}].mode", obj)
+        return track + 1 if track_info == 'showing'
+      end
+      0
+    end
+
+    # Return properties of active text track of associated media
+    #
+    # @return [Hash] properties of active text track (:kind, :label, :language, :mode)
+    # @example
+    #   track_info = media_player.active_track_data
+    #
+    def active_track_data
+      active = active_track
+      return nil if active.zero?
+
+      track_data(active)
+    end
+
+    # Return properties of all text tracks of associated media
+    #
+    # @return [Array of Hash] properties of active text track (:kind, :label, :language, :mode)
+    # @example
+    #   all_track_info = media_player.all_tracks_data
+    #
+    def all_tracks_data
+      num_tracks = track_count
+      return 0 if num_tracks.zero?
+
+      all_data = []
+      (1..num_tracks).each do |track|
+        all_data.push( { track => track_data(track) })
+      end
+      all_data
+    end
+
+    # Return properties of specified text track of associated media
+    #
+    # @param track [Integer] index of requested track
+    # @return [Hash] properties of requested text track (:kind, :label, :language, :mode)
+    # @example
+    #   track_info = media_player.track_data(1)
+    #
+    def track_data(track)
+      obj, = find_element(visible = :all)
+      object_not_found_exception(obj, @type)
+      track_mode = page.execute_script("return arguments[0].textTracks[#{track - 1}].mode", obj)
+      track_obj = obj.find(:css, "track:nth-of-type(#{track})", visible: :all, wait: 1)
+      {
+        kind: track_obj[:kind],
+        label: track_obj[:label],
+        language: track_obj[:srclang],
+        mode: track_mode
+      }
+    end
+
+    # Return src property of active text track of associated media
+    #
+    # @return [String] src property of active text track
+    # @example
+    #   track_src = media_player.active_track_source
+    #
+    def active_track_source
+      active = active_track
+      return nil if active.zero?
+
+      track_source(active)
+    end
+
+    # Return srv property of specified text track of associated media
+    #
+    # @param track [Integer] index of requested track
+    # @return [String] src property of requested text track
+    # @example
+    #   track_src = media_player.track_source(2)
+    #
+    def track_source(track)
+      obj, = find_element(visible = :all)
+      object_not_found_exception(obj, @type)
+      track_obj = obj.find(:css, "track:nth-of-type(#{track})", visible: :all, wait: 1)
+      track_obj[:src]
+    end
+
     # Set the media currentTime property
     #
     # @param value [Float] time in seconds

data/lib/testcentricity_web/web_elements/textfield.rb

@@ -42,6 +42,34 @@ module TestCentricity
       obj.native.attribute('placeholder')
     end
 
+    # Return validationMessage property of a textfield, which is the message the browser displays to the user when a textfield's
+    # validity is checked and fails. Note that each web browser provides a default localized message for this property, and message
+    # strings can vary between different browsers (Chrome/Edge vs Firefox vs Safari).
+    #
+    # @return [String]
+    # @example
+    #   message = username_field.validation_message
+    #
+    def validation_message
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      obj.native.attribute('validationMessage')
+    end
+
+    # Return Boolean value representing
+    #
+    # @param validity_state [Symbol] property to verify
+    # @return [Boolean]
+    # @example
+    #   username_field.validity?(:valid)
+    #   username_field.validity?(:valueMissing)
+    #
+    def validity?(validity_state)
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      page.execute_script("return arguments[0].validity.#{validity_state}", obj)
+    end
+
     # Return min attribute of a number type text field.
     #
     # @return [Integer]

data/lib/testcentricity_web/web_elements/ui_elements_helper.rb

@@ -47,7 +47,7 @@ module TestCentricity
     attr_accessor :base_object
 
     XPATH_SELECTORS = ['//', '[@', '[contains(']
-    CSS_SELECTORS   = ['#', ':nth-child(', ':first-child', ':last-child', ':nth-of-type(', ':first-of-type', ':last-of-type', '^=', '$=', '*=', ':contains(']
+    CSS_SELECTORS   = %w[# :nth-child( :first-child :last-child :nth-of-type( :first-of-type :last-of-type ^= $= *= :contains(]
 
     def initialize(name, parent, locator, context)
       @name           = name
@@ -390,6 +390,44 @@ module TestCentricity
       end
     end
 
+    # Wait until the object is enabled, 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
+    #   run_button.wait_until_enabled(10)
+    #
+    def wait_until_enabled(seconds = nil, post_exception = true)
+      timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { enabled? }
+    rescue StandardError
+      if post_exception
+        raise "UI #{object_ref_message} remained disabled after #{timeout} seconds" unless enabled?
+      else
+        enabled?
+      end
+    end
+
+    # Wait until the object is no longer in a busy state, 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
+    #   login_button.wait_while_busy(10)
+    #
+    def wait_while_busy(seconds = nil, post_exception = true)
+      timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { aria_busy? }
+    rescue StandardError
+      if post_exception
+        raise "UI #{object_ref_message} remained in busy state after #{timeout} seconds" if aria_busy?
+      else
+        aria_busy?
+      end
+    end
+
     # Wait until the object's value equals the specified value, 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.
     #