testcentricity_web 3.2.23 → 4.0.1

data/lib/testcentricity_web/data_objects/environment.rb

@@ -1,21 +1,45 @@
 module TestCentricity
   class EnvironData < TestCentricity::ExcelDataSource
     attr_accessor	:current
+    attr_accessor	:generic_data
+    attr_accessor	:environ_specific_data
 
-    WKS_ENVIRONS ||= 'Environments'
-
-    def find_environ(environ_name, source_type = :excel)
+    def self.find_environ(environ_name, source_type = :excel)
       data = case source_type
              when :excel
-               ExcelData.read_row_data(XL_PRIMARY_DATA_FILE, WKS_ENVIRONS, environ_name)
+               ExcelData.read_row_data(XL_PRIMARY_DATA_FILE, 'Environments', environ_name)
              when :yaml
-               read_yaml_node_data('environments.yml', environ_name)
+               # read generic test data from data.yml file
+               @generic_data ||= YAML.load_file(YML_PRIMARY_DATA_FILE)
+               # read environment specific test data
+               data_file = "#{PRIMARY_DATA_PATH}#{environ_name}_data.yml"
+               @environ_specific_data ||= YAML.load_file(data_file)
+
+               read('Environments', environ_name)
              when :json
                read_json_node_data('environments.json', environ_name)
              end
       @current = Environ.new(data)
       Environ.current = @current
     end
+
+    def self.read(key_name, node_name)
+      if @environ_specific_data.key?(key_name) && @environ_specific_data[key_name].key?(node_name)
+        node_data = @environ_specific_data[key_name][node_name]
+      else
+        raise "No key named #{key_name} in generic and environment-specific data" unless @generic_data.key?(key_name)
+        raise "No node named #{node_name} in #{key_name} section of generic and environment-specific data" unless @generic_data[key_name].key?(node_name)
+
+        node_data = @generic_data[key_name][node_name]
+      end
+
+      if node_data.is_a?(Hash)
+        node_data.each do |key, value|
+          node_data[key] = calculate_dynamic_value(value) if value.to_s.start_with?('eval!')
+        end
+      end
+      node_data
+    end
   end
 
 
@@ -36,11 +60,14 @@ module TestCentricity
     attr_accessor :device_name
     attr_accessor :device_type
     attr_accessor :device_os
+    attr_accessor :device_os_version
     attr_accessor :device_orientation
     attr_accessor :platform
     attr_accessor :driver
     attr_accessor :grid
     attr_accessor :tunneling
+    attr_accessor :locale
+    attr_accessor :language
 
     attr_accessor :parallel
     attr_accessor :process_num
@@ -58,8 +85,12 @@ module TestCentricity
     attr_accessor :user_id
     attr_accessor :password
     attr_accessor :append
+    attr_accessor :app_id
+    attr_accessor :api_key
     attr_accessor :option1
     attr_accessor :option2
+    attr_accessor :option3
+    attr_accessor :option4
     attr_accessor :dns
     attr_accessor :db_username
     attr_accessor :db_password
@@ -71,12 +102,18 @@ module TestCentricity
       @user_id	     = data['USER_ID']
       @password	     = data['PASSWORD']
       @append	       = data['APPEND']
+      @app_id 	     = data['APP_ID']
+      @api_key	     = data['API_KEY']
       @option1	     = data['OPTIONAL_1']
       @option2	     = data['OPTIONAL_2']
+      @option3	     = data['OPTIONAL_3']
+      @option4	     = data['OPTIONAL_4']
       @dns	         = data['DNS']
       @db_username   = data['DB_USERNAME']
       @db_password   = data['DB_PASSWORD']
       @a11y_standard = ENV['ACCESSIBILITY_STANDARD'] || 'best-practice'
+      @locale        = ENV['LOCALE'] || 'en'
+      @language      = ENV['LANGUAGE'] || 'English'
 
       super
     end
@@ -205,6 +242,14 @@ module TestCentricity
       @device_os
     end
 
+    def self.device_os_version=(version)
+      @device_os_version = version
+    end
+
+    def self.device_os_version
+      @device_os_version
+    end
+
     def self.is_ios?
       @device_os == :ios
     end
@@ -245,6 +290,22 @@ module TestCentricity
       @tunneling
     end
 
+    def self.language=(language)
+      @language = language
+    end
+
+    def self.language
+      @language
+    end
+
+    def self.locale=(locale)
+      @locale = locale
+    end
+
+    def self.locale
+      @locale
+    end
+
     def self.platform=(platform)
       @platform = platform
     end
@@ -305,16 +366,17 @@ module TestCentricity
       report_header = "\n<b><u>TEST ENVIRONMENT</u>:</b> #{ENV['TEST_ENVIRONMENT']}\n"\
       "  <b>Browser:</b>\t #{Environ.browser.capitalize}\n"
       report_header = "#{report_header}  <b>Device:</b>\t\t #{Environ.device_name}\n" if Environ.device_name
-      report_header = "#{report_header}  <b>Device OS:</b>\t #{Environ.device_os}\n" if Environ.device_os
+      report_header = "#{report_header}  <b>Device OS:</b>\t #{Environ.device_os} #{Environ.device_os_version}\n" if Environ.device_os
       report_header = "#{report_header}  <b>Device type:</b>\t #{Environ.device_type}\n" if Environ.device_type
       report_header = "#{report_header}  <b>Driver:</b>\t\t #{Environ.driver}\n" if Environ.driver
       report_header = "#{report_header}  <b>Grid:</b>\t\t #{Environ.grid}\n" if Environ.grid
       report_header = "#{report_header}  <b>OS:</b>\t\t\t #{Environ.os}\n" if Environ.os
-      report_header = "#{report_header}  <b>Locale:</b>\t\t #{ENV['LOCALE']}\n" if ENV['LOCALE']
-      report_header = "#{report_header}  <b>Language:</b>\t #{ENV['LANGUAGE']}\n" if ENV['LANGUAGE']
+      report_header = "#{report_header}  <b>Locale:</b>\t\t #{Environ.locale}\n" if Environ.locale
+      report_header = "#{report_header}  <b>Language:</b>\t #{Environ.language}\n" if Environ.language
       report_header = "#{report_header}  <b>Country:</b>\t #{ENV['COUNTRY']}\n" if ENV['COUNTRY']
       report_header = "#{report_header}  <b>WCAG Accessibility Standard:</b>\t #{ENV['ACCESSIBILITY_STANDARD']}\n" if ENV['ACCESSIBILITY_STANDARD']
       "#{report_header}\n\n"
     end
   end
 end
+

data/lib/testcentricity_web/data_objects/excel_helper.rb

@@ -1,6 +1,3 @@
-require 'time'
-require 'chronic'
-require 'faker'
 require 'spreadsheet'
 
 
@@ -273,27 +270,6 @@ module TestCentricity
       # rename new Excel document, replacing the original
       File.rename(outfile, file)
     end
-
-    private
-
-    def self.calculate_dynamic_value(value)
-      test_value = value.split('!', 2)
-      parameter = test_value[1].split('.', 2)
-      case parameter[0]
-      when 'Date'
-        result = eval("Chronic.parse('#{parameter[1]}')")
-      when 'FormattedDate', 'FormatDate'
-        date_time_params = parameter[1].split(' format! ', 2)
-        date_time = eval("Chronic.parse('#{date_time_params[0].strip}')")
-        result = date_time.to_s.format_date_time("#{date_time_params[1].strip}")
-      else
-        result = if Faker.constants.include?(parameter[0].to_sym)
-                   eval("Faker::#{parameter[0]}.#{parameter[1]}")
-                 else
-                   eval(test_value[1])
-                 end
-      end
-      result.to_s
-    end
   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.23'
+  VERSION = '4.0.1'
 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