testcentricity_web 4.1.4 → 4.1.7

data/features/support/pages/media_test_page.rb

@@ -0,0 +1,195 @@
+# Page Object class definition for Media Test page with CSS locators
+
+class MediaTestPage < BaseTestPage
+  trait(:page_name)    { 'Media Test' }
+  trait(:page_locator) { 'div.media-page-body' }
+  trait(:page_url)     { '/media_page.html' }
+  trait(:navigator)    { header_nav.open_media_page }
+
+  # Media Test page UI elements
+  videos video_player: 'video#video_player'
+  audios audio_player: 'audio#audio_player'
+
+  def verify_page_ui
+    preload = case
+            when Environ.browser == :safari || Environ.device_os == :ios
+              'auto'
+            when Environ.browser == :firefox
+              ''
+            else
+              'metadata'
+            end
+    video_player.wait_until_ready_state_is(4, 10)
+    ui = {
+      self         => { exists: true, secure: false, title: 'Media Page' },
+      header_label => { visible: true, caption: 'Media Page' },
+      video_player => {
+        visible: true,
+        paused: true,
+        autoplay: false,
+        loop: false,
+        ended: false,
+        controls: true,
+        current_time: 0,
+        ready_state: 4,
+        default_playback_rate: 1,
+        playback_rate: 1,
+        seeking: false,
+        default_muted: false,
+        muted: false,
+        volume: 1,
+        preload: preload,
+        poster: '',
+        src: '',
+        duration: 17.6
+      },
+      audio_player => {
+        visible: true,
+        paused: true,
+        autoplay: false,
+        loop: false,
+        ended: false,
+        controls: true,
+        current_time: 0,
+        ready_state: 4,
+        default_playback_rate: 1,
+        playback_rate: 1,
+        seeking: false,
+        default_muted: false,
+        muted: false,
+        volume: 1,
+        preload: preload,
+        src: '',
+        duration: 3.45
+      }
+    }
+    verify_ui_states(ui)
+  end
+
+  def perform_action(media_type, action)
+    player = dispatch_player(media_type)
+    case action.downcase.to_sym
+    when :play
+      player.play
+      player.send_keys(:enter) if player.paused?
+      player.click if player.paused?
+    when :pause
+      player.pause
+    when :mute
+      player.mute
+    when :unmute
+      player.unmute
+    else
+      raise "#{action} is not a valid selector"
+    end
+    sleep(2)
+  end
+
+  def verify_media_state(media_type, state)
+    player = dispatch_player(media_type)
+    duration = player.duration
+    props = case state.downcase.to_sym
+            when :playing
+              {
+                visible: true,
+                paused: false,
+                ended: false,
+                current_time: { greater_than: 0 },
+                seeking: false
+              }
+            when :paused
+              {
+                visible: true,
+                paused: true,
+                ended: false,
+                current_time: { greater_than: 0 },
+                seeking: false
+              }
+            when :ended
+              {
+                visible: true,
+                paused: true,
+                ended: true,
+                current_time: duration,
+                seeking: false
+              }
+            when :muted
+              {
+                visible: true,
+                muted: true
+              }
+            when :unmuted
+              {
+                visible: true,
+                muted: false
+              }
+            else
+              raise "#{state} is not a valid selector"
+            end
+    verify_ui_states(player => props)
+  end
+
+  def set_playback_rate(media_type, rate)
+    player = dispatch_player(media_type)
+    player.playback_rate = rate.to_f
+    reset_play(player)
+  end
+
+  def verify_playback_rate(media_type, rate)
+    player = dispatch_player(media_type)
+    ui = {
+      player => {
+        playback_rate: rate.to_f,
+        visible: true,
+        paused: false,
+        current_time: { greater_than: 0 },
+        seeking: false
+      }
+    }
+    verify_ui_states(ui)
+  end
+
+  def set_volume(media_type, volume)
+    player = dispatch_player(media_type)
+    player.volume = volume.to_f
+    reset_play(player)
+  end
+
+  def verify_volume(media_type, volume)
+    player = dispatch_player(media_type)
+    ui = {
+      player => {
+        volume: volume.to_f,
+        visible: true,
+        muted: false,
+        paused: false,
+        current_time: { greater_than: 0 },
+        seeking: false
+      }
+    }
+    verify_ui_states(ui)
+  end
+
+  private
+
+  def dispatch_player(media_type)
+    player = case media_type.downcase.to_sym
+             when :video
+               video_player
+             when :audio
+               audio_player
+             else
+               raise "#{media_type} is not a valid selector"
+             end
+    player.wait_until_ready_state_is(4, 10)
+    player
+  end
+
+  def reset_play(player)
+    player.pause
+    player.current_time = 0
+    player.play
+    player.send_keys(:enter) if player.paused?
+    sleep(1)
+  end
+end

data/features/support/sections/header_nav.rb

@@ -0,0 +1,28 @@
+# Section Object class definition for Top Navigation Bar
+
+class NavHeader < TestCentricity::PageSection
+  trait(:section_locator) { 'div#nav_bar' }
+  trait(:section_name)    { 'Top Navigation Bar' }
+
+  # Top Navigation Bar UI elements
+  links form_link:             'a#form_link',
+        media_link:            'a#media_link',
+        indexed_sections_link: 'a#indexed_sections_link',
+        custom_controls_link:  'a#custom_controls_link'
+
+  def open_form_page
+    form_link.click
+  end
+
+  def open_media_page
+    media_link.click
+  end
+
+  def open_indexed_sections_page
+    indexed_sections_link.click
+  end
+
+  def open_custom_controls_page
+    custom_controls_link.click
+  end
+end

data/features/support/world_data.rb

@@ -0,0 +1,12 @@
+module WorldData
+  #
+  #  data_objects method returns a hash table of your web app's data objects and associated data object classes to be instantiated
+  #  by the TestCentricity™ DataManager. Data Object class definitions are contained in the features/support/data folder.
+  #
+  def data_objects
+    {}
+  end
+end
+
+
+World(WorldData)

data/features/support/world_pages.rb

@@ -0,0 +1,18 @@
+module WorldPages
+  #
+  #  page_objects method returns a hash table of your web app's page objects and associated page classes to be instantiated
+  # by the TestCentricity™ PageManager. Page Object class definitions are contained in the features/support/pages folder.
+  #
+  def page_objects
+    {
+      basic_css_test_page:   BasicCSSTestPage,
+      basic_xpath_test_page: BasicXpathTestPage,
+      media_test_page:       MediaTestPage,
+      indexed_sections_page: IndexedSectionsPage,
+      custom_controls_page:  CustomControlsPage
+    }
+  end
+end
+
+
+World(WorldPages)

data/lib/testcentricity_web/data_objects/environment.rb

@@ -71,6 +71,7 @@ module TestCentricity
     @screen_shots = []
 
     attr_accessor :test_environment
+    attr_accessor :app_host
     attr_accessor :browser
     attr_accessor :browser_size
     attr_accessor :headless
@@ -133,9 +134,20 @@ module TestCentricity
       @db_username   = data['DB_USERNAME']
       @db_password   = data['DB_PASSWORD']
 
+      url = @hostname.blank? ? "#{@base_url}#{@append}" : "#{@hostname}/#{@base_url}#{@append}"
+      @app_host = if @user_id.blank? || @password.blank?
+                    "#{@protocol}://#{url}"
+                  else
+                    "#{@protocol}://#{@user_id}:#{@password}@#{url}"
+                  end
+
       super
     end
 
+    def self.app_host
+      @app_host
+    end
+
     def self.session_code
       if @session_code.nil?
         characters = ('a'..'z').to_a
@@ -328,6 +340,10 @@ module TestCentricity
       @platform = platform
     end
 
+    def self.platform
+      @platform
+    end
+
     def self.is_mobile?
       @platform == :mobile
     end

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '4.1.4'
+  VERSION = '4.1.7'
 end

data/lib/testcentricity_web/web_core/page_object.rb

@@ -1,5 +1,9 @@
 module TestCentricity
   class PageObject < BasePageSectionObject
+    def initialize
+      set_locator_type(page_locator) if defined?(page_locator)
+    end
+
     # Declare and instantiate a single generic UI Element for this page object.
     #
     # @param element_name [Symbol] name of UI object (as a symbol)
@@ -308,19 +312,15 @@ module TestCentricity
     end
 
     def open_portal
-      environment = Environ.current
-      url = environment.hostname.blank? ? "#{environment.base_url}#{environment.append}" : "#{environment.hostname}/#{environment.base_url}#{environment.append}"
-      if environment.user_id.blank? || environment.password.blank?
-        visit "#{environment.protocol}://#{url}"
-      else
-        visit "#{environment.protocol}://#{environment.user_id}:#{environment.password}@#{url}"
-      end
+      visit Environ.current.app_host
       Environ.portal_state = :open
     end
 
     def verify_page_exists
       raise "Page object #{self.class.name} does not have a page_locator trait defined" unless defined?(page_locator)
-      unless page.has_selector?(page_locator)
+
+      set_locator_type(page_locator) if @locator_type.blank?
+      unless page.has_selector?(@locator_type, page_locator)
         body_class = find(:xpath, '//body')[:class]
         error_message = %(
           Expected page to have selector '#{page_locator}' but found '#{body_class}' instead.

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -6,6 +6,26 @@ module TestCentricity
     include Capybara::Node::Matchers
     include Test::Unit::Assertions
 
+    attr_accessor :locator_type
+
+    XPATH_SELECTORS = ['//', '[@', '[contains(']
+    CSS_SELECTORS   = ['#', ':nth-child(', ':first-child', ':last-child', ':nth-of-type(', ':first-of-type', ':last-of-type', '^=', '$=', '*=', ':contains(']
+
+    def set_locator_type(locator = nil)
+      locator = @locator if locator.nil?
+      is_xpath = XPATH_SELECTORS.any? { |selector| locator.include?(selector) }
+      is_css = CSS_SELECTORS.any? { |selector| locator.include?(selector) }
+      @locator_type = if is_xpath && !is_css
+                        :xpath
+                      elsif is_css && !is_xpath
+                        :css
+                      elsif !is_css && !is_xpath
+                        :css
+                      else
+                        :css
+                      end
+    end
+
     # Define a trait for this page or section object.
     #
     # @param trait_name [Symbol] name of trait (as a symbol)
@@ -31,6 +51,8 @@ module TestCentricity
                      ui_object.get_attribute(:name)
                    when :title
                      ui_object.title
+                   when :secure
+                     ui_object.secure?
                    when :exists
                      ui_object.exists?
                    when :enabled
@@ -63,6 +85,8 @@ module TestCentricity
                      ui_object.indeterminate?
                    when :value, :caption
                      ui_object.get_value
+                   when :required
+                     ui_object.required?
                    when :maxlength
                      ui_object.get_max_length
                    when :rowcount
@@ -241,8 +265,11 @@ module TestCentricity
     end
 
     # Populate the specified UI elements on this page or section object with the associated data from a Hash passed as an
-    # argument. Data values must be in the form of a String for textfield and selectlist controls. For checkbox and radio
-    # buttons, data must either be a Boolean or a String that evaluates to a Boolean value (Yes, No, 1, 0, true, false).
+    # argument. Data values must be in the form of a String for textfield, selectlist, and filefield controls. For checkbox
+    # and radio buttons, data must either be a Boolean or a String that evaluates to a Boolean value (Yes, No, 1, 0, true,
+    # false). For range controls, data must be an Integer. For input(type='color') color picker controls, which are specified
+    # as a textfield, data must be in the form of a hex color String. For section objects, data values must be a String, and
+    # the section object must have a set method defined.
     #
     # The optional wait_time parameter is used to specify the time (in seconds) to wait for each UI element to become
     # visible before entering the associated data value. This option is useful in situations where entering data, or
@@ -285,14 +312,20 @@ module TestCentricity
               check_state = data_param.is_a?(String) ? data_param.to_bool : data_param
               data_field.set_selected_state(check_state)
             when :textfield
-              data_field.set("#{data_param}\t")
-              if integrity_check && data_field.get_value != data_param
-                data_field.set('')
-                data_field.send_keys(data_param)
-                data_field.send_keys(:tab)
+              if data_field.get_attribute(:type) == 'color'
+                data_field.set(data_param)
+              else
+                data_field.set("#{data_param}\t")
+                if integrity_check && data_field.get_value != data_param
+                  data_field.set('')
+                  data_field.send_keys(data_param)
+                  data_field.send_keys(:tab)
+                end
               end
-            when :section
+            when :section, :range
               data_field.set(data_param)
+            when :filefield
+              data_field.file_upload(data_param)
             end
           end
         end

data/lib/testcentricity_web/web_core/page_section.rb

@@ -5,10 +5,6 @@ module TestCentricity
     attr_accessor :parent
     attr_accessor :parent_list
     attr_accessor :list_index
-    attr_accessor :locator_type
-
-    XPATH_SELECTORS = ['//', '[@', '[contains(']
-    CSS_SELECTORS   = ['#', ':nth-child(', ':first-child', ':last-child', ':nth-of-type(', ':first-of-type', ':last-of-type', '^=', '$=', '*=', ':contains(']
 
     def initialize(name, parent, locator, context)
       @name         = name
@@ -17,18 +13,7 @@ module TestCentricity
       @context      = context
       @parent_list  = nil
       @list_index   = nil
-
-      is_xpath = XPATH_SELECTORS.any? { |selector| @locator.include?(selector) }
-      is_css = CSS_SELECTORS.any? { |selector| @locator.include?(selector) }
-      @locator_type = if is_xpath && !is_css
-                        :xpath
-                      elsif is_css && !is_xpath
-                        :css
-                      elsif !is_css && !is_xpath
-                        :css
-                      else
-                        :css
-                      end
+      set_locator_type
     end
 
     def get_locator