testcentricity_web 3.2.22 → 4.0.0

data/lib/testcentricity_web/exception_queue_helper.rb

@@ -76,22 +76,22 @@ module TestCentricity
             expected    = expected.downcase
             enqueue_exception("#{error_msg} be like '#{value}' but found '#{actual}'") unless actual_like.include?(expected)
           when :translate
-            expected = I18n.t(value)
+            expected = translate(value)
             enqueue_assert_equal(expected, actual, error_msg)
           when :translate_upcase
-            expected = I18n.t(value)
+            expected = translate(value)
             expected = expected.is_a?(Array) ? expected.map(&:upcase) : expected.upcase
             enqueue_assert_equal(expected, actual, error_msg)
           when :translate_downcase
-            expected = I18n.t(value)
+            expected = translate(value)
             expected = expected.is_a?(Array) ? expected.map(&:downcase) : expected.downcase
             enqueue_assert_equal(expected, actual, error_msg)
           when :translate_capitalize
-            expected = I18n.t(value)
+            expected = translate(value)
             expected = expected.is_a?(Array) ? expected.map(&:capitalize) : expected.capitalize
             enqueue_assert_equal(expected, actual, error_msg)
           when :translate_titlecase
-            expected = I18n.t(value)
+            expected = translate(value)
             expected = if expected.is_a?(Array)
                          result = []
                          expected.each do |item|
@@ -137,6 +137,29 @@ module TestCentricity
       screen_shot = {path: path, filename: filename}
       Environ.save_screen_shot(screen_shot)
     end
+
+    def self.translate(*args, **opts)
+      opts[:locale] ||= I18n.locale
+      opts[:raise] = true
+      I18n.translate(*args, **opts)
+    rescue I18n::MissingTranslationData => err
+      puts err
+      opts[:locale] = :en
+
+      # fallback to en if the translation is missing. If the translation isn't
+      # in en, then raise again.
+      disable_enforce_available_locales do
+        I18n.translate(*args, **opts)
+      end
+    end
+
+    def self.disable_enforce_available_locales
+      saved_enforce_available_locales = I18n.enforce_available_locales
+      I18n.enforce_available_locales = false
+      yield
+    ensure
+      I18n.enforce_available_locales = saved_enforce_available_locales
+    end
   end
 
 

data/lib/testcentricity_web/utility_helpers.rb

@@ -34,6 +34,10 @@ class String
     end
   end
 
+  def titlecase
+    "#{self.split.each{ |text| text.capitalize! }.join(' ')}"
+  end
+
   def is_int?
     Integer(self) && true rescue false
   end

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '3.2.22'
+  VERSION = '4.0.0'
 end

data/lib/testcentricity_web/web_core/page_object.rb

@@ -5,8 +5,7 @@ module TestCentricity
     # @param element_name [Symbol] name of UI object (as a symbol)
     # @param locator [String] CSS selector or XPath expression that uniquely identifies object
     # @example
-    #   element :siebel_view,  'div#_sweview'
-    #   element :siebel_busy,  "//html[contains(@class, 'siebui-busy')]"
+    #   element :settings_item, 'a#userPreferencesTrigger'
     #
     def self.element(element_name, locator)
       define_page_element(element_name, TestCentricity::UIElement, locator)
@@ -288,97 +287,6 @@ module TestCentricity
       element_hash.each(&method(:filefield))
     end
 
-    # Declare and instantiate a cell button in a table column on this page object.
-    #
-    # @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}", :page, #{table}, #{column});end))
-    end
-
-    # Declare and instantiate a cell checkbox in a table column on this page object.
-    #
-    # @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}", :page, #{table}, #{column}, #{proxy});end))
-    end
-
-    # Declare and instantiate a cell radio in a table column on this page object.
-    #
-    # @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}", :page, #{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}", :page, #{table}, #{column});end))
-    end
-
-    # Declare and instantiate a list button in a row of a list object on this page 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}", :page, #{list});end))
-    end
-
-    # Declare and instantiate a list checkbox in a row of a list object on this page 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}", :page, #{list}, #{proxy});end))
-    end
-
-    # Declare and instantiate a list radio in a row of a list object on this page 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::ListRadio.new("#{element_name}", self, "#{locator}", :page, #{list}, #{proxy});end))
-    end
-
     # Instantiate a single PageSection object for this page object.
     #
     # @param section_name [Symbol] name of PageSection object (as a symbol)

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,21 +133,22 @@ 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']
+      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
       endpoint = 'http://localhost:4723/wd/hub'
       desired_capabilities = {
-          platformName:    ENV['APP_PLATFORM_NAME'],
-          platformVersion: ENV['APP_VERSION'],
+          platformName:    Environ.device_os,
+          platformVersion: Environ.device_os_version,
           browserName:     ENV['APP_BROWSER'],
-          deviceName:      ENV['APP_DEVICE']
+          deviceName:      Environ.device_name
       }
-      desired_capabilities[:avd] = ENV['APP_DEVICE'] if ENV['APP_PLATFORM_NAME'].downcase.to_sym == :android
+      desired_capabilities[:avd] = ENV['APP_DEVICE'] if Environ.device_os == :android
       desired_capabilities[:automationName] = ENV['AUTOMATION_ENGINE'] if ENV['AUTOMATION_ENGINE']
       if ENV['UDID']
         Environ.device = :device
@@ -148,30 +158,49 @@ module TestCentricity
         desired_capabilities[:xcodeSigningId] = ENV['TEAM_NAME'] if ENV['TEAM_NAME']
       else
         Environ.device = :simulator
-        desired_capabilities[:orientation] = ENV['ORIENTATION'].upcase if ENV['ORIENTATION']
+        desired_capabilities[:orientation] = Environ.device_orientation.upcase if Environ.device_orientation
         if Environ.device_os == :ios
-          desired_capabilities[:language] = ENV['LANGUAGE'] if ENV['LANGUAGE']
-          desired_capabilities[:locale]   = ENV['LOCALE'].gsub('-', '_') if ENV['LOCALE']
+          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[: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[:wdaLocalPort]           = ENV['WDA_LOCAL_PORT'] if ENV['WDA_LOCAL_PORT']
       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']
+        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
+      else
+        desired_capabilities[:wdaLocalPort] = ENV['WDA_LOCAL_PORT'] if ENV['WDA_LOCAL_PORT']
+        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 = {
-            appium_lib:  appium_lib_options,
-            caps:        desired_capabilities
+          appium_lib: appium_lib_options,
+          caps:       desired_capabilities
         }
         Appium::Capybara::Driver.new app, all_options
       end
@@ -182,6 +211,8 @@ module TestCentricity
                      'OS X'
                    elsif OS.windows?
                      'Windows'
+                   elsif OS.linux?
+                     'Linux'
                    end
 
       browser = ENV['WEB_BROWSER'].downcase.to_sym
@@ -200,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
@@ -224,25 +255,29 @@ module TestCentricity
           options.args << '--headless' if browser == :firefox_headless
           Capybara::Selenium::Driver.new(app, browser: :firefox, options: options)
         when :chrome, :chrome_headless
-          if browser == :chrome
-            options = Selenium::WebDriver::Chrome::Options.new
-            prefs = {
-              prompt_for_download: false,
-              directory_upgrade:   true,
-              default_directory:   @downloads_path
-            }
-            options.add_preference(:download, prefs)
-          else
-            options = Selenium::WebDriver::Chrome::Options.new(args: %w[headless disable-gpu no-sandbox])
-          end
+          options = Selenium::WebDriver::Chrome::Options.new
+          prefs = {
+            prompt_for_download: false,
+            directory_upgrade:   true,
+            default_directory:   @downloads_path
+          }
+          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')
+            options.add_argument('--disable-gpu')
+            options.add_argument('--no-sandbox')
+          end
+
           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)
@@ -254,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
 
@@ -266,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']
@@ -340,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']}"}
@@ -368,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
 
@@ -395,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
 
@@ -410,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']
@@ -423,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
@@ -446,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']
@@ -485,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
 
@@ -509,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 })
@@ -523,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
 
@@ -565,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
 
@@ -580,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
 
@@ -613,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