testcentricity_web 4.1.4 → 4.1.7

data/config/cucumber.yml

@@ -0,0 +1,163 @@
+<% 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
+#==============
+
+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 %>
+
+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 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
+
+
+#==============
+# 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 %>
+
+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 %>
+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
+#==============
+
+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/config/test_data/data.json

@@ -0,0 +1,12 @@
+{
+  "Environments": {
+    "LOCAL": {
+      "PROTOCOL": "file",
+      "BASE_URL": "/../../test_site"
+    },
+    "REMOTE": {
+      "PROTOCOL": "http",
+      "BASE_URL": "192.168.1.129/test_site"
+    }
+  }
+}

data/config/test_data/data.yml

@@ -0,0 +1,12 @@
+# -------------------------------------------------------------
+# This is the generic test data required to run the UAL Flight Booking test suites against the QA and PROD test environments.
+# -------------------------------------------------------------
+
+# 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"

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,35 @@
+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
+
+
+  Scenario Outline:  Verify functionality of navigation tabs
+    When I click the <target_page> navigation tab
+    Then I expect the <target_page> page to be correctly displayed
+
+    Examples:
+      |target_page      |
+      |Media Test       |
+      |Indexed Sections |
+      |Custom Controls  |

data/features/basic_test_page_xpath.feature

@@ -0,0 +1,27 @@
+@!grid
+
+
+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/media_players.feature

@@ -0,0 +1,87 @@
+
+
+
+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 Media Test page
+
+
+  Scenario:  Verify video player play and pause controls
+    When I play the video media
+    Then the video should be playing
+    When I pause the video media
+    Then the video should be paused
+
+
+  Scenario:  Verify audio player play and pause controls
+    When I play the audio media
+    Then the audio should be playing
+    When I pause the audio media
+    Then the audio should be paused
+
+
+  Scenario:  Verify video player mute control
+    When I mute the video media
+    Then the video should be muted
+    When I unmute the video media
+    Then the video should be unmuted
+
+
+  Scenario:  Verify audio player mute control
+    When I mute the audio media
+    Then the audio should be muted
+    When I unmute the audio media
+    Then the audio should be unmuted
+
+
+  Scenario:  Verify video player volume control
+    When I set the volume of the video to .5
+    Then the video should have a volume of .5
+
+
+  Scenario:  Verify audio player volume control
+    When I set the volume of the audio to .5
+    Then the audio should have a volume of .5
+
+
+  Scenario:  Verify video playback speed settings
+    When I play the video with a playback speed of 2x
+    Then the video should play at 2x speed
+    When I play the video with a playback speed of 0.25x
+    Then the video should play at 0.25x speed
+    When I play the video with a playback speed of 1.75x
+    Then the video should play at 1.75x speed
+    When I play the video with a playback speed of 0.5x
+    Then the video should play at 0.5x speed
+    When I play the video with a playback speed of 1.5x
+    Then the video should play at 1.5x speed
+    When I play the video with a playback speed of 0.75x
+    Then the video should play at 0.75x speed
+    When I play the video with a playback speed of 1.25x
+    Then the video should play at 1.25x speed
+    When I play the video with a playback speed of 1x
+    Then the video should play at 1x speed
+
+
+  Scenario:  Verify audio playback speed settings
+    When I play the audio with a playback speed of 2x
+    Then the audio should play at 2x speed
+    When I play the audio with a playback speed of 0.25x
+    Then the audio should play at 0.25x speed
+    When I play the audio with a playback speed of 1.75x
+    Then the audio should play at 1.75x speed
+    When I play the audio with a playback speed of 0.5x
+    Then the audio should play at 0.5x speed
+    When I play the audio with a playback speed of 1.5x
+    Then the audio should play at 1.5x speed
+    When I play the audio with a playback speed of 0.75x
+    Then the audio should play at 0.75x speed
+    When I play the audio with a playback speed of 1.25x
+    Then the audio should play at 1.25x speed
+    When I play the audio with a playback speed of 1x
+    Then the audio should play at 1x speed

data/features/step_definitions/generic_steps.rb.rb

@@ -0,0 +1,44 @@
+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
+
+
+When(/^I click the (.*) navigation (?:tab|link)$/) do |page_name|
+  # find and navigate to the specified target page
+  target_page = PageManager.find_page(page_name)
+  target_page.navigate_to
+end

data/features/step_definitions/media_steps.rb

@@ -0,0 +1,30 @@
+
+
+When(/^I (.*) the (.*) media$/) do |action, media_type|
+  media_test_page.perform_action(media_type, action)
+end
+
+
+Then(/^the (.*) should be (.*)$/) do |media_type, state|
+  media_test_page.verify_media_state(media_type, state)
+end
+
+
+When(/^I play the (.*) with a playback speed of (.*)x$/) do |media_type, rate|
+  media_test_page.set_playback_rate(media_type, rate)
+end
+
+
+Then(/^the (.*) should play at (.*)x speed$/) do |media_type, rate|
+  media_test_page.verify_playback_rate(media_type, rate)
+end
+
+
+When(/^I set the volume of the (.*) to (.*)$/) do |media_type, volume|
+  media_test_page.set_volume(media_type, volume)
+end
+
+
+Then(/^the (.*) should have a volume of (.*)$/) do |media_type, volume|
+  media_test_page.verify_volume(media_type, volume)
+end

data/features/support/env.rb

@@ -0,0 +1,50 @@
+require 'capybara/cucumber'
+require 'parallel_tests'
+require 'appium_capybara'
+require 'require_all'
+require 'simplecov'
+require 'testcentricity_web'
+
+include TestCentricity
+
+SimpleCov.command_name("features-#{ENV['WEB_BROWSER']}-#{ENV['SELENIUM']}" + (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
+ENV['DATA_SOURCE'] = 'yaml' unless ENV['DATA_SOURCE']
+environs.find_environ(ENV['TEST_ENVIRONMENT'], ENV['DATA_SOURCE'].downcase.to_sym)
+# 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
+
+
+url = if ENV['TEST_ENVIRONMENT'].downcase == 'local'
+        "file://#{File.dirname(__FILE__)}/../../test_site"
+      else
+        Environ.current.app_host
+      end
+WebDriverConnect.initialize_web_driver(app_host: url)