testcentricity_web 4.1.3 → 4.1.6

data/Rakefile

@@ -1 +1,37 @@
-require 'bundler/gem_tasks'
+require 'rubygems'
+require 'cucumber'
+require 'cucumber/rake/task'
+require 'rake'
+
+
+namespace :features do
+  Cucumber::Rake::Task.new(:edge) do |t|
+    t.profile = 'edge'
+  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
+
+  Cucumber::Rake::Task.new(:chrome_headless) do |t|
+    t.profile = 'chrome_headless'
+  end
+
+  Cucumber::Rake::Task.new(:safari) do |t|
+    t.profile = 'safari'
+  end
+
+  Cucumber::Rake::Task.new(:firefox) do |t|
+    t.profile = 'firefox'
+  end
+
+  Cucumber::Rake::Task.new(:firefox_headless) do |t|
+    t.profile = 'firefox_headless'
+  end
+
+  task :all => [:edge, :edge_headless, :chrome, :chrome_headless, :safari]
+end

data/config/cucumber.yml

@@ -0,0 +1,150 @@
+<% 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" %>
+<% reports = "--require features --format pretty --format html --out reports/test_results.html --format junit --out reports --format json --out reports/test_results.json" %>
+
+
+#==============
+# generic test context profiles
+#==============
+
+failing: --tags '@failing and not @wip'
+wip:     --tags '@wip and not @failing'
+dev:     --tags '@dev and (not @wip and not @failing)'
+
+
+#==============
+# test reporting profiles
+#==============
+
+report:   <%= reports %> REPORTING=true
+parallel: PARALLEL=true REPORTING=true --require features --format pretty --format html --out reports/test_results<%= ENV['TEST_ENV_NUMBER'] %>.html --format junit --out reports --format json --out reports/test_results<%= ENV['TEST_ENV_NUMBER'] %>.json
+
+
+#==============
+# profiles for locally hosted desktop web browsers
+#==============
+
+chrome:  WEB_BROWSER=chrome <%= 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 %>
+
+
+#==============
+# profile for Selenium Grid and Dockerized Selenium Grid hosted desktop web browsers
+#==============
+grid: SELENIUM=remote REMOTE_ENDPOINT="http://localhost:4444/wd/hub"
+
+
+#==============
+# profiles for mobile device screen orientation
+#==============
+
+landscape: ORIENTATION=landscape
+portrait:  ORIENTATION=portrait
+
+
+#==============
+# profile to start Appium Server prior to running mobile browser tests on iOS or Android simulators or physical devices
+#==============
+run_appium: APPIUM_SERVER=run
+
+
+#==============
+# profiles for mobile Safari web browsers hosted within XCode iOS simulators
+# 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 %>
+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 %>
+
+
+#==============
+# 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 %>
+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"
+
+
+#==============
+# profiles for remotely hosted web browsers on the BrowserStack service
+#==============
+
+browserstack: WEB_BROWSER=browserstack BS_USERNAME="<INSERT USER NAME HERE>" BS_AUTHKEY="<INSERT PASSWORD HERE>" AUTOMATE_PROJECT="TC_Web_Sample - BrowserStack"
+bs_desktop:   --profile browserstack <%= desktop %> RESOLUTION="1920x1080"
+bs_mobile:    --profile browserstack <%= mobile %>
+
+# BrowserStack macOS desktop browser profiles
+bs_macos_monterey:  --profile bs_desktop BS_OS="OS X" BS_OS_VERSION="Monterey"
+bs_chrome_monterey: --profile bs_macos_monterey BS_BROWSER="Chrome" BS_VERSION="latest"
+bs_edge_monterey:   --profile bs_macos_monterey BS_BROWSER="Edge" BS_VERSION="latest"
+bs_safari_monterey: --profile bs_macos_monterey BS_BROWSER="Safari" BS_VERSION="latest"
+
+# BrowserStack iOS mobile browser profiles
+bs_ipad:        --profile bs_mobile BS_OS=ios BS_BROWSER=Safari DEVICE_TYPE=tablet BS_REAL_MOBILE="true"
+bs_ipad_pro_12: --profile bs_ipad BS_DEVICE="iPad Pro 12.9 2018" BS_OS_VERSION="15"
+
+# BrowserStack Android mobile browser profiles
+bs_android:        --profile bs_mobile BS_OS=android BS_BROWSER=Chrome DEVICE_TYPE=tablet BS_REAL_MOBILE="true"
+bs_android_tablet: --profile bs_android BS_DEVICE="Samsung Galaxy Tab S7" BS_OS_VERSION="10.0"
+
+
+#==============
+# profiles for remotely hosted web browsers on the LambdaTest service
+#==============
+
+lambdatest: WEB_BROWSER=lambdatest LT_USERNAME="<INSERT USER NAME HERE>" LT_AUTHKEY="<INSERT PASSWORD HERE>" AUTOMATE_PROJECT="TC_Web_Sample - LambdaTest"
+lt_desktop: --profile lambdatest <%= desktop %> RESOLUTION="2560x1440"
+
+# LambdaTest macOS desktop browser profiles
+lt_macos_monterey:  --profile lt_desktop LT_OS="MacOS Monterey"
+lt_chrome_monterey: --profile lt_macos_monterey LT_BROWSER="Chrome" LT_VERSION="98.0"
+lt_edge_monterey:   --profile lt_macos_monterey LT_BROWSER="MicrosoftEdge" LT_VERSION="97.0"
+
+
+#==============
+# profiles for remotely hosted web browsers on the TestingBot service
+#==============
+
+testingbot: WEB_BROWSER=testingbot TB_USERNAME="<INSERT USER NAME HERE>" TB_AUTHKEY="<INSERT PASSWORD HERE>" AUTOMATE_PROJECT="TC_Web_Sample - TestingBot"
+tb_desktop: --profile testingbot <%= desktop %> RESOLUTION="1920x1200"
+
+# TestingBot macOS desktop browser profiles
+tb_macos_monterey:  --profile tb_desktop TB_OS="MONTEREY"
+tb_chrome_monterey: --profile tb_macos_monterey TB_BROWSER="chrome" TB_VERSION="latest"
+tb_edge_monterey:   --profile tb_macos_monterey TB_BROWSER="microsoftedge" TB_VERSION="latest"
+
+
+#==============
+# profiles for remotely hosted web browsers on the SauceLabs service
+#==============
+
+saucelabs:  WEB_BROWSER=saucelabs SL_USERNAME="<INSERT USER NAME HERE>" SL_AUTHKEY="<INSERT PASSWORD HERE>" DATA_CENTER="us-west-1" AUTOMATE_PROJECT="TC_Web_Sample - SauceLabs"
+sl_desktop: --profile saucelabs <%= desktop %>
+sl_mobile:  --profile saucelabs <%= mobile %>
+
+# SauceLabs macOS desktop browser profiles
+sl_macos_monterey:  --profile sl_desktop SL_OS="macOS 12" RESOLUTION="1920x1440"
+sl_chrome_monterey: --profile sl_macos_monterey SL_BROWSER="chrome" SL_VERSION="latest"
+sl_edge_monterey:   --profile sl_macos_monterey SL_BROWSER="MicrosoftEdge" SL_VERSION="latest"
+sl_firefox_monterey: --profile sl_macos_monterey SL_BROWSER="Firefox" SL_VERSION="latest"
+
+# SauceLabs Windows desktop browser profiles
+sl_windows:    --profile sl_desktop RESOLUTION="1920x1200"
+sl_edge_win11: --profile sl_windows SL_OS="Windows 11" SL_BROWSER="MicrosoftEdge" SL_VERSION="latest"
+sl_ie_win10:   --profile sl_windows SL_OS="Windows 10" SL_BROWSER="internet explorer" SL_VERSION="11"
+
+# SauceLabs iOS mobile browser profiles
+sl_ipad:        --profile sl_mobile DEVICE_TYPE=tablet SL_PLATFORM=iOS SL_BROWSER=Safari
+sl_ipad_pro_12: --profile sl_ipad SL_DEVICE="iPad Pro (12.9 inch) (5th generation) Simulator" SL_VERSION="15.0"

data/docker-compose-v3.yml

@@ -0,0 +1,48 @@
+# To execute this docker-compose yml file use `docker-compose -f docker-compose-v3.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`
+version: "3"
+services:
+  chrome:
+    image: selenium/node-chrome:4.1.2-20220217
+    shm_size: 2gb
+    depends_on:
+      - selenium-hub
+    environment:
+      - SE_EVENT_BUS_HOST=selenium-hub
+      - SE_EVENT_BUS_PUBLISH_PORT=4442
+      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
+      - SE_NODE_MAX_SESSIONS=4
+      - SE_NODE_OVERRIDE_MAX_SESSIONS=true
+
+  edge:
+    image: selenium/node-edge:4.1.2-20220217
+    shm_size: 2gb
+    depends_on:
+      - selenium-hub
+    environment:
+      - SE_EVENT_BUS_HOST=selenium-hub
+      - SE_EVENT_BUS_PUBLISH_PORT=4442
+      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
+      - SE_NODE_MAX_SESSIONS=4
+      - SE_NODE_OVERRIDE_MAX_SESSIONS=true
+
+  firefox:
+    image: selenium/node-firefox:4.1.2-20220217
+    shm_size: 2gb
+    depends_on:
+      - selenium-hub
+    environment:
+      - SE_EVENT_BUS_HOST=selenium-hub
+      - SE_EVENT_BUS_PUBLISH_PORT=4442
+      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
+      - SE_NODE_MAX_SESSIONS=4
+      - SE_NODE_OVERRIDE_MAX_SESSIONS=true
+
+  selenium-hub:
+    image: selenium/hub:4.1.2-20220217
+    container_name: selenium-hub
+    ports:
+      - "4442:4442"
+      - "4443:4443"
+      - "4444:4444"

data/features/basic_test_page_css.feature

@@ -0,0 +1,24 @@
+Feature: Basic HTML Test Page using CSS locators
+  In order to xxx
+  As a xxxx
+  I expect to xxxx
+
+
+  Background:
+    Given I am on the Basic CSS Test page
+
+
+  Scenario: xxxxx
+    Then I expect the Basic CSS Test page to be correctly displayed
+
+
+@!mobile
+  Scenario: xxxxx
+    Then I expect the tab order to be correct
+
+
+  Scenario: xxxxx
+    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 Test page to be correctly displayed

data/features/basic_test_page_xpath.feature

@@ -0,0 +1,24 @@
+Feature: Basic HTML Test Page using Xpath locators
+  In order to xxx
+  As a xxxx
+  I expect to xxxx
+
+
+  Background:
+    Given I am on the Basic Xpath Test page
+
+
+  Scenario: xxxxx
+    Then I expect the Basic Xpath Test page to be correctly displayed
+
+
+@!mobile
+  Scenario: xxxxx
+    Then I expect the tab order to be correct
+
+
+  Scenario: xxxxx
+    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 Test page to be correctly displayed

data/features/step_definitions/generic_steps.rb.rb

@@ -0,0 +1,37 @@
+include TestCentricity
+
+
+Given(/^I am (?:on|viewing) the (.*) page$/) do |page_name|
+  # find and load the specified target page
+  target_page = PageManager.find_page(page_name)
+  target_page.load_page
+end
+
+
+Then(/^I expect the (.*) page to be correctly displayed$/) do |page_name|
+  # find and verify that the specified target page is loaded
+  target_page = PageManager.find_page(page_name)
+  target_page.verify_page_exists
+  # verify that target page is correctly displayed
+  target_page.verify_page_ui
+end
+
+
+When(/^I populate the form fields$/) do
+  PageManager.current_page.populate_form
+end
+
+
+Then(/^I expect the form fields to be correctly populated$/) do
+  PageManager.current_page.verify_form_data
+end
+
+
+When(/^I (.*) my changes$/) do | action|
+  PageManager.current_page.perform_action(action.downcase.to_sym)
+end
+
+
+Then(/^I expect the tab order to be correct$/) do
+  PageManager.current_page.verify_tab_order
+end

data/features/support/env.rb

@@ -0,0 +1,43 @@
+require 'capybara/cucumber'
+require 'parallel_tests'
+require 'appium_capybara'
+require 'require_all'
+require 'simplecov'
+require 'testcentricity_web'
+
+SimpleCov.command_name "features #{ENV['WEB_BROWSER']}" + (ENV['TEST_ENV_NUMBER'] || '')
+
+# require_relative 'world_data'
+require_relative 'world_pages'
+
+# require_rel 'data'
+# require_rel 'sections'
+require_rel 'pages'
+
+$LOAD_PATH << './lib'
+
+# set Capybara's default max wait time to 20 seconds
+Capybara.default_max_wait_time = 20
+
+# set the default locale and auto load all translations from config/locales/*.rb,yml.
+ENV['LOCALE'] = 'en-US' unless ENV['LOCALE']
+I18n.load_path += Dir['config/locales/*.{rb,yml}']
+I18n.default_locale = ENV['LOCALE']
+I18n.locale = ENV['LOCALE']
+Faker::Config.locale = ENV['LOCALE']
+
+# instantiate all data objects and target test environment
+# include WorldData
+# environs.find_environ(ENV['TEST_ENVIRONMENT'], :yaml)
+# WorldData.instantiate_data_objects
+
+# instantiate all page objects
+include WorldPages
+WorldPages.instantiate_page_objects
+
+# establish connection to WebDriver and target web browser
+Webdrivers.cache_time = 86_400
+
+options = { app_host: "file://#{File.dirname(__FILE__)}/../../test_site" }
+options = { app_host: "http://192.168.1.129"}
+TestCentricity::WebDriverConnect.initialize_web_driver(options)

data/features/support/hooks.rb

@@ -0,0 +1,245 @@
+
+BeforeAll do
+  # start Appium Server if command line option was specified and target browser is mobile simulator or device
+  if ENV['APPIUM_SERVER'] == 'run' && Environ.driver == :appium
+    $server = TestCentricity::AppiumServer.new
+    $server.start
+  end
+end
+
+
+AfterAll do
+  # terminate Appium Server if command line option was specified and target browser is mobile simulator or device
+  if ENV['APPIUM_SERVER'] == 'run' && Environ.driver == :appium && $server.running?
+    $server.stop
+  end
+  # close driver
+  terminate_session
+end
+
+
+Before do |scenario|
+  # if executing tests in parallel concurrent threads, print thread number with scenario name
+  message = Environ.parallel ? "Thread ##{Environ.process_num} | Scenario:  #{scenario.name}" : "Scenario:  #{scenario.name}"
+  log message
+  $initialized ||= false
+  unless $initialized
+    $initialized = true
+    $test_start_time = Time.now
+    # HTML report header information if reporting is enabled
+    log Environ.report_header if ENV['REPORTING']
+  end
+end
+
+
+After do |scenario|
+  # process and embed any screenshots recorded during execution of scenario
+  process_embed_screenshots(scenario)
+  # clear out any queued screenshots
+  Environ.reset_contexts
+  # close any external pages that may have been opened
+  if Environ.external_page
+    Browsers.close_current_browser_instance
+    begin
+      page.driver.browser.switch_to.alert.accept
+      Browsers.switch_to_new_browser_instance
+    rescue
+    end
+    Environ.set_external_page(false)
+  end
+  # block any JavaScript modals that may appear as a result of ending the session
+  Browsers.suppress_js_leave_page_modal
+  # close Capybara Appium driver if it was opened
+  Capybara.page.driver.quit if Capybara.default_driver == :appium
+
+  if ENV['QUIT_DRIVER']
+    terminate_session
+  elsif Environ.grid == :browserstack
+    # restart BrowserStack test sessions if test duration exceeds 110 minutes to avoid the 2 hour test limit
+    test_elapsed_time = Time.now - $test_start_time
+    if test_elapsed_time > 6600
+      terminate_session
+      log 'Restarting BrowserStack test session'
+      $test_start_time = Time.now
+    else
+      Capybara.reset_sessions!
+    end
+  end
+end
+
+
+# exclusionary Around hooks to prevent running feature/scenario on unsupported browsers, devices, or
+# cloud remote browser hosting platforms. Use the following tags to block test execution:
+#   desktop web browsers:      @!safari, @!ie, @!firefox, @!chrome, @!edge
+#   mobile devices:            @!ipad, @!iphone
+#   remotely hosted browsers:  @!browserstack, @!saucelabs
+
+# block feature/scenario execution if running against Safari browser
+Around('@!safari') do |scenario, block|
+  qualify_browser(:safari, 'Safari', scenario, block)
+end
+
+
+# block feature/scenario execution if running against Internet Explorer browser
+Around('@!ie') do |scenario, block|
+  qualify_browser(:ie, 'Internet Explorer', scenario, block)
+end
+
+
+# block feature/scenario execution if running against Microsoft Edge browser
+Around('@!edge') do |scenario, block|
+  qualify_browser(:edge, 'Edge', scenario, block)
+end
+
+
+# block feature/scenario execution if running against Chrome browser
+Around('@!chrome') do |scenario, block|
+  qualify_browser(:chrome, 'Chrome', scenario, block)
+end
+
+
+# block feature/scenario execution if running against Firefox browser
+Around('@!firefox') do |scenario, block|
+  qualify_browser(:firefox, 'Firefox', scenario, block)
+end
+
+
+# block feature/scenario execution if running against iPad mobile browser
+Around('@!ipad') do |scenario, block|
+  qualify_device('ipad', scenario, block)
+end
+
+
+# block feature/scenario execution if running against iPhone mobile browser
+Around('@!iphone') do |scenario, block|
+  qualify_device('iphone', scenario, block)
+end
+
+
+# block feature/scenario execution if running on Selenium Grid or cloud-hosted services
+Around('@!grid') do |scenario, block|
+  if !Environ.grid
+    block.call
+  else
+    log "Scenario '#{scenario.name}' cannot be executed on Selenium Grid or cloud-hosted services."
+    skip_this_scenario
+  end
+end
+
+
+# block feature/scenario execution if running against Browserstack cloud-hosted service
+Around('@!browserstack') do |scenario, block|
+  if Environ.grid != :browserstack
+    block.call
+  else
+    log "Scenario '#{scenario.name}' cannot be executed on the BrowserStack service."
+    skip_this_scenario
+  end
+end
+
+
+# block feature/scenario execution if running against Sauce Labs cloud-hosted service
+Around('@!saucelabs') do |scenario, block|
+  if Environ.grid != :saucelabs
+    block.call
+  else
+    log "Scenario '#{scenario.name}' cannot be executed on the SauceLabs service."
+    skip_this_scenario
+  end
+end
+
+
+# block feature/scenario execution if running against a physical or emulated mobile device
+Around('@!device') do |scenario, block|
+  if Environ.is_device?
+    log "Scenario '#{scenario.name}' cannot be executed on physical or emulated devices."
+    skip_this_scenario
+  else
+    block.call
+  end
+end
+
+
+Around('@!ios') do |scenario, block|
+  if Environ.device_os == :android
+    block.call
+  else
+    log "Scenario '#{scenario.name}' can not be executed on iOS devices."
+    skip_this_scenario
+  end
+end
+
+
+Around('@!android') do |scenario, block|
+  if Environ.device_os == :ios
+    block.call
+  else
+    log "Scenario '#{scenario.name}' can not be executed on Android devices."
+    skip_this_scenario
+  end
+end
+
+
+Around('@!mobile') do |scenario, block|
+  if Environ.platform == :mobile
+    log "Scenario '#{scenario.name}' can not be executed on mobile devices or simulators."
+    skip_this_scenario
+  else
+    block.call
+  end
+end
+
+
+# supporting methods
+
+def qualify_browser(browser_type, browser_name, scenario, block)
+  if Environ.browser != browser_type && ENV['HOST_BROWSER'] != browser_name.downcase
+    block.call
+  else
+    log "Scenario '#{scenario.name}' cannot be executed with the #{browser_name} browser."
+    skip_this_scenario
+  end
+end
+
+def qualify_device(device, scenario, block)
+  if Environ.is_device?
+    if Environ.device_type.include? device
+      log "Scenario '#{scenario.name}' cannot be executed on #{device} devices."
+      skip_this_scenario
+    else
+      block.call
+    end
+  else
+    block.call
+  end
+end
+
+def terminate_session
+  Capybara.page.driver.quit
+  Capybara.reset_sessions!
+  Environ.session_state = :quit
+  $driver_scenario_count = 0
+end
+
+def screen_shot_and_save_page(scenario)
+  timestamp = Time.now.strftime('%Y%m%d%H%M%S%L')
+  filename = scenario.nil? ? "Screenshot-#{timestamp}.png" : "Screenshot-#{scenario.__id__}-#{timestamp}.png"
+  path = File.join Dir.pwd, 'reports/screenshots/', filename
+  save_screenshot path
+  log "Screenshot saved at #{path}"
+  screen_shot = { path: path, filename: filename }
+  Environ.save_screen_shot(screen_shot)
+  attach(path, 'image/png') unless scenario.nil?
+end
+
+def process_embed_screenshots(scenario)
+  screen_shots = Environ.get_screen_shots
+  if screen_shots.count > 0
+    screen_shots.each do |row|
+      path = row[:path]
+      attach(path, 'image/png')
+    end
+  else
+    screen_shot_and_save_page(scenario) if scenario.failed?
+  end
+end

data/features/support/pages/basic_css_test_page.rb

@@ -0,0 +1,49 @@
+# Page Object class definition for Basic HTML Test page with CSS locators
+
+class BasicCSSTestPage < BasicTestPage
+  trait(:page_name)    { 'Basic CSS Test' }
+  trait(:page_locator) { 'form#HTMLFormElements' }
+
+  # Basic HTML Test page UI elements
+  textfields  username_field:    'input#username',
+              password_field:    'input#password',
+              max_length_field:  'input#maxlength',
+              read_only_field:   'input#readonly',
+              number_field:      'input#number-field',
+              color_picker:      'input#color-picker',
+              comments_field:    'textarea#comments'
+  range       :slider,           'input#slider'
+  filefield   :upload_file,      'input#filename'
+  checkboxes  check_1:           'input#check1',
+              check_2:           'input#check2',
+              check_3:           'input#check3',
+              check_4:           'input#check4'
+  radios      radio_1:           'input#radio1',
+              radio_2:           'input#radio2',
+              radio_3:           'input#radio3',
+              radio_4:           'input#radio4'
+  selectlists multi_select:      'select#multipleselect',
+              drop_down_select:  'select#dropdown'
+  table       :static_table,     'table#table'
+  images      image_1:           'img#image1',
+              image_2:           'img#image2',
+              image_3:           'img#image3'
+  buttons     cancel_button:     'input#cancel',
+              submit_button:     'input#submit'
+  labels      header_label:      'h1',
+              username_label:    "label[for='username']",
+              password_label:    "label[for='password']",
+              max_length_label:  "label[for='maxlength']",
+              read_only_label:   "label[for='readonly']",
+              number_label:      "label[for='number-field']",
+              color_label:       "label[for='color-picker']",
+              slider_label:      "label[for='slider']",
+              comments_label:    "label[for='comments']",
+              filename_label:    "label[for='filename']",
+              checkboxes_label:  'label#checkboxes',
+              radios_label:      'label#radios',
+              multiselect_label: "label[for='multipleselect']",
+              dropdown_label:    "label[for='dropdown']",
+              table_label:       "label[for='table']",
+              images_label:      'label#images'
+end