testcentricity_web 4.1.4 → 4.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee1ff6311bce503168094dbc5546d00419187e6991d67073d590d0cf2dd6beac
-  data.tar.gz: 5a776195eb96437187dae63eb12f9e6c1cfe0580811dbc369dc09ac75d76e300
+  metadata.gz: 022bc17f6fc489c52de9a91fdccb61b722db97cb17b2c21951a2650930adeeb8
+  data.tar.gz: cfeefd68b74714b35b738f865b8c5796d4ebe3c302bed0deff208cef34d4f225
 SHA512:
-  metadata.gz: 5c05c61753313054175c4d3ae0a36dabe8fd089a2178918e6d796a26806be5af5d6a5020a55658b1951b4d62adfb63725c610afa4c0b4b4612e6e675de015b62
-  data.tar.gz: 279053b4a2323f9089c183bebf286afb6dbb9be22f9bfee0b22264d2810d1ce77e17b33cec22e26d9b1fd6bdd970c41e2cd1cd1c36a11f010fa0d125fd95e80f
+  metadata.gz: 19bb489e029052084ba7c4d3c29bc7a1a5f483039624048860be14ba75d2e8960667410ac7b838a962eac263cd80bb0bf66e881b592f03ce91bcd3ebd45c2e15
+  data.tar.gz: 2f45f5c2dda5f485a123527c394f5480e91f1bb123c58efe1a7bf56225388bb0cbed82abbf0c01618d6c370ac7cd6b03f350a338025e06da5597b19989e849b2

data/CHANGELOG.md

@@ -2,6 +2,15 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.1.5] - 15-MAR-2022
+
+### Fixed
+* `SelectList.selected?` now correctly returns selected value for custom `selectlist` controls.
+
+### Updated
+* Updated HTML documentation.
+
+
 ## [4.1.4] - 09-MAR-2022
 
 ### Fixed
@@ -19,7 +28,7 @@ All notable changes to this project will be documented in this file.
 
 ## [4.1.2] - 07-MAR-2022
 
-### Changed
+### Updated
 * Updated HTML documentation.
 
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    testcentricity_web (4.1.4)
+    testcentricity_web (4.1.5)
       appium_lib
       browserstack-local
       capybara (>= 3.1, < 4)

data/README.md

@@ -3,9 +3,9 @@
 [![Gem Version](https://badge.fury.io/rb/testcentricity_web.svg)](https://badge.fury.io/rb/testcentricity_web)  [![License (3-Clause BSD)](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg?style=flat-square)](http://opensource.org/licenses/BSD-3-Clause)
 
 
-The TestCentricity™ Web core generic framework for desktop and mobile web browser-based app testing implements a Page Object and Data
-Object Model DSL for use with Cucumber, Capybara (version 3.x), and Selenium-Webdriver (version 4.x). It also facilitates the configuration
-of the appropriate Selenium-Webdriver capabilities required to establish a connection with a local or cloud hosted desktop or mobile web browser.
+The TestCentricity™ Web core generic framework for desktop and mobile web browser-based app testing implements a Page Object Model DSL
+for use with Cucumber, Capybara (version 3.x), and Selenium-Webdriver (version 4.x). It also facilitates the configuration of the appropriate
+Selenium-Webdriver capabilities required to establish a connection with a local or cloud hosted desktop or mobile web browser.
 
 The TestCentricity™ Web gem supports running automated tests against the following web test targets:
 * locally hosted desktop browsers (Chrome, Edge, Firefox, Safari, or IE)
@@ -49,7 +49,7 @@ Or install it yourself as:
 ## Setup
 ### Using Cucumber
 
-If you are using Cucumber, you need to require the following in your *env.rb* file:
+If you are using Cucumber, you need to require the following in your `env.rb` file:
 
     require 'capybara/cucumber'
     require 'testcentricity_web'
@@ -57,7 +57,7 @@ If you are using Cucumber, you need to require the following in your *env.rb* fi
 
 ### Using RSpec
 
-If you are using RSpec instead, you need to require the following in your *env.rb* file:
+If you are using RSpec instead, you need to require the following in your `env.rb` file:
 
     require 'capybara'
     require 'capybara/rspec'
@@ -67,7 +67,7 @@ If you are using RSpec instead, you need to require the following in your *env.r
 ### Using Appium
 
 If you will be running your tests on mobile Safari browsers on simulated iOS devices using Appium and XCode Simulators, you need to require
-the following in your *env.rb* file:
+the following in your `env.rb` file:
 
     require 'appium_capybara'
 
@@ -634,6 +634,8 @@ The `verify_ui_states` method supports the following property/state pairs:
     :class             String
     :value or :caption String
     :attribute         Hash
+    :style             String
+    :tabindex          Integer
 
 **Text Fields:**
 
@@ -646,12 +648,17 @@ The `verify_ui_states` method supports the following property/state pairs:
 
 **Checkboxes:**
 
-    :checked Boolean
+    :checked       Boolean
+    :indeterminate Boolean
 
 **Radio Buttons:**
 
     :selected Boolean
 
+**Links:**
+
+    :href String
+
 **Images**
 
     :loaded Boolean
@@ -671,6 +678,8 @@ The `verify_ui_states` method supports the following property/state pairs:
     :items or :options         Array of Strings
     :itemcount or :optioncount Integer
     :selected                  String
+    :groupcount                Integer
+    :group_headings            Array of Strings
 
 **Tables**
 
@@ -706,8 +715,6 @@ The `verify_ui_states` method supports the following property/state pairs:
 
 The `verify_ui_states` method supports the following ARIA accessibility property/state pairs:
 
-**All Objects:**
-
     :aria_label           String
     :aria_disabled        Boolean
     :aria_labelledby      String
@@ -738,8 +745,10 @@ The `verify_ui_states` method supports the following ARIA accessibility property
     :aria_multiline       Boolean
     :aria_multiselectable Boolean
     :content_editable     Boolean
+    :role                 String
 
 #### Comparison States
+
 The `verify_ui_states` method supports comparison states using property/comparison state pairs:
 
     object => { property: { comparison_state: value } }
@@ -844,6 +853,126 @@ Baseline translation strings are stored in `.yml` files in the `config/locales/`
         └── README.md
 
 
+### Working with custom UIElements
+
+Many responsive and touch-enabled web based user interfaces are implemented using front-end JavaScript libraries for building user
+interfaces based on UI components. Popular JS libraries include React, Angular, and Ember.js. These stylized and adorned controls can
+present a challenge when attempting to interact with them using Capybara and Selenium based automated tests.
+
+#### Radio and Checkbox UIElements
+
+Sometimes, radio buttons and checkboxes implemented using JS component libraries cannot be interacted with due to other UI elements
+being overlaid on top of them and the base `input(type='radio')` or `input(type='checkbox')` element not being visible.
+
+In the screenshots below of an airline flight search and booking page, the **Roundtrip** and **One-way** radio buttons are adorned with
+`label` elements that also acts as proxies for their associated `input(type='radio')` elements, and they intercept the `click` actions
+that would normally be handled by the `input(type='radio')` elements.
+
+<img src="https://i.imgur.com/7bW5u4c.jpg" alt="Roundtrip Radio button Input" title="Roundtrip Radio button Input">
+
+
+This screenshot shows the `label` element that is overlaid above the **Roundtrip** `input(type='radio')` element.
+
+<img src="https://i.imgur.com/2stWiyR.jpg" alt="Roundtrip Radio button Label" title="Roundtrip Radio button Label">
+
+
+The checkbox controls in this web UI are also adorned with `label` elements that act as proxies for their associated `input(type='checkbox')`
+elements.
+
+<img src="https://i.imgur.com/JcOANqZ.jpg" alt="One-way Radio button Label" title="One-way Radio button Label">
+
+
+The `Radio.define_custom_elements` and `CheckBox.define_custom_elements` methods provide a way to specify the `proxy` and/or `label`
+elements associated with the `input(type='radio')` or `input(type='checkbox')` elements. The `define_custom_elements` method
+should be called from an `initialize` method for the `PageObject` or `PageSection` where the `radio` or `checkbox` element is instantiated.
+The code snippet below demonstrates the use of the `Radio.define_custom_elements` and `CheckBox.define_custom_elements` methods to
+resolve the testability issues posed by the adorned **Roundtrip** and **One-way** radio buttons and the **Flexible dates** checkbox.
+
+    class FlightBookingPage < TestCentricity::PageObject
+      trait(:page_name)    { 'Flight Booking Home' }
+      trait(:page_locator) { "div[class*='bookerContainer']" }
+      
+      # Flight Booking page UI elements
+      radios   roundtrip_radio: 'input#roundtrip',
+               one_way_radio:   'input#oneway'
+      checkbox :flexible_check, 'input#flexibleDates'
+      
+      def initialize
+        # define the custom element components for the Round Trip radio button
+        radio_spec = { proxy: "label[for='roundtrip']" }
+        roundtrip_radio.define_custom_elements(radio_spec)
+        # define the custom element components for the One Way radio button
+        radio_spec = { proxy: "label[for='oneway']" }
+        one_way_radio.define_custom_elements(radio_spec)
+        # define the custom element components for the Flexible Date checkbox
+        check_spec = { proxy: 'label#flexDatesLabel' }
+        flexible_check.define_custom_elements(check_spec)
+      end
+    end
+
+
+#### SelectList UIElements
+
+The basic HTML `select` element is typically composed of the parent `select` object, and one or more `option` elements representing
+the selectable items in the drop-down list. However, `select` type controls implemented using JS component libraries can be composed
+of multiple elements representing the various components of a drop-down style `selectlist` implementation.
+
+In the screenshots below of an airline flight search and booking page, there are no `select` or `option` elements associated with the
+**Month**, **Day**, and **Cabin Type** drop-down style selectors. An inspection of the **Month** selector reveals that it is a `div`
+element that contains a `button` element (outlined in red) for triggering the drop-down list, a `ul` element (outlined in green) that
+contains the drop-down list, and multiple `li` elements (outlined in blue) that represent the list items or options that can be
+selected. The currently selected item or option can be identified by either the `listBoxOptionSelected` snippet in its `class` name or
+the `aria-selected` attribute (outlined in orange).
+
+Further examination of the **Day** and **Cabin Type** drop-down style selectors reveal that their composition is identical to the
+**Month** selector.
+
+<img src="https://i.imgur.com/LYAC2lh.jpg" alt="Custom SelectList" title="Custom SelectList">
+
+
+The `SelectList.define_list_elements` method provides a means of specifying the various elements that make up the key components of
+a `selectlist` control. The method accepts a hash of element designators (key) and a CSS or Xpath expression (value) that expression
+that uniquely identifies the element. Valid element designators are `list_item:`, `options_list:`, `list_trigger:`, `selected_item:`,
+`text_field:`, `group_heading:`, and `group_item:`.
+
+The code snippet below demonstrates the use of the `SelectList.define_list_elements` method to define the common components that make
+up the **Month**, **Day**, and **Cabin Type** drop-down style selectors. Note the use of the ARIA `role` and `aria-selected` attributes
+as element locators.
+
+    class FlightBookingPage < TestCentricity::PageObject
+      trait(:page_name)    { 'Flight Booking Home' }
+      trait(:page_locator) { "div[class*='bookerContainer']" }
+      
+      # Flight Booking page UI elements
+      selectlists month_select:      "div[class*='expandFlexMonth']",
+                  duration_select:   "div[class*='expandFlexDay']",
+                  cabin_type_select: "div[class*='bookFlightForm__optionField'] > div[class*='app-components-ListBox']"
+
+      def initialize
+        # define the custom list element components for the Month, Duration, and Cabin Type selectlist objects
+        list_spec = {
+          selected_item: "li[aria-selected=true]",
+          options_list:  "ul[role='listbox']",
+          list_item:     "li[role='option']",
+          list_trigger:  "button[role='combobox']"
+        }
+        month_select.define_list_elements(list_spec)
+        duration_select.define_list_elements(list_spec)
+        cabin_type_select.define_list_elements(list_spec)
+      end
+    end
+
+
+#### List UIElements
+
+The basic HTML list is typically composed of the parent `ul` object, and one or more `li` elements representing the items
+in the list. However, list controls implemented using JS component libraries can be composed of multiple elements representing the
+components of a list implementation.
+
+The `List.define_list_elements` method provides a means of specifying the elements that make up the key components of a `list` control.
+The method accepts a hash of element designators (key) and a CSS or Xpath expression (value) that expression that uniquely identifies
+the element. Valid element designators are `list_item:`and `selected_item:`.
+
 
 ## Instantiating your PageObjects
 
@@ -1220,7 +1349,7 @@ Once your test environment is properly configured, the following **Environment V
 | `WEB_BROWSER`              | Must be set to `appium`                                                                                                                                               |
 | `APP_PLATFORM_NAME`        | Must be set to `iOS`                                                                                                                                                  |
 | `APP_BROWSER`              | Must be set to `Safari`                                                                                                                                               |
-| `APP_VERSION`              | Must be set to `15.2`, `14.5`, or which ever iOS version you wish to run within the XCode Simulator                                                                   |
+| `APP_VERSION`              | Must be set to `15.4`, `14.5`, or which ever iOS version you wish to run within the XCode Simulator                                                                   |
 | `APP_DEVICE`               | Set to iOS device name supported by the iOS Simulator (`iPhone 13 Pro Max`, `iPad Pro (12.9-inch) (5th generation)`, etc.) or name of physically connected iOS device |
 | `DEVICE_TYPE`              | Must be set to `phone` or `tablet`                                                                                                                                    |
 | `APP_UDID`                 | UDID of physically connected iOS device (not used for simulators)                                                                                                     |
@@ -1302,6 +1431,13 @@ the code shown below in your `hooks.rb` file.
     end
 
 
+The `APPIUM_SERVER` environment variable must be set to `run` in order to programmatically start and stop Appium server. This can be
+set by adding the following to your `cucumber.yml` file and including `-p run_appium` in your command line when starting your Cucumber
+test suite(s):
+
+    run_appium: APPIUM_SERVER=run
+
+
 Refer to **section 8.6 (Using Browser specific Profiles in cucumber.yml)** below.
 
 
@@ -1548,9 +1684,10 @@ that you intend to connect with.
     #==============
 
     appium_ios: WEB_BROWSER=appium AUTOMATION_ENGINE=XCUITest APP_PLATFORM_NAME="ios" APP_BROWSER="Safari" NEW_COMMAND_TIMEOUT=30 SHOW_SIM_KEYBOARD=false
-    app_ios_15: --profile appium_ios APP_VERSION="15.2"
-    ipad_pro_12_9_15_sim: --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (12.9-inch) (5th generation)" <%= desktop %>
-    ipad_air_15_sim: --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad Air (4th generation)" <%= desktop %>
+    app_ios_15: --profile appium_ios APP_VERSION="15.4"
+    ipad_pro_12_15_sim: --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad Pro (12.9-inch) (5th generation)"
+    ipad_air_15_sim:    --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad Air (5th generation)" <%= desktop %>
+    ipad_15_sim:        --profile app_ios_15 DEVICE_TYPE=tablet APP_DEVICE="iPad (9th generation)"
 
 
     #==============
@@ -1686,13 +1823,13 @@ in landscape orientation:
 The following command specifies that Cucumber will run tests against an iPad Pro (12.9-inch) (5th generation) with iOS version 15.2 in an
 XCode Simulator in landscape orientation:
     
-    cucumber -p ipad_pro_12_9_15_sim -p landscape
+    cucumber -p ipad_pro_12_15_sim -p landscape
     
     NOTE:  Appium must be running prior to executing this command
 
 You can ensure that Appium Server is running by including `-p run_appium` in your command line:
 
-    cucumber -p ipad_pro_12_9_15_sim -p landscape -p run_appium
+    cucumber -p ipad_pro_12_15_sim -p landscape -p run_appium
 
 
 The following command specifies that Cucumber will run tests against a remotely hosted Safari web browser running on a macOS Monterey

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '4.1.4'
+  VERSION = '4.1.5'
 end

data/lib/testcentricity_web/web_core/webdriver_helper.rb

@@ -49,7 +49,7 @@ module TestCentricity
       context = case browser.downcase.to_sym
                 when :appium
                   initialize_appium
-                  'mobile device emulator'
+                  'Appium'
                 when :browserstack
                   initialize_browserstack
                   'Browserstack cloud service'
@@ -138,7 +138,6 @@ module TestCentricity
       Environ.device_orientation = ENV['ORIENTATION'] if ENV['ORIENTATION']
       Capybara.default_driver = :appium
       Environ.driver = :appium
-      @endpoint = 'http://localhost:4723/wd/hub' if @endpoint.nil?
       desired_capabilities = {
           platformName:    Environ.device_os,
           platformVersion: Environ.device_os_version,
@@ -190,14 +189,13 @@ module TestCentricity
         desired_capabilities[:systemPort]   = ENV['SYSTEM_PORT'] if ENV['SYSTEM_PORT']
       end
 
-      unless @capabilities.nil?
-        desired_capabilities = @capabilities
-      end
+      desired_capabilities = @capabilities unless @capabilities.nil?
+      # specify endpoint url
+      @endpoint = 'http://localhost:4723/wd/hub' if @endpoint.nil?
 
-      Capybara.register_driver :appium do |app|
-        appium_lib_options = { server_url: @endpoint }
+      Capybara.register_driver(:appium) do |app|
         all_options = {
-          appium_lib: appium_lib_options,
+          appium_lib: { server_url: @endpoint },
           caps:       desired_capabilities
         }
         Appium::Capybara::Driver.new(app, all_options)
@@ -233,63 +231,18 @@ module TestCentricity
         when :safari, :ie
           Capybara::Selenium::Driver.new(app, browser: browser)
         when :firefox, :firefox_headless
-          profile = Selenium::WebDriver::Firefox::Profile.new
-          profile['browser.download.dir'] = @downloads_path
-          profile['browser.download.folderList'] = 2
-          profile['browser.download.manager.showWhenStarting'] = false
-          profile['browser.download.manager.closeWhenDone'] = true
-          profile['browser.download.manager.showAlertOnComplete'] = false
-          profile['browser.download.manager.alertOnEXEOpen'] = false
-          profile['browser.download.manager.useWindow'] = false
-          profile['browser.helperApps.alwaysAsk.force'] = false
-          profile['pdfjs.disabled'] = true
-
-          mime_types = ENV['MIME_TYPES'] || 'images/jpeg, application/pdf, application/octet-stream'
-          profile['browser.helperApps.neverAsk.saveToDisk'] = mime_types
-
-          profile['intl.accept_languages'] = ENV['LOCALE'] if ENV['LOCALE']
-          options = Selenium::WebDriver::Firefox::Options.new(profile: profile)
-          options.args << '--headless' if browser == :firefox_headless
+          options = firefox_options(browser)
           Capybara::Selenium::Driver.new(app, browser: :firefox, capabilities: [options])
         when :chrome, :chrome_headless
-          options = Selenium::WebDriver::Chrome::Options.new(options: {'excludeSwitches' => ['enable-automation']})
-          prefs = {
-            prompt_for_download: false,
-            directory_upgrade:   true,
-            default_directory:   @downloads_path
-          }
-          options.add_preference(:download, prefs)
-          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
-
+          options = chrome_edge_options(browser)
           Capybara::Selenium::Driver.new(app, browser: :chrome, capabilities: [options])
         when :edge, :edge_headless
-          options = Selenium::WebDriver::Edge::Options.new(options: {'excludeSwitches' => ['enable-automation']})
-          prefs = {
-            prompt_for_download: false,
-            directory_upgrade:   true,
-            default_directory:   @downloads_path
-          }
-          options.add_preference(:download, prefs)
-          options.add_argument('--disable-dev-shm-usage')
-          options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
-          if browser == :edge_headless
-            options.add_argument('--headless')
-            options.add_argument('--disable-gpu')
-            options.add_argument('--no-sandbox')
-          end
-
+          options = chrome_edge_options(browser)
           Capybara::Selenium::Driver.new(app, browser: :edge, capabilities: [options])
         else
           if ENV['HOST_BROWSER'] && ENV['HOST_BROWSER'].downcase.to_sym == :chrome
             user_agent = Browsers.mobile_device_agent(ENV['WEB_BROWSER'])
             options = Selenium::WebDriver::Chrome::Options.new(options: {'excludeSwitches' => ['enable-automation']})
-            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']
@@ -452,74 +405,31 @@ module TestCentricity
       Environ.grid = :selenium_grid
       browser  = ENV['WEB_BROWSER'].downcase.to_sym
       @endpoint = ENV['REMOTE_ENDPOINT'] || 'http://127.0.0.1:4444/wd/hub' if @endpoint.nil?
-      Capybara.register_driver :remote_browser do |app|
-        case browser
-        when :safari
-          options = Selenium::WebDriver::Safari::Options.new
-        when :ie
-          options = Selenium::WebDriver::IE::Options.new
-        when :firefox, :firefox_headless
-          profile = Selenium::WebDriver::Firefox::Profile.new
-          profile['browser.download.dir'] = @downloads_path
-          profile['browser.download.folderList'] = 2
-          profile['browser.download.manager.showWhenStarting'] = false
-          profile['browser.download.manager.closeWhenDone'] = true
-          profile['browser.download.manager.showAlertOnComplete'] = false
-          profile['browser.download.manager.alertOnEXEOpen'] = false
-          profile['browser.download.manager.useWindow'] = false
-          profile['browser.helperApps.alwaysAsk.force'] = false
-          profile['pdfjs.disabled'] = true
-
-          mime_types = ENV['MIME_TYPES'] || 'images/jpeg, application/pdf, application/octet-stream'
-          profile['browser.helperApps.neverAsk.saveToDisk'] = mime_types
-
-          profile['intl.accept_languages'] = ENV['LOCALE'] if ENV['LOCALE']
-          options = Selenium::WebDriver::Firefox::Options.new(profile: profile)
-          options.args << '--headless' if browser == :firefox_headless
-        when :chrome, :chrome_headless
+
+      case browser
+      when :safari
+        options = Selenium::WebDriver::Safari::Options.new
+      when :ie
+        options = Selenium::WebDriver::IE::Options.new
+      when :firefox, :firefox_headless
+        options = firefox_options(browser)
+      when :chrome, :chrome_headless, :edge, :edge_headless
+        options = chrome_edge_options(browser)
+      else
+        if ENV['HOST_BROWSER'] && ENV['HOST_BROWSER'].downcase.to_sym == :chrome
+          Environ.platform = :mobile
+          Environ.device_name = Browsers.mobile_device_name(ENV['WEB_BROWSER'])
+          user_agent = Browsers.mobile_device_agent(ENV['WEB_BROWSER'])
           options = Selenium::WebDriver::Chrome::Options.new(options: {'excludeSwitches' => ['enable-automation']})
-          prefs = {
-            prompt_for_download: false,
-            directory_upgrade:   true,
-            default_directory:   @downloads_path
-          }
-          options.add_preference(:download, prefs)
-          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
-        when :edge, :edge_headless
-          options = Selenium::WebDriver::Edge::Options.new(options: {'excludeSwitches' => ['enable-automation']})
-          prefs = {
-            prompt_for_download: false,
-            directory_upgrade:   true,
-            default_directory:   @downloads_path
-          }
-          options.add_preference(:download, prefs)
           options.add_argument('--disable-dev-shm-usage')
+          options.add_argument("--user-agent='#{user_agent}'")
           options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
-          if browser == :edge_headless
-            options.add_argument('--headless')
-            options.add_argument('--disable-gpu')
-            options.add_argument('--no-sandbox')
-          end
         else
-          if ENV['HOST_BROWSER'] && ENV['HOST_BROWSER'].downcase.to_sym == :chrome
-            Environ.platform = :mobile
-            Environ.device_name = Browsers.mobile_device_name(ENV['WEB_BROWSER'])
-            user_agent = Browsers.mobile_device_agent(ENV['WEB_BROWSER'])
-            options = Selenium::WebDriver::Chrome::Options.new(options: {'excludeSwitches' => ['enable-automation']})
-            options.add_argument('--disable-infobars')
-            options.add_argument('--disable-dev-shm-usage')
-            options.add_argument("--user-agent='#{user_agent}'")
-            options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
-          else
-            raise "Requested browser '#{browser}' is not supported on Selenium Grid"
-          end
+          raise "Requested browser '#{browser}' is not supported on Selenium Grid"
         end
+      end
+
+      Capybara.register_driver :remote_browser do |app|
         Capybara::Selenium::Driver.new(app,
                                        browser: :remote,
                                        url: @endpoint,
@@ -645,6 +555,50 @@ module TestCentricity
       config_file_uploads unless ENV['TB_PLATFORM']
     end
 
+    def self.chrome_edge_options(browser)
+      options = case browser
+                when :chrome, :chrome_headless
+                  Selenium::WebDriver::Chrome::Options.new(options: {'excludeSwitches' => ['enable-automation']})
+                when :edge, :edge_headless
+                  Selenium::WebDriver::Edge::Options.new(options: {'excludeSwitches' => ['enable-automation']})
+                end
+      prefs = {
+        prompt_for_download: false,
+        directory_upgrade:   true,
+        default_directory:   @downloads_path
+      }
+      options.add_preference(:download, prefs)
+      options.add_argument('--disable-dev-shm-usage')
+      options.add_argument("--lang=#{ENV['LOCALE']}") if ENV['LOCALE']
+      if browser == :chrome_headless || browser == :edge_headless
+        options.add_argument('--headless')
+        options.add_argument('--disable-gpu')
+        options.add_argument('--no-sandbox')
+      end
+      options
+    end
+
+    def self.firefox_options(browser)
+      profile = Selenium::WebDriver::Firefox::Profile.new
+      profile['browser.download.dir'] = @downloads_path
+      profile['browser.download.folderList'] = 2
+      profile['browser.download.manager.showWhenStarting'] = false
+      profile['browser.download.manager.closeWhenDone'] = true
+      profile['browser.download.manager.showAlertOnComplete'] = false
+      profile['browser.download.manager.alertOnEXEOpen'] = false
+      profile['browser.download.manager.useWindow'] = false
+      profile['browser.helperApps.alwaysAsk.force'] = false
+      profile['pdfjs.disabled'] = true
+
+      mime_types = ENV['MIME_TYPES'] || 'images/jpeg, application/pdf, application/octet-stream'
+      profile['browser.helperApps.neverAsk.saveToDisk'] = mime_types
+
+      profile['intl.accept_languages'] = ENV['LOCALE'] if ENV['LOCALE']
+      options = Selenium::WebDriver::Firefox::Options.new(profile: profile)
+      options.args << '--headless' if browser == :firefox_headless
+      options
+    end
+
     def self.test_context_message
       context_message = if ENV['TEST_CONTEXT']
                           "#{Environ.test_environment.to_s.upcase} - #{ENV['TEST_CONTEXT']}"
@@ -662,7 +616,10 @@ module TestCentricity
     def self.register_remote_driver(driver, browser, options)
       Capybara.register_driver driver do |app|
         capabilities = Selenium::WebDriver::Remote::Capabilities.send(browser.gsub(/\s+/, '_').downcase.to_sym, options)
-        Capybara::Selenium::Driver.new(app, browser: :remote, url: @endpoint, capabilities: capabilities)
+        Capybara::Selenium::Driver.new(app,
+                                       browser: :remote,
+                                       url: @endpoint,
+                                       capabilities: capabilities)
       end
 
       Environ.browser = browser

data/lib/testcentricity_web/web_elements/select_list.rb

@@ -246,13 +246,16 @@ module TestCentricity
     def get_selected_option
       @base_object, = find_element
       object_not_found_exception(@base_object, nil)
-      if @base_object.first(:css, @list_item, minimum: 0)
-        @base_object.first(:css, @selected_item).text
-      elsif @base_object.first(:css, @selected_item, minimum: 0)
-        @base_object.first(:css, @selected_item).text
-      else
-        @base_object.first('option[selected]', visible: :all).text
-      end
+      trigger_list
+      selection = if @base_object.first(:css, @list_item, minimum: 0, wait: 1, visible: :all)
+                    @base_object.first(:css, @selected_item, wait: 1, visible: :all).text
+                  elsif @base_object.first(:css, @selected_item, minimum: 0, wait: 1, visible: :all)
+                    @base_object.first(:css, @selected_item, visible: :all).text
+                  else
+                    @base_object.first('option[selected]', visible: :all).text
+                  end
+      trigger_list
+      selection
     end
 
     alias selected? get_selected_option

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 4.1.4
+  version: 4.1.5
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-03-09 00:00:00.000000000 Z
+date: 2022-03-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler