testcentricity_web 4.1.7 → 4.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 58ddfdbcb8747347fcb06efdd2a888509fa904bd5541a0f3d4d303af6469552c
-  data.tar.gz: 14f9af8661d7e571d10f79e3d093cafa4e744388d5c1d6f9232e207fe5e82d6f
+  metadata.gz: ec1cf64d0d0e52b5d49ce5980dc049add4befecbc830650c4c908db5b2e07ac2
+  data.tar.gz: 841d00666f64914cf72d0f279e060c5ba31c1eb8a056020015a1430daf9c38a6
 SHA512:
-  metadata.gz: 768e113468d0dfc68f01467bc4304f41903bff09f59db9f2c8dd013545c061523c7e0947669d1befadcf43b1187e57df3cb188d803b3d802d905c0c3467ce852
-  data.tar.gz: 3133dc1f23ff3a839c45e2c6424d152f6c85916497c00dd9a815113f2acb8225f45efab91ce9d7cb4ada454d33115649ad61f4073f109a7dec44e40891971043
+  metadata.gz: 1e4e6f516c68a18689ccecfa7ee52ca97db9ffb8641c63d21641061e70ca4ac0f1b53d5191b02c6335ac1403e6bdf8afe0b0133d1204f2b87d4496d00a4c4fc1
+  data.tar.gz: c38230893848b6145e79e131f9e6a99867fa0a1d590d2b272a00709ee107b9a8044180c037cd1182cd6aa13d58c208e3ce154c2de08b66161a7c06ce02e0a8bc

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,12 +2,23 @@
 All notable changes to this project will be documented in this file.
 
 
+## [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.
 
-### Changes
+### 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.

data/Gemfile.lock

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

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
 

data/Rakefile

@@ -49,12 +49,38 @@ namespace :features do
     t.profile = 'ios_remote'
   end
 
+  Cucumber::Rake::Task.new(:emulated_mobile) do |t|
+    t.profile = 'ipad_pro_12_local'
+  end
+
 
-  task :required => [:edge_local, :edge_headless, :chrome_local, :chrome_headless, :safari_local]
+  task :required => [
+    :edge_local,
+    :edge_headless,
+    :chrome_local,
+    :chrome_headless,
+    :firefox_local,
+    :firefox_headless,
+    :safari_local,
+    :emulated_mobile,
+  ]
 
-  task :grid => [:edge_grid, :chrome_grid]
+  task :grid => [:edge_grid, :chrome_grid, :firefox_grid]
 
   task :mobile => [:ios_remote]
 
-  task :all => [:edge_local, :edge_headless, :chrome_local, :chrome_headless, :safari_local, :edge_grid, :chrome_grid, :ios_remote]
+  task :all => [
+    :edge_local,
+    :edge_headless,
+    :chrome_local,
+    :chrome_headless,
+    :firefox_local,
+    :firefox_headless,
+    :safari_local,
+    :edge_grid,
+    :chrome_grid,
+    :firefox_grid,
+    :emulated_mobile,
+    :ios_remote
+  ]
 end

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" %>
 
 
@@ -58,6 +57,14 @@ 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 %>
+
+
 #==============
 # profile to start Appium Server prior to running mobile browser tests on iOS or Android simulators or physical devices
 #==============
@@ -69,7 +76,7 @@ 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)"
@@ -83,7 +90,7 @@ ios_remote: --profile ipad_pro_12_15_sim --profile run_appium ORIENTATION=portra
 # 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"
 

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

@@ -8,5 +8,18 @@
       "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

@@ -1,7 +1,3 @@
-# -------------------------------------------------------------
-# 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:
@@ -10,3 +6,15 @@ Environments:
   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/features/basic_form_page_css.feature

@@ -0,0 +1,39 @@
+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
+  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:  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/media_players.feature

@@ -1,10 +1,7 @@
-
-
-
-Feature: Basic HTML Test Page using CSS locators
-  In order to xxx
-  As a xxxx
-  I expect to xxxx
+Feature: HTML5 Audio/Video Test Page using CSS locators
+  In order to ensure comprehensive support for HTML5 Audio and Video media elements
+  As a developer of the TestCentricity web gem
+  I expect to validate the interaction and verification capabilities of media UI elements
 
 
   Background:

data/features/step_definitions/generic_steps.rb.rb

@@ -42,3 +42,68 @@ When(/^I click the (.*) navigation (?:tab|link)$/) do |page_name|
   target_page = PageManager.find_page(page_name)
   target_page.navigate_to
 end
+
+
+Then(/^I should (?:see|be on) the (.*) page$/) 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
+end
+
+
+Then(/^I expect the (.*) page to be correctly displayed in a new browser tab$/) do |page_name|
+  Browsers.switch_to_new_browser_instance
+  Environ.set_external_page(true)
+  TestCentricity::WebDriverConnect.initialize_browser_size if Environ.headless
+  # 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 (?:access|switch to) the new browser tab$/) do
+  Browsers.switch_to_new_browser_instance
+end
+
+
+When(/^I close the current browser window$/) do
+  Browsers.close_current_browser_window
+  # intercept and accept any JavaScript system or browser modals that may appear
+  begin
+    page.driver.browser.switch_to.alert.accept
+    switch_to_new_browser_instance
+  rescue
+  end
+end
+
+
+When(/^I close the previous browser window$/) do
+  Browsers.close_old_browser_instance
+end
+
+
+When(/^I refresh the current page$/) do
+  Browsers.refresh_browser unless Environ.driver == :appium
+end
+
+
+When(/^I navigate back$/) do
+  Browsers.navigate_back
+end
+
+
+When(/^I navigate forward$/) do
+  Browsers.navigate_forward
+end
+
+
+When(/^I delete all cookies$/) do
+  Browsers.delete_all_cookies
+end
+
+
+When(/^I set device orientation to (.*)$/) do |orientation|
+  Browsers.set_device_orientation(orientation.downcase.to_sym)
+end

data/features/support/data/form_data.rb

@@ -0,0 +1,43 @@
+class FormDataSource < TestCentricity::ExcelDataSource
+  def read_form_data
+    form_data = case ENV['DATA_SOURCE'].downcase.to_sym
+                  when :excel
+                    read_excel_row_data('Form_data', 'primary')
+                  when :yaml, :json
+                    environs.read('Form_data', 'primary')
+                  else
+                    raise "#{ENV['DATA_SOURCE']} is not a valid data source"
+                end
+    FormData.current = FormData.new(form_data)
+  end
+
+  def map_form_data(form_data)
+    FormData.current = FormData.new(form_data)
+  end
+end
+
+
+class FormData < TestCentricity::DataPresenter
+  attribute :username, String
+  attribute :password, String
+  attribute :image_filename, String
+  attribute :multi_select, String
+  attribute :drop_down_item, String
+  attribute :check1, Boolean, default: false
+  attribute :check2, Boolean, default: false
+  attribute :check3, Boolean, default: false
+  attribute :radio_select, Integer
+
+  def initialize(data)
+    @username       = data[:username]
+    @password       = data[:password]
+    @image_filename = data[:image_filename]
+    @multi_select   = data[:multi_select]
+    @drop_down_item = data[:drop_down_item]
+    @check1         = data[:check1]
+    @check2         = data[:check2]
+    @check3         = data[:check3]
+    @radio_select   = data[:radio_select]
+    super
+  end
+end

data/features/support/env.rb

@@ -9,10 +9,10 @@ include TestCentricity
 
 SimpleCov.command_name("features-#{ENV['WEB_BROWSER']}-#{ENV['SELENIUM']}" + (ENV['TEST_ENV_NUMBER'] || ''))
 
-# require_relative 'world_data'
+require_relative 'world_data'
 require_relative 'world_pages'
 
-# require_rel 'data'
+require_rel 'data'
 require_rel 'sections'
 require_rel 'pages'
 
@@ -32,7 +32,7 @@ Faker::Config.locale = ENV['LOCALE']
 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
+WorldData.instantiate_data_objects
 
 # instantiate all page objects
 include WorldPages

data/features/support/hooks.rb

@@ -182,7 +182,27 @@ end
 
 Around('@!mobile') do |scenario, block|
   if Environ.platform == :mobile
-    log "Scenario '#{scenario.name}' can not be executed on mobile devices or simulators."
+    log "Scenario '#{scenario.name}' is not executed on mobile devices or simulators."
+    skip_this_scenario
+  else
+    block.call
+  end
+end
+
+
+Around('@!headless') do |scenario, block|
+  if Environ.headless
+    log "Scenario '#{scenario.name}' is not executed on headless browsers."
+    skip_this_scenario
+  else
+    block.call
+  end
+end
+
+
+Around('@!firefox_headless') do |scenario, block|
+  if Environ.browser == :firefox_headless
+    log "Scenario '#{scenario.name}' can not be executed on headless Firefox browsers."
     skip_this_scenario
   else
     block.call

data/features/support/pages/base_test_page.rb

@@ -8,4 +8,15 @@ class BaseTestPage < TestCentricity::PageObject
   def navigate_to
     navigator
   end
+
+  def verify_page_ui
+    # verify page title and header
+    ui = {
+      self         => { exists: true, secure: false, title: page_title },
+      header_label => { visible: true, caption: page_title }
+    }
+    verify_ui_states(ui)
+    # verify header navigation bar
+    header_nav.verify_nav_bar
+  end
 end

data/features/support/pages/{basic_css_test_page.rb → basic_css_form_page.rb}

@@ -1,7 +1,7 @@
-# Page Object class definition for Basic HTML Test page with CSS locators
+# Page Object class definition for Basic HTML Form page with CSS locators
 
-class BasicCSSTestPage < BasicTestPage
-  trait(:page_name)    { 'Basic CSS Test' }
+class BasicCSSFormPage < BasicFormPage
+  trait(:page_name)    { 'Basic CSS Form' }
   trait(:page_locator) { 'form#HTMLFormElements' }
 
   # Basic HTML Test page UI elements