testcentricity_web 4.1.6 → 4.1.9

data/features/media_players.feature

@@ -0,0 +1,67 @@
+@!grid @!mobile
+
+
+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:
+    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.5x
+    Then the video should play at 0.5x 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.5x
+    Then the audio should play at 0.5x 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

@@ -35,3 +35,90 @@ 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
+
+
+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
+
+
+When(/^I choose custom select options by typing$/) do
+  custom_controls_page.set_select_options
+end
+
+
+When(/^I choose selectlist options by (.*)$/) do |method|
+  PageManager.current_page.choose_options_by(method)
+end
+
+
+Then(/^I expect the selected option to be displayed$/) do
+  PageManager.current_page.verify_chosen_options
+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/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

@@ -5,13 +5,16 @@ require 'require_all'
 require 'simplecov'
 require 'testcentricity_web'
 
-SimpleCov.command_name "features #{ENV['WEB_BROWSER']}" + (ENV['TEST_ENV_NUMBER'] || '')
+include TestCentricity
 
-# require_relative 'world_data'
+coverage_report_name = "Features-#{ENV['WEB_BROWSER']}-#{ENV['SELENIUM']}" + (ENV['TEST_ENV_NUMBER'] || '')
+SimpleCov.command_name("#{coverage_report_name}-#{Time.now.strftime('%Y%m%d%H%M%S%L')}")
+
+require_relative 'world_data'
 require_relative 'world_pages'
 
-# require_rel 'data'
-# require_rel 'sections'
+require_rel 'data'
+require_rel 'sections'
 require_rel 'pages'
 
 $LOAD_PATH << './lib'
@@ -27,9 +30,10 @@ 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
+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
@@ -38,6 +42,10 @@ 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)
+
+url = if Environ.test_environment == :local
+        "file://#{File.dirname(__FILE__)}/../../test_site"
+      else
+        Environ.current.app_host
+      end
+WebDriverConnect.initialize_web_driver(app_host: url)

data/features/support/hooks.rb

@@ -104,6 +104,11 @@ Around('@!firefox') do |scenario, block|
 end
 
 
+Around('@!firefox_headless') do |scenario, block|
+  qualify_browser(:firefox_headless, 'Firefox headless', scenario, block)
+end
+
+
 # block feature/scenario execution if running against iPad mobile browser
 Around('@!ipad') do |scenario, block|
   qualify_device('ipad', scenario, block)
@@ -182,7 +187,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_grid') do |scenario, block|
+  if Environ.browser == :firefox && Environ.grid
+    log "Scenario '#{scenario.name}' can not be executed on grid hosted Firefox browsers."
     skip_this_scenario
   else
     block.call

data/features/support/pages/base_test_page.rb

@@ -0,0 +1,22 @@
+# Page Object class definition for Base Test page
+
+class BaseTestPage < TestCentricity::PageObject
+  # Base Test page UI elements
+  label    :header_label, 'h2#header'
+  sections header_nav:    NavHeader
+
+  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
@@ -12,8 +12,8 @@ class BasicCSSTestPage < BasicTestPage
               number_field:      'input#number-field',
               color_picker:      'input#color-picker',
               comments_field:    'textarea#comments'
-  range       :slider,           'input#slider'
-  filefield   :upload_file,      'input#filename'
+  ranges      slider:            'input#slider'
+  filefields  upload_file:       'input#filename'
   checkboxes  check_1:           'input#check1',
               check_2:           'input#check2',
               check_3:           'input#check3',
@@ -24,14 +24,17 @@ class BasicCSSTestPage < BasicTestPage
               radio_4:           'input#radio4'
   selectlists multi_select:      'select#multipleselect',
               drop_down_select:  'select#dropdown'
-  table       :static_table,     'table#table'
+  lists       links_list:        'ul#links_list'
+  links       link_1:            'a#link1',
+              link_2:            'a#link2',
+              link_3:            'a#link3'
+  tables      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']",
+  labels      username_label:    "label[for='username']",
               password_label:    "label[for='password']",
               max_length_label:  "label[for='maxlength']",
               read_only_label:   "label[for='readonly']",
@@ -44,6 +47,7 @@ class BasicCSSTestPage < BasicTestPage
               radios_label:      'label#radios',
               multiselect_label: "label[for='multipleselect']",
               dropdown_label:    "label[for='dropdown']",
+              link_label:        'label#links',
               table_label:       "label[for='table']",
               images_label:      'label#images'
 end