testcentricity_web 4.1.6 → 4.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 98ea25aaf7cff4f07b966b6cac829a2cd6ad3234403e3a01257ff6dd07beaf38
-  data.tar.gz: 20082c59c2d9f7c5e69959500b4bc97e10f1dc93309f1ec601acdf7b0cf8d29c
+  metadata.gz: c35f1c09951d1a58be2d3bac921d2d221311edf3b4464c5d4806c7a30a57c0f2
+  data.tar.gz: bbe72af137b6808721f7a87b26032c42d78bbf4708ff88ed34c753ebcec85c46
 SHA512:
-  metadata.gz: 40ccfaa119abc07f1bb3254cf05e2c3b5d28548b92c65da43faabc3b524af4b074973767e79da7901de09a609ee95af65e3525ea60b49dd3676b88a6956e7478
-  data.tar.gz: 1959d24e265fdbb21e088f4192b0de5a86f227d22b0b73870a0ab2ed12430d2b898718d2fcbb4b4330f8ec689bef770d09b3cefa39ec0a0cb75b8ab624078abb
+  metadata.gz: 0607f397cd9d6564623218d3e88f541a04f17c9b4b8cc96eb50571bc787cfa46927651dc38cfc7765129dd33303fbd3c130720dc809940cf401a336756c3d7c1
+  data.tar.gz: 11cc150624658854f69575361345dca970a3cf567e1b29e6797450dc22df88f53b069374a63ab8e12f83e7638a28386b0edd0d96e6707720f41e1e6fa621c1f5

data/.gitignore

@@ -15,6 +15,7 @@ Thumbs.db
 /pkg/
 /spec/reports/
 /tmp/
+Gemfile*.lock
 
 # rspec failure tracking
 .rspec_status

data/.rspec

@@ -1,3 +1,4 @@
---format documentation
+# General configuration options
 --color
 --require spec_helper
+--format documentation

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.7.5

data/.simplecov

@@ -2,4 +2,8 @@
 
 require 'simplecov'
 
-SimpleCov.start
+SimpleCov.start do
+  add_filter '/features/'
+  add_filter '/spec/'
+  merge_timeout 3600
+end

data/CHANGELOG.md

@@ -2,6 +2,49 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.1.9] - 18-APR-2022
+
+### Fixed
+* `PageSection.radio` no longer returns `wrong number of arguments` error.
+* `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods no longer skip setting checkboxes or
+radio buttons to the unchecked state.
+
+### Added
+
+* `CheckBox.define_custom_elements` and `Radio.define_custom_elements` methods now support specifying a child `input` component
+contained by a top level `label` element.
+
+
+## [4.1.8] - 31-MAR-2022
+
+### Fixed
+* `Image.loaded?` now correctly returns a `Boolean` value instead of a `String`.
+* `Video.video_height` and `Video.video_width` now correctly returns an `Integer` value instead of a `String`.
+* `UIElement.scroll_to` now works for all supported browsers.
+
+### Changed
+* `UIElement.crossorigin` is no longer limited to `Audio` and `Video` objects.
+
+
+## [4.1.7] - 28-MAR-2022
+
+### Fixed
+* `CheckBox.set_checkbox_state` and `Radio.set_selected_state` work on iOS simulators again.
+
+### Changed
+* `Audio.playback_rate` and `Video.playback_rate` now return value as a `Float` instead of a `String`.
+* `Audio.default_playback_rate` and `Video.default_playback_rate` now return value as a `Float` instead of a `String`.
+* `Audio.current_time` and `Video.current_time` now return value as a `Float` rounded to two decimal places.
+* `Audio.duration` and `Video.duration` now return value as a `Float` rounded to two decimal places.
+
+### Added
+* `Audio.mute` and `Video.mute` methods added.
+* `Audio.unmute` and `Video.unmute` methods added.
+* `Audio.playback_rate` and `Video.playback_rate` now accept a `Float` value as an input for setting the playback rate
+  of media.
+* `Audio.volume` and `Video.volume` now accept a `Float` value between 0 and 1 as an input for setting the volume of media.
+
+
 ## [4.1.6] - 21-MAR-2022
 
 ### Fixed

data/README.md

@@ -505,6 +505,7 @@ With TestCentricity, all UI elements are based on the `UIElement` class, and inh
     element.focused?
     element.required?
     element.content_editable?
+    element.crossorigin
     element.get_value
     element.count
     element.style
@@ -629,6 +630,7 @@ The `verify_ui_states` method supports the following property/state pairs:
     :visible           Boolean
     :hidden            Boolean
     :displayed         Boolean
+    :obscured          Boolean
     :width             Integer
     :height            Integer
     :x                 Integer
@@ -639,6 +641,7 @@ The `verify_ui_states` method supports the following property/state pairs:
     :style             String
     :tabindex          Integer
     :required          Boolean
+    :crossorigin       String
 
 **Pages:**
 
@@ -715,7 +718,6 @@ The `verify_ui_states` method supports the following property/state pairs:
     :playback_rate         Float
     :ready_state           Integer
     :volume                Float
-    :crossorigin           String
     :preload               String
     :poster                String
 
@@ -872,7 +874,7 @@ present a challenge when attempting to interact with them using Capybara and Sel
 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
+In the screenshots below of an airline flight search and booking page, the **Roundtrip** and **One-way** radio buttons are adorned by
 `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.
 
@@ -890,27 +892,26 @@ 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.
+The `Radio.define_custom_elements` and `CheckBox.define_custom_elements` methods provide a way to specify the `input`, `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'
+      radios   roundtrip_radio: "label[for='roundtrip']",
+               one_way_radio:   "label[for='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']" }
+        # define the custom element components for the Round Trip and One Way radio buttons
+        radio_spec = { input: "input[type='radio']" }
         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' }

data/Rakefile

@@ -1,37 +1,115 @@
 require 'rubygems'
 require 'cucumber'
 require 'cucumber/rake/task'
+require 'docker/compose'
+require 'parallel_tests'
 require 'rake'
+require 'rspec/core/rake_task'
+require 'simplecov'
+require 'yard'
 
 
-namespace :features do
-  Cucumber::Rake::Task.new(:edge) do |t|
-    t.profile = 'edge'
-  end
+desc 'Run required specs'
+RSpec::Core::RakeTask.new(:required_specs) do |t|
+  t.rspec_opts = '--tag required'
+end
 
-  Cucumber::Rake::Task.new(:chrome) do |t|
-    t.profile = 'chrome'
-  end
 
-  Cucumber::Rake::Task.new(:edge_headless) do |t|
-    t.profile = 'edge_headless'
-  end
+desc 'Run grid WebDriver specs'
+RSpec::Core::RakeTask.new(:grid_specs) do |t|
+  t.rspec_opts = '--tag grid'
+end
 
-  Cucumber::Rake::Task.new(:chrome_headless) do |t|
-    t.profile = 'chrome_headless'
-  end
 
-  Cucumber::Rake::Task.new(:safari) do |t|
-    t.profile = 'safari'
-  end
+desc 'Run mobile WebDriver specs'
+RSpec::Core::RakeTask.new(:mobile_specs) do |t|
+  t.rspec_opts = '--tag mobile'
+end
 
-  Cucumber::Rake::Task.new(:firefox) do |t|
-    t.profile = 'firefox'
+
+desc 'Run Cucumber features on local Safari browser'
+Cucumber::Rake::Task.new(:safari_local) do |t|
+  t.profile = 'safari_local'
+end
+
+
+desc 'Run Cucumber features on iOS simulator'
+Cucumber::Rake::Task.new(:ios_remote) do |t|
+  t.profile = 'ios_remote'
+end
+
+
+desc 'Run required Cucumber features on local web browsers'
+task :required_cukes do
+  %w[chrome_local chrome_headless firefox_local firefox_headless edge_local edge_headless ipad_pro_12_local].each do |profile|
+    system "parallel_cucumber features/ -o '-p #{profile}' -n 6 --group-by scenarios"
   end
+end
+
 
-  Cucumber::Rake::Task.new(:firefox_headless) do |t|
-    t.profile = 'firefox_headless'
+desc 'Run grid Cucumber features on Dockerized Selenium 4 Grid'
+task :grid_cukes do
+  # start up Selenium 4 Grid
+  compose = Docker::Compose.new
+  compose.version
+  compose.up(detached: true)
+  # run grid features
+  %w[chrome_grid firefox_grid edge_grid ipad_pro_12_grid].each do |profile|
+    system "parallel_cucumber features/ -o '-p #{profile}' -n 4 --group-by scenarios"
   end
+  # shut down Selenium Grid
+  compose.down(remove_volumes: true)
+end
+
 
-  task :all => [:edge, :edge_headless, :chrome, :chrome_headless, :safari]
+desc 'Run grid specs on Dockerized Selenium 4 Grid'
+task :docker_grid_specs do
+  # start up Selenium 4 Grid
+  compose = Docker::Compose.new
+  compose.version
+  compose.up(detached: true)
+  # run grid specs
+  Rake::Task[:grid_specs].invoke
+  # shut down Selenium Grid
+  compose.down(remove_volumes: true)
 end
+
+
+desc 'Run mobile web specs and Cucumber features'
+task mobile: [:mobile_specs, :ios_remote]
+
+
+desc 'Run required specs and Cucumber features'
+task required: [:required_specs, :required_cukes]
+
+
+desc 'Run grid specs and Cucumber features on Dockerized Selenium 4 Grid'
+task grid: [:docker_grid_specs, :grid_cukes]
+
+
+desc 'Run all specs'
+task all_specs: [:required_specs, :docker_grid_specs, :mobile_specs]
+
+
+desc 'Run all specs and Cucumber features'
+task all: [:required, :safari_local, :grid, :mobile]
+
+
+desc 'Update HTML docs'
+YARD::Rake::YardocTask.new(:docs) do |t|
+  t.files = ['lib/**/*.rb']
+end
+
+
+desc 'Build and release new version'
+task :release do
+  version = TestCentricityWeb::VERSION
+  puts "Releasing #{version}, y/n?"
+  exit(1) unless $stdin.gets.chomp == 'y'
+  sh 'gem build testcentricity_web.gemspec && ' \
+     "gem push testcentricity_web-#{version}.gem"
+end
+
+
+desc 'Update docs, build gem, and push to RubyGems'
+task ship_it: [:docs, :release]

data/config/cucumber.yml

@@ -1,6 +1,5 @@
 <% desktop = "--require features BROWSER_TILE=true BROWSER_SIZE=1300,1000 --publish-quiet" %>
-<% tablet  = "--tags @desktop --require features BROWSER_TILE=true --publish-quiet" %>
-<% mobile    = "--tags @mobile  --require features BROWSER_TILE=true --publish-quiet" %>
+<% mobile  = "--require features BROWSER_TILE=true --publish-quiet" %>
 <% reports = "--require features --format pretty --format html --out reports/test_results.html --format junit --out reports --format json --out reports/test_results.json" %>
 
 
@@ -25,20 +24,29 @@ parallel: PARALLEL=true REPORTING=true --require features --format pretty --form
 # profiles for locally hosted desktop web browsers
 #==============
 
-chrome:  WEB_BROWSER=chrome <%= desktop %>
+local:   TEST_ENVIRONMENT=LOCAL
+chrome:  WEB_BROWSER=chrome DATA_SOURCE=yaml <%= desktop %>
+edge:    WEB_BROWSER=edge DATA_SOURCE=json <%= desktop %>
+safari:  WEB_BROWSER=safari DATA_SOURCE=Excel <%= desktop %>
 firefox: WEB_BROWSER=firefox <%= desktop %>
-edge:    WEB_BROWSER=edge <%= desktop %>
-safari:  WEB_BROWSER=safari <%= desktop %>
 
-firefox_headless: WEB_BROWSER=firefox_headless <%= desktop %>
-chrome_headless:  WEB_BROWSER=chrome_headless <%= desktop %>
-edge_headless:    WEB_BROWSER=edge_headless <%= desktop %>
+chrome_local:  --profile local --profile chrome
+edge_local:    --profile local --profile edge
+safari_local:  --profile local --profile safari
+firefox_local: --profile local --profile firefox
+
+firefox_headless: --profile local WEB_BROWSER=firefox_headless <%= desktop %>
+chrome_headless:  --profile local WEB_BROWSER=chrome_headless <%= desktop %>
+edge_headless:    --profile local WEB_BROWSER=edge_headless <%= desktop %>
 
 
 #==============
 # profile for Selenium Grid and Dockerized Selenium Grid hosted desktop web browsers
 #==============
-grid: SELENIUM=remote REMOTE_ENDPOINT="http://localhost:4444/wd/hub"
+grid:         SELENIUM=remote TEST_ENVIRONMENT=REMOTE REMOTE_ENDPOINT="http://localhost:4444/wd/hub"
+chrome_grid:  --profile grid --profile chrome
+edge_grid:    --profile grid --profile edge
+firefox_grid: --profile grid --profile firefox
 
 
 #==============
@@ -49,6 +57,15 @@ landscape: ORIENTATION=landscape
 portrait:  ORIENTATION=portrait
 
 
+#==============
+# profiles for locally hosted mobile web browsers (emulated locally in Chrome browser)
+#==============
+
+ipad_pro_11_local: --profile local WEB_BROWSER=ipad_pro_11 HOST_BROWSER=chrome --profile portrait <%= mobile %>
+ipad_pro_12_local: --profile local WEB_BROWSER=ipad_pro_12_9 HOST_BROWSER=chrome --profile portrait <%= mobile %>
+ipad_pro_12_grid: --profile grid WEB_BROWSER=ipad_pro_12_9 HOST_BROWSER=chrome --profile portrait <%= mobile %>
+
+
 #==============
 # profile to start Appium Server prior to running mobile browser tests on iOS or Android simulators or physical devices
 #==============
@@ -60,22 +77,26 @@ run_appium: APPIUM_SERVER=run
 # NOTE: Requires installation of XCode, iOS version specific target simulators, Appium, and the appium_capybara gem
 #==============
 
-appium_ios: WEB_BROWSER=appium AUTOMATION_ENGINE=XCUITest APP_PLATFORM_NAME="ios" APP_BROWSER="Safari" NEW_COMMAND_TIMEOUT=30 SHOW_SIM_KEYBOARD=false <%= desktop %>
+appium_ios: WEB_BROWSER=appium AUTOMATION_ENGINE=XCUITest APP_PLATFORM_NAME="ios" APP_BROWSER="Safari" NEW_COMMAND_TIMEOUT=30 SHOW_SIM_KEYBOARD=false <%= mobile %>
 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 %>
 
+ios_remote: --profile ipad_pro_12_15_sim --profile run_appium ORIENTATION=portrait TEST_ENVIRONMENT=REMOTE
+
 
 #==============
 # profiles for Android mobile web browsers hosted within Android Studio Android Virtual Device emulators
 # NOTE: Requires installation of Android Studio, Android version specific virtual device simulators, Appium, and the appium_capybara gem
 #==============
 
-appium_android:    WEB_BROWSER=appium APP_PLATFORM_NAME="Android" <%= desktop %>
+appium_android:    WEB_BROWSER=appium APP_PLATFORM_NAME="Android" <%= mobile %>
 app_android_12:    --profile appium_android APP_BROWSER="Chrome" APP_VERSION="12.0"
 pixel_c_api31_sim: --profile app_android_12 DEVICE_TYPE=tablet APP_DEVICE="Pixel_C_API_31"
 
+android_remote: --profile pixel_c_api31_sim --profile run_appium ORIENTATION=portrait TEST_ENVIRONMENT=REMOTE
+
 
 #==============
 # profiles for remotely hosted web browsers on the BrowserStack service

data/config/locales/en-US.yml

@@ -0,0 +1,56 @@
+# Localization file for English/U.S. locale.
+
+en-US:
+  time:
+    formats:
+      default: "%m/%d/%Y"
+      long: "%B %d, %Y"
+      short: "%b %d"
+      abbrev: "%b %d, %Y"
+      abbrev_month: "%b"
+      month_year: "%B %Y"
+  date:
+    abbr_day_names:
+    - Sun
+    - Mon
+    - Tue
+    - Wed
+    - Thu
+    - Fri
+    - Sat
+    abbr_month_names:
+    -
+    - Jan
+    - Feb
+    - Mar
+    - Apr
+    - May
+    - Jun
+    - Jul
+    - Aug
+    - Sep
+    - Oct
+    - Nov
+    - Dec
+    day_names:
+    - Sunday
+    - Monday
+    - Tuesday
+    - Wednesday
+    - Thursday
+    - Friday
+    - Saturday
+    month_names:
+    -
+    - January
+    - February
+    - March
+    - April
+    - May
+    - June
+    - July
+    - August
+    - September
+    - October
+    - November
+    - December

data/config/test_data/LOCAL_data.json

@@ -0,0 +1,15 @@
+{
+  "Form_data": {
+    "primary": {
+      "username": "Thaddeus Eumbwebwe",
+      "password": "Pa55w0rd",
+      "image_filename": "Granny.jpg",
+      "multi_select": "Selection Item 3",
+      "drop_down_item": "Drop Down Item 3",
+      "check1": false,
+      "check2": true,
+      "check3": true,
+      "radio_select": 1
+    }
+  }
+}

data/config/test_data/LOCAL_data.yml

@@ -0,0 +1,11 @@
+Form_data:
+  primary:
+    username: "Ignatius von Snicklefritz"
+    password: "T0p_Sekrit"
+    image_filename: "Wilder.jpg"
+    multi_select: "Selection Item 2"
+    drop_down_item: "Drop Down Item 5"
+    check1: true
+    check2: true
+    check3: false
+    radio_select: 2

data/config/test_data/data.json

@@ -0,0 +1,25 @@
+{
+  "Environments": {
+    "LOCAL": {
+      "PROTOCOL": "file",
+      "BASE_URL": "/../../test_site"
+    },
+    "REMOTE": {
+      "PROTOCOL": "http",
+      "BASE_URL": "192.168.1.129/test_site"
+    }
+  },
+  "Form_data": {
+    "primary": {
+      "username": "Thaddeus Eumbwebwe",
+      "password": "Pa55w0rd",
+      "image_filename": "Granny.jpg",
+      "multi_select": "Selection Item 3",
+      "drop_down_item": "Drop Down Item 3",
+      "check1": false,
+      "check2": true,
+      "check3": true,
+      "radio_select": 1
+    }
+  }
+}

data/config/test_data/data.yml

@@ -0,0 +1,20 @@
+# This section is populated with Environment data required to execute automated test suites on all supported environments
+Environments:
+  LOCAL:
+    PROTOCOL: "file"
+    BASE_URL: "/../../test_site"
+  REMOTE:
+    PROTOCOL: "http"
+    BASE_URL: "192.168.1.129/test_site"
+
+Form_data:
+  primary:
+    username: "Xavier Snicklefritz"
+    password: "Pa55W0rd"
+    image_filename: "Wilder.jpg"
+    multi_select: "Selection Item 1"
+    drop_down_item: "Drop Down Item 2"
+    check1: true
+    check2: true
+    check3: true
+    radio_select: 3

data/{docker-compose-v3.yml → docker-compose.yml}

@@ -1,6 +1,6 @@
-# To execute this docker-compose yml file use `docker-compose -f docker-compose-v3.yml up`
+# To execute this docker-compose yml file use `docker-compose -f docker-compose.yml up`
 # Add the `-d` flag at the end for detached execution
-# To stop the execution, hit Ctrl+C, and then `docker-compose -f docker-compose-v3.yml down`
+# To stop the execution, hit Ctrl+C, and then `docker-compose -f docker-compose.yml down`
 version: "3"
 services:
   chrome:

data/features/basic_form_page_css.feature

@@ -0,0 +1,54 @@
+Feature: Basic HTML Form Test Page using CSS locators
+  In order to ensure comprehensive support for HTML UI elements and forms
+  As a developer of the TestCentricity web gem
+  I expect to validate the interaction and verification capabilities of typical HTML form UI elements
+
+
+  Background:
+    Given I am on the Basic CSS Form page
+
+
+  Scenario: Validate verify_ui_states method and associated object state verification methods
+    Then I expect the Basic CSS Form page to be correctly displayed
+
+
+@!mobile @!firefox_headless @!firefox_grid
+  Scenario: Validate verify_focus_order method
+    Then I expect the tab order to be correct
+
+
+  Scenario: Validate populate_data_fields method and associated object action methods
+    When I populate the form fields
+    Then I expect the form fields to be correctly populated
+    When I cancel my changes
+    Then I expect the Basic CSS Form page to be correctly displayed
+
+
+  Scenario Outline:  Choose selectlist options by index, value, and text
+    When I choose selectlist options by <method>
+    Then I expect the selected option to be displayed
+
+    Examples:
+      |method |
+      |index  |
+      |text   |
+
+@!safari @!firefox @!firefox_headless
+    Examples:
+      |method |
+      |value  |
+
+
+  Scenario Outline:  Verify functionality of navigation tabs and browser back/forward
+    When I click the <target_page> navigation tab
+    Then I expect the <target_page> page to be correctly displayed
+    When I navigate back
+    Then I should be on the Basic CSS Form page
+    When I navigate forward
+    Then I should be on the <target_page> page
+
+    Examples:
+      |target_page      |
+      |Media Test       |
+      |Indexed Sections |
+      |Custom Controls  |

data/features/basic_form_page_xpath.feature

@@ -0,0 +1,26 @@
+@!grid @!mobile @!headless
+
+
+Feature: Basic HTML Form Test Page using Xpath locators
+  In order to ensure comprehensive support for HTML UI elements and forms
+  As a developer of the TestCentricity web gem
+  I expect to validate the interaction and verification capabilities of typical HTML form UI elements
+
+
+  Background:
+    Given I am on the Basic Xpath Form page
+
+
+  Scenario: Validate verify_ui_states method and associated object state verification methods
+    Then I expect the Basic Xpath Form page to be correctly displayed
+
+
+  Scenario: Validate verify_focus_order method
+    Then I expect the tab order to be correct
+
+
+  Scenario: Validate populate_data_fields method and associated object action methods
+    When I populate the form fields
+    Then I expect the form fields to be correctly populated
+    When I cancel my changes
+    Then I expect the Basic Xpath Form page to be correctly displayed

data/features/custom_controls.feature

@@ -0,0 +1,29 @@
+Feature: Custom Controls
+  In order to ensure comprehensive support for custom UI elements
+  As a developer of the TestCentricity web gem
+  I expect to validate the interaction and verification capabilities of custom UI elements
+
+
+  Background:
+    Given I am on the Custom Controls page
+
+
+  Scenario: Validate populate_data_fields method and associated object action methods
+    When I populate the form fields
+    Then I expect the form fields to be correctly populated
+
+
+@!safari @!firefox @!firefox_headless @!ios
+  Scenario: Use custom select list input field to choose options
+    When I choose custom select options by typing
+    Then I expect the form fields to be correctly populated
+
+
+  Scenario Outline:  Choose selectlist options by index and text
+    When I choose selectlist options by <method>
+    Then I expect the selected option to be displayed
+
+    Examples:
+      |method |
+      |index  |
+      |text   |