testcentricity_web 4.1.3 → 4.1.6

data/features/support/pages/basic_test_page.rb

@@ -0,0 +1,238 @@
+# Page Object class definition for Basic HTML Test page
+
+class BasicTestPage < TestCentricity::PageObject
+  trait(:page_url)         { '/basic_test_page.html' }
+  trait(:tab_order)        {
+    [
+      username_field,
+      password_field,
+      max_length_field,
+      read_only_field,
+      number_field,
+      color_picker,
+      slider,
+      comments_field,
+      upload_file,
+      check_1,
+      check_2,
+      check_3,
+      radio_1,
+      [
+        radio_2,
+        radio_3
+      ],
+      multi_select,
+      drop_down_select,
+      cancel_button,
+      submit_button
+    ]
+  }
+  trait(:safari_tab_order) {
+    [
+      username_field,
+      password_field,
+      max_length_field,
+      read_only_field,
+      number_field,
+      comments_field,
+      multi_select,
+      drop_down_select
+    ]
+  }
+
+  def verify_page_ui
+    ui = {
+      self              => { exists: true, secure: false, title: 'Basic HTML Form' },
+      header_label      => { visible: true, caption: 'Basic HTML Form Example' },
+      username_label    => { visible: true, caption: 'Username:' },
+      username_field    => { visible: true, enabled: true, required: true, value: '', placeholder: 'User name' },
+      password_label    => { visible: true, caption: 'Password:' },
+      password_field    => { visible: true, enabled: true, required: true, value: '', placeholder: 'Password' },
+      max_length_label  => { visible: true, caption: 'Max Length:' },
+      max_length_field  => {
+        visible: true,
+        enabled: true,
+        placeholder: 'up to 64 characters',
+        value: '',
+        maxlength: 64
+      },
+      read_only_label   => { visible: true, caption: 'Read Only:' },
+      read_only_field   => {
+        visible: true,
+        enabled: true,
+        readonly: true,
+        value: 'I am a read only text field'
+      },
+      number_label      => { visible: true, caption: 'Number:' },
+      number_field      => {
+        visible: true,
+        enabled: true,
+        value: '41',
+        min: 10,
+        max: 1024,
+        step: 1
+      },
+      color_label       => { visible: true, caption: 'Color:' },
+      color_picker      => { visible: true, enabled: true, value: '#000000' },
+      slider_label      => { visible: true, caption: 'Range:' },
+      slider            => {
+        visible: true,
+        enabled: true,
+        value: 25,
+        min: 0,
+        max: 50,
+      },
+      comments_label    => { visible: true, caption: 'TextArea:' },
+      comments_field    => { visible: true, enabled: true, value: '' },
+      filename_label    => { visible: true, caption: 'Filename:' },
+      upload_file       => { visible: true, enabled: true, value: '' },
+      checkboxes_label  => { visible: true, caption: 'Checkbox Items:' },
+      check_1           => { visible: true, enabled: true, checked: false },
+      check_2           => { visible: true, enabled: true, checked: false },
+      check_3           => { visible: true, enabled: true, checked: false },
+      check_4           => { visible: true, enabled: false, checked: false },
+      radios_label      => { visible: true, caption: 'Radio Items:' },
+      radio_1           => { visible: true, enabled: true, selected: false },
+      radio_2           => { visible: true, enabled: true, selected: false },
+      radio_3           => { visible: true, enabled: true, selected: false },
+      radio_4           => { visible: true, enabled: false, selected: false },
+      multiselect_label => { visible: true, caption: 'Multiple Select Values:' },
+      multi_select      => {
+        visible: true,
+        enabled: true,
+        optioncount: 4,
+        options: ['Selection Item 1', 'Selection Item 2', 'Selection Item 3', 'Selection Item 4'],
+        selected: ''
+      },
+      dropdown_label    => { visible: true, caption: 'Dropdown:' },
+      drop_down_select  => {
+        visible: true,
+        enabled: true,
+        optioncount: 6,
+        options: ['Drop Down Item 1', 'Drop Down Item 2', 'Drop Down Item 3', 'Drop Down Item 4', 'Drop Down Item 5', 'Drop Down Item 6'],
+        selected: 'Drop Down Item 1'
+      },
+      table_label       => { visible: true, caption: 'Table:' },
+      static_table      => {
+        visible: true,
+        columncount: 3,
+        rowcount: 4,
+        column_headers: %w[Company Contact Country],
+        { row: 1 } => [['Alfreds Futterkiste', 'Maria Anders', 'Germany']],
+        { row: 2 } => [['Centro comercial Moctezuma', 'Francisco Chang', 'Mexico']],
+        { row: 3 } => [['Ernst Handel', 'Roland Mendel', 'Austria']],
+        { row: 4 } => [['Island Trading', 'Helen Bennett', 'UK']]
+      },
+      images_label      => { visible: true, caption: 'Images:' },
+      image_1           => {
+        visible: true,
+        broken: false,
+        src: { ends_with: 'images/Wilder.jpg' },
+        alt: "It's alive"
+      },
+      image_2           => {
+        visible: true,
+        broken: false,
+        src: { ends_with: 'images/You_Betcha.jpg' },
+        alt: 'You Betcha'
+      },
+      image_3           => {
+        visible: true,
+        broken: true,
+        src: { ends_with: 'wrongname.gif' },
+        alt: 'A broken image'
+      },
+      cancel_button     => { visible: true, enabled: true, caption: 'Cancel' },
+      submit_button     => { visible: true, enabled: true, caption: 'Submit' }
+    }
+    verify_ui_states(ui)
+  end
+
+  def form_data
+    file_path = Environ.platform == :mobile ? nil : "#{Dir.pwd}/test_site/images/Wilder.jpg"
+    {
+      username:     Faker::Name.name,
+      password:     'T0p_Sekrit',
+      maxlength:    Faker::Marketing.buzzwords,
+      number:       Faker::Number.between(from: 10, to: 1024),
+      color:        Faker::Color.hex_color,
+      slider:       45,
+      comments:     Faker::Hipster.paragraph,
+      filepath:     file_path,
+      filename:     "Wilder.jpg",
+      check1:       true,
+      check2:       true,
+      check3:       false,
+      radio1:       true,
+      radio2:       false,
+      radio3:       false,
+      multi_select: 'Selection Item 2',
+      drop_select:  'Drop Down Item 5'
+    }
+  end
+
+  def populate_form
+    @data = form_data
+    fields = {
+      username_field   => @data[:username],
+      password_field   => @data[:password],
+      max_length_field => @data[:maxlength],
+      number_field     => @data[:number],
+      color_picker     => @data[:color],
+      slider           => @data[:slider],
+      comments_field   => @data[:comments],
+      upload_file      => @data[:filepath],
+      check_1          => @data[:check1],
+      check_2          => @data[:check2],
+      check_3          => @data[:check3],
+      radio_1          => @data[:radio1],
+      radio_2          => @data[:radio2],
+      radio_3          => @data[:radio3],
+      multi_select     => @data[:multi_select],
+      drop_down_select => @data[:drop_select]
+    }
+    populate_data_fields(fields)
+  end
+
+  def verify_form_data
+    ui = {
+      username_field   => { value: @data[:username] },
+      password_field   => { value: @data[:password] },
+      max_length_field => { value: @data[:maxlength] },
+      number_field     => { value: @data[:number].to_s },
+      color_picker     => { value: @data[:color] },
+      slider           => { value: @data[:slider] },
+      comments_field   => { value: @data[:comments] },
+      upload_file      => { value: { ends_with: @data[:filename] } },
+      check_1          => { checked: @data[:check1] },
+      check_2          => { checked: @data[:check2] },
+      check_3          => { checked: @data[:check3] },
+      radio_1          => { selected: @data[:radio1] },
+      radio_2          => { selected: @data[:radio2] },
+      radio_3          => { selected: @data[:radio3] },
+      multi_select     => { selected: @data[:multi_select] },
+      drop_down_select => { selected: @data[:drop_select] }
+    }
+    verify_ui_states(ui)
+  end
+
+  def perform_action(action)
+    case action
+    when :submit
+      submit_button.click
+    when :cancel
+      cancel_button.click
+    else
+      raise "#{action} is not a valid selector"
+    end
+  end
+
+  def verify_tab_order
+    order = if Environ.browser == :safari
+              safari_tab_order
+            else
+              tab_order
+            end
+    verify_focus_order(order)
+  end
+end

data/features/support/pages/basic_xpath_test_page.rb

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

data/features/support/pages/media_page.rb

@@ -0,0 +1,11 @@
+# Page Object class definition for Media Test page with CSS locators
+
+class MediaTestPage < TestCentricity::PageObject
+  trait(:page_name)    { 'Media Test' }
+  trait(:page_locator) { 'div.media-page-body' }
+  trait(:page_url)     { '/media_page.html' }
+
+  # Media Test page UI elements
+  video :video_player, 'video#video_player'
+  audio :audio_player, 'audio#audio_player'
+end

data/features/support/world_pages.rb

@@ -0,0 +1,15 @@
+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,
+    }
+  end
+end
+
+
+World(WorldPages)

data/lib/testcentricity_web/data_objects/environment.rb

@@ -328,6 +328,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.3'
+  VERSION = '4.1.6'
 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)
@@ -310,17 +314,20 @@ module TestCentricity
     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
+      full_url = if environment.user_id.blank? || environment.password.blank?
+                   "#{environment.protocol}://#{url}"
+                 else
+                   "#{environment.protocol}://#{environment.user_id}:#{environment.password}@#{url}"
+                 end
+      visit full_url
       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