testcentricity_web 3.3.0 → 4.0.0

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -137,8 +137,6 @@ module TestCentricity
                      ui_object.count(visible = true)
                    when :count_all
                      ui_object.count(visible = :all)
-                   when :siebel_options
-                     ui_object.get_siebel_options
                    when :style
                      ui_object.style
                    when :href
@@ -282,11 +280,7 @@ module TestCentricity
               check_state = data_param.is_a?(String) ? data_param.to_bool : data_param
               data_field.set_checkbox_state(check_state)
             when :selectlist
-              if data_field.get_siebel_object_type == 'JComboBox'
-                data_field.set("#{data_param}\t")
-              else
-                data_field.choose_option(data_param)
-              end
+              data_field.choose_option(data_param)
             when :radio
               check_state = data_param.is_a?(String) ? data_param.to_bool : data_param
               data_field.set_selected_state(check_state)

data/lib/testcentricity_web/web_core/page_section.rb

@@ -407,97 +407,6 @@ module TestCentricity
       element_hash.each(&method(:filefield))
     end
 
-    # Declare and instantiate a cell button in a table column on this page section.
-    #
-    # @param element_name [Symbol] name of cell button object (as a symbol)
-    # @param locator [String] XPath expression that uniquely identifies cell button within row and column of parent table object
-    # @param table [Symbol] Name (as a symbol) of parent table object
-    # @param column [Integer] 1-based index of table column that contains the cell button object
-    # @example
-    #   cell_button  :show_button, "a[@class='show']", :data_table, 5
-    #   cell_button  :edit_button, "a[@class='edit']", :data_table, 5
-    #
-    def self.cell_button(element_name, locator, table, column)
-      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::CellButton.new("#{element_name}", self, "#{locator}", :section, #{table}, #{column});end))
-    end
-
-    # Declare and instantiate a cell checkbox in a table column on this page section.
-    #
-    # @param element_name [Symbol] name of cell checkbox object (as a symbol)
-    # @param locator [String] XPath expression that uniquely identifies cell checkbox within row and column of parent table object
-    # @param table [Symbol] Name (as a symbol) of parent table object
-    # @param column [Integer] 1-based index of table column that contains the cell checkbox object
-    # @example
-    #   cell_checkbox  :is_registered_check, "a[@class='registered']", :data_table, 4
-    #
-    def self.cell_checkbox(element_name, locator, table, column, proxy = nil)
-      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::CellCheckBox.new("#{element_name}", self, "#{locator}", :section, #{table}, #{column}, #{proxy});end))
-    end
-
-    # Declare and instantiate a cell radio in a table column on this page section.
-    #
-    # @param element_name [Symbol] name of cell radio object (as a symbol)
-    # @param locator [String] XPath expression that uniquely identifies cell radio within row and column of parent table object
-    # @param table [Symbol] Name (as a symbol) of parent table object
-    # @param column [Integer] 1-based index of table column that contains the cell radio object
-    # @example
-    #   cell_radio  :track_a_radio, "a[@class='track_a']", :data_table, 8
-    #
-    def self.cell_radio(element_name, locator, table, column, proxy = nil)
-      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::CellRadio.new("#{element_name}", self, "#{locator}", :section, #{table}, #{column}, #{proxy});end))
-    end
-
-    # Declare and instantiate a cell image in a table column on this page object.
-    #
-    # @param element_name [Symbol] name of cell image object (as a symbol)
-    # @param locator [String] XPath expression that uniquely identifies cell image within row and column of parent table object
-    # @param table [Symbol] Name (as a symbol) of parent table object
-    # @param column [Integer] 1-based index of table column that contains the cell image object
-    # @example
-    #   cell_image  :ready_icon, "img[@class='ready']", :data_table, 3
-    #   cell_image  :send_icon, "img[@class='send']", :data_table, 3
-    #
-    def self.cell_image(element_name, locator, table, column)
-      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::CellImage.new("#{element_name}", self, "#{locator}", :section, #{table}, #{column});end))
-    end
-
-    # Declare and instantiate a list button in a row of a list object on this section object.
-    #
-    # @param element_name [Symbol] name of list button object (as a symbol)
-    # @param locator [String] XPath expression that uniquely identifies list button within row of parent list object
-    # @param list [Symbol] Name (as a symbol) of parent list object
-    # @example
-    #   list_button  :delete_button, "a[@class='delete']", :icon_list
-    #   list_button  :edit_button, "a[@class='edit']", :icon_list
-    #
-    def self.list_button(element_name, locator, list)
-      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::ListButton.new("#{element_name}", self, "#{locator}", :section, #{list});end))
-    end
-
-    # Declare and instantiate a list checkbox in a row of a list object on this section object.
-    #
-    # @param element_name [Symbol] name of list checkbox object (as a symbol)
-    # @param locator [String] XPath expression that uniquely identifies list checkbox within row of parent list object
-    # @param list [Symbol] Name (as a symbol) of parent list object
-    # @example
-    #   list_checkbox  :is_registered_check, "a[@class='registered']", :data_list
-    #
-    def self.list_checkbox(element_name, locator, list, proxy = nil)
-      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::ListCheckBox.new("#{element_name}", self, "#{locator}", :section, #{list}, #{proxy});end))
-    end
-
-    # Declare and instantiate a list radio in a row of a list object on this section object.
-    #
-    # @param element_name [Symbol] name of list radio object (as a symbol)
-    # @param locator [String] XPath expression that uniquely identifies list radio within row of parent list object
-    # @param list [Symbol] Name (as a symbol) of parent list object
-    # @example
-    #   list_radio  :sharing_radio, "a[@class='sharing']", :data_list
-    #
-    def self.list_radio(element_name, locator, list, proxy = nil)
-      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::CellRadio.new("#{element_name}", self, "#{locator}", :section, #{list}, #{proxy});end))
-    end
-
     # Instantiate a single PageSection object within this PageSection object.
     #
     # @param section_name [Symbol] name of PageSection object (as a symbol)

data/lib/testcentricity_web/web_core/webdriver_helper.rb

@@ -6,14 +6,23 @@ require 'fileutils'
 
 
 module TestCentricity
-  module WebDriverConnect
+  class WebDriverConnect
     include Capybara::DSL
 
     attr_accessor :bs_local
     attr_accessor :downloads_path
 
-    def self.initialize_web_driver(app_host = nil)
-      Capybara.app_host = app_host unless app_host.nil?
+    def self.initialize_web_driver(options = nil)
+      desired_caps = nil
+      merge_caps = nil
+      if options.is_a?(String)
+        Capybara.app_host = options
+      elsif options.is_a?(Hash)
+        Capybara.app_host = options[:app_host] if options.key?(:app_host)
+        desired_caps = options[:desired_capabilities] if options.key?(:desired_capabilities)
+        merge_caps = options[:merge_capabilities] if options.key?(:merge_capabilities)
+      end
+
       browser = ENV['WEB_BROWSER']
       # set downloads folder path
       @downloads_path = "#{Dir.pwd}/downloads"
@@ -37,25 +46,25 @@ module TestCentricity
 
       context = case browser.downcase.to_sym
                 when :appium
-                  initialize_appium
+                  initialize_appium(desired_caps, merge_caps)
                   'mobile device emulator'
                 when :browserstack
-                  initialize_browserstack
+                  initialize_browserstack(desired_caps, merge_caps)
                   'Browserstack cloud service'
                 when :crossbrowser
-                  initialize_crossbrowser
+                  initialize_crossbrowser(desired_caps, merge_caps)
                   'CrossBrowserTesting cloud service'
                 when :gridlastic
-                  initialize_gridlastic
+                  initialize_gridlastic(desired_caps, merge_caps)
                   'Gridlastic cloud service'
                 when :lambdatest
-                  initialize_lambdatest
+                  initialize_lambdatest(desired_caps, merge_caps)
                   'LambdaTest cloud service'
                 when :saucelabs
-                  initialize_saucelabs
+                  initialize_saucelabs(desired_caps, merge_caps)
                   'Sauce Labs cloud service'
                 when :testingbot
-                  initialize_testingbot
+                  initialize_testingbot(desired_caps, merge_caps)
                   'TestingBot cloud service'
                 else
                   if ENV['SELENIUM'] == 'remote'
@@ -124,7 +133,7 @@ module TestCentricity
 
     private
 
-    def self.initialize_appium
+    def self.initialize_appium(desired_caps = nil, merge_caps = false)
       Environ.platform    = :mobile
       Environ.device_name = ENV['APP_DEVICE']
       Environ.device_os   = ENV['APP_PLATFORM_NAME'].downcase.to_sym
@@ -183,6 +192,10 @@ module TestCentricity
         desired_capabilities[:systemPort]   = ENV['SYSTEM_PORT'] if ENV['SYSTEM_PORT']
       end
 
+      unless desired_caps.nil?
+        desired_capabilities = merge_caps ? desired_capabilities.merge(desired_caps) : desired_caps
+      end
+
       Capybara.register_driver :appium do |app|
         appium_lib_options = { server_url: endpoint }
         all_options = {
@@ -198,6 +211,8 @@ module TestCentricity
                      'OS X'
                    elsif OS.windows?
                      'Windows'
+                   elsif OS.linux?
+                     'Linux'
                    end
 
       browser = ENV['WEB_BROWSER'].downcase.to_sym
@@ -216,8 +231,8 @@ module TestCentricity
       Capybara.register_driver :selenium do |app|
         case browser
         when :safari
-          desired_caps = Selenium::WebDriver::Remote::Capabilities.safari(cleanSession: true)
-          Capybara::Selenium::Driver.new(app, browser: browser, desired_capabilities: desired_caps)
+          caps = Selenium::WebDriver::Remote::Capabilities.safari(cleanSession: true)
+          Capybara::Selenium::Driver.new(app, browser: browser, desired_capabilities: caps)
         when :ie, :edge
           Capybara::Selenium::Driver.new(app, browser: browser)
         when :firefox, :firefox_headless
@@ -248,6 +263,7 @@ module TestCentricity
           }
           options.add_preference(:download, prefs)
           options.add_argument('--disable-infobars')
+          options.add_argument('--disable-dev-shm-usage')
           options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
           if browser == :chrome_headless
             options.add_argument('--headless')
@@ -255,11 +271,13 @@ module TestCentricity
             options.add_argument('--no-sandbox')
           end
 
-          Capybara::Selenium::Driver.new(app, browser: :chrome, options: options)        else
+          Capybara::Selenium::Driver.new(app, browser: :chrome, options: 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.add_argument('--disable-infobars')
+            options.add_argument('--disable-dev-shm-usage')
             options.add_argument("--user-agent='#{user_agent}'")
             options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
             Capybara::Selenium::Driver.new(app, browser: :chrome, options: options)
@@ -271,7 +289,7 @@ module TestCentricity
       Capybara.default_driver = :selenium
     end
 
-    def self.initialize_browserstack
+    def self.initialize_browserstack(desired_caps = nil, merge_caps = false)
       browser = ENV['BS_BROWSER']
       Environ.grid = :browserstack
 
@@ -283,19 +301,22 @@ module TestCentricity
       elsif ENV['BS_OS']
         Environ.os = "#{ENV['BS_OS']} #{ENV['BS_OS_VERSION']}"
       end
+      Environ.device = if ENV['BS_REAL_MOBILE']
+                         :device
+                       elsif ENV['BS_PLATFORM']
+                         :simulator
+                       end
 
       endpoint = "http://#{ENV['BS_USERNAME']}:#{ENV['BS_AUTHKEY']}@hub-cloud.browserstack.com/wd/hub"
       Capybara.register_driver :browserstack do |app|
         capabilities = Selenium::WebDriver::Remote::Capabilities.new
 
         if ENV['BS_REAL_MOBILE']
-          Environ.device = :device
           capabilities['device'] = ENV['BS_DEVICE']
           capabilities['realMobile'] = true
           capabilities['os_version'] = ENV['BS_OS_VERSION']
 
         elsif ENV['BS_PLATFORM']
-          Environ.device = :simulator
           capabilities[:platform] = ENV['BS_PLATFORM']
           capabilities[:browserName] = browser
           capabilities['device'] = ENV['BS_DEVICE'] if ENV['BS_DEVICE']
@@ -357,6 +378,10 @@ module TestCentricity
           capabilities['cleanSession'] = 'true'
         end
 
+        unless desired_caps.nil?
+          capabilities = merge_caps ? capabilities.merge(desired_caps) : desired_caps
+        end
+
         if ENV['TUNNELING']
           @bs_local = BrowserStack::Local.new
           bs_local_args = {'key' => "#{ENV['BS_AUTHKEY']}"}
@@ -385,7 +410,7 @@ module TestCentricity
       end
     end
 
-    def self.initialize_crossbrowser
+    def self.initialize_crossbrowser(desired_caps = nil, merge_caps = false)
       browser = ENV['CB_BROWSER']
       Environ.grid = :crossbrowser
 
@@ -412,6 +437,11 @@ module TestCentricity
         elsif ENV['CB_PLATFORM']
           capabilities['os_api_name'] = ENV['CB_PLATFORM']
         end
+
+        unless desired_caps.nil?
+          capabilities = merge_caps ? capabilities.merge(desired_caps) : desired_caps
+        end
+
         Capybara::Selenium::Driver.new(app, browser: :remote, url: endpoint, desired_capabilities: capabilities)
       end
 
@@ -427,12 +457,11 @@ module TestCentricity
       end
     end
 
-    def self.initialize_gridlastic
+    def self.initialize_gridlastic(desired_caps = nil, merge_caps = false)
       browser = ENV['GL_BROWSER']
       Environ.grid = :gridlastic
       Environ.os = ENV['GL_OS']
       endpoint = "http://#{ENV['GL_USERNAME']}:#{ENV['GL_AUTHKEY']}@#{ENV['GL_SUBDOMAIN']}.gridlastic.com:80/wd/hub"
-
       capabilities = Selenium::WebDriver::Remote::Capabilities.new
       capabilities['browserName']  = browser
       capabilities['version']      = ENV['GL_VERSION'] if ENV['GL_VERSION']
@@ -440,6 +469,10 @@ module TestCentricity
       capabilities['platformName'] = ENV['GL_PLATFORM']
       capabilities['video']        = ENV['RECORD_VIDEO'].capitalize if ENV['RECORD_VIDEO']
 
+      unless desired_caps.nil?
+        capabilities = merge_caps ? capabilities.merge(desired_caps) : desired_caps
+      end
+
       Capybara.register_driver :selenium do |app|
         client = Selenium::WebDriver::Remote::Http::Default.new
         client.timeout = 1200
@@ -463,7 +496,7 @@ module TestCentricity
       end
     end
 
-    def self.initialize_lambdatest
+    def self.initialize_lambdatest(desired_caps = nil, merge_caps = false)
       browser = ENV['LT_BROWSER']
       Environ.grid = :lambdatest
       Environ.os = ENV['LT_OS']
@@ -502,6 +535,10 @@ module TestCentricity
         end
         capabilities['build'] = context_message
 
+        unless desired_caps.nil?
+          capabilities = merge_caps ? capabilities.merge(desired_caps) : desired_caps
+        end
+
         Capybara::Selenium::Driver.new(app, browser: :remote, url: endpoint, desired_capabilities: capabilities)
       end
 
@@ -526,13 +563,23 @@ module TestCentricity
         when :firefox, :safari, :ie, :edge
           capabilities = Selenium::WebDriver::Remote::Capabilities.send(browser)
         when :chrome, :chrome_headless
-          options = browser == :chrome ? %w[--disable-infobars] : %w[headless disable-gpu no-sandbox --disable-infobars]
+          options = %w[--disable-infobars]
+          options.push('--disable-dev-shm-usage')
           options.push("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
+          if browser == :chrome_headless
+            Environ.headless = true
+            options.push('--headless')
+            options.push('--disable-gpu')
+            options.push('--no-sandbox')
+          end
           capabilities = Selenium::WebDriver::Remote::Capabilities.chrome('goog:chromeOptions' => { args: options })
         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 = %w[--disable-infobars]
+            options.push('--disable-dev-shm-usage')
             options.push("--user-agent='#{user_agent}'")
             options.push("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
             capabilities = Selenium::WebDriver::Remote::Capabilities.chrome('goog:chromeOptions' => { args: options })
@@ -540,19 +587,22 @@ module TestCentricity
             raise "Requested browser '#{browser}' is not supported on Selenium Grid"
           end
         end
-        Capybara::Selenium::Driver.new(app, browser: :remote, url: endpoint, desired_capabilities: capabilities)
+        Capybara::Selenium::Driver.new(app,
+                                       browser: :remote,
+                                       url: endpoint,
+                                       desired_capabilities: capabilities).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
-      # configure file_detector for remote uploads
-      selenium = Capybara.page.driver.browser
-      selenium.file_detector = lambda do |args|
-        str = args.first.to_s
-        str if File.exist?(str)
-      end
     end
 
-    def self.initialize_saucelabs
+    def self.initialize_saucelabs(desired_caps = nil, merge_caps = false)
       browser = ENV['SL_BROWSER']
       Environ.grid = :saucelabs
 
@@ -582,6 +632,10 @@ module TestCentricity
           capabilities['deviceOrientation'] = ENV['ORIENTATION'] if ENV['ORIENTATION']
         end
 
+        unless desired_caps.nil?
+          capabilities = merge_caps ? capabilities.merge(desired_caps) : desired_caps
+        end
+
         Capybara::Selenium::Driver.new(app, browser: :remote, url: endpoint, desired_capabilities: capabilities)
       end
 
@@ -597,7 +651,7 @@ module TestCentricity
       end
     end
 
-    def self.initialize_testingbot
+    def self.initialize_testingbot(desired_caps = nil, merge_caps = false)
       browser = ENV['TB_BROWSER']
       Environ.grid = :testingbot
 
@@ -630,6 +684,10 @@ module TestCentricity
           capabilities['deviceName']   = ENV['TB_DEVICE']
         end
 
+        unless desired_caps.nil?
+          capabilities = merge_caps ? capabilities.merge(desired_caps) : desired_caps
+        end
+
         Capybara::Selenium::Driver.new(app, browser: :remote, url: endpoint, desired_capabilities: capabilities)
       end
 

data/lib/testcentricity_web/web_elements/checkbox.rb

@@ -117,7 +117,7 @@ module TestCentricity
     #   remember_me_checkbox.uncheck
     #
     def uncheck
-      set_checkbox_state(false)
+      set_checkbox_state(state = false)
     end
 
     def verify_check_state(state, enqueue = false)
@@ -127,20 +127,6 @@ module TestCentricity
           assert_equal(state, actual, "Expected checkbox #{object_ref_message} to be #{state} but found #{actual} instead")
     end
 
-    # Set the check state of a Siebel OUI JCheckBox object.
-    #
-    # @param state [Boolean] true = checked / false = unchecked
-    # @example
-    #   remember_me_checkbox.set_siebel_checkbox_state(true)
-    #
-    def set_siebel_checkbox_state(state)
-      obj, = find_element
-      object_not_found_exception(obj, 'Siebel checkbox')
-      raise "UI #{object_ref_message} is not a Siebel CheckBox object" unless get_siebel_object_type == 'JCheckBox'
-      expected = state.to_bool
-      obj.click unless expected == obj.checked?
-    end
-
     # Highlight a checkbox with a 3 pixel wide, red dashed border for the specified wait time.
     # If wait time is zero, then the highlight will remain until the page is refreshed
     #