testcentricity_web 3.0.20 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e3b8fe8d95173d598c24d3537c293f21da627eb0
-  data.tar.gz: 58de63e3525101ce846970603a55a89323d4d055
+  metadata.gz: b1f090325a684cd5d9944d021391a2919efabcc6
+  data.tar.gz: 961cc9979f42aec5554254812365bf81ad3cbbe5
 SHA512:
-  metadata.gz: 2051e9f2f1c2b0abafa66cac87a325cf4f2c426e4a167028d8cba15cd2098e9a2c0f7f11e17340e5169772e04a1773a8129c72b961999f8b37aa6d89d5fe600e
-  data.tar.gz: ccea7de027af0c5655a536d22395ef4987954b202995d66aea1c0a638bde1db9a5d0ca4bb9b4f611acfde8509cd29ddba6ea96183e21f2c8150b43fdb4bccdd2
+  metadata.gz: 6cad0f6ae2b183661acc9cf1769fb649dfe61db3a30dd1323a1434b2d9973fae183c69423ebc235aa31efb3545aaee76d5e9a90ce6f3e030e63be865fec43944
+  data.tar.gz: 02d5753fe6b347e868144d3e1cee790ad8c0ddbc90075a773d5cfa367f0a8d5a2dbf80f2f9b7f74c8a8e4c126a44e232a114d292fad815b69efd8f4da160eb88

data/CHANGELOG.md

@@ -2,6 +2,23 @@
 All notable changes to this project will be documented in this file.
 
 
+## [3.1.0] - 2018-11-10
+
+### Added
+* Adding greater support for WCAG 2.x accessibility testing and verification:
+* `UIElement.role` method.
+* `UIElement.tabindex` method.
+* `UIElement.aria_labelledby` method.
+* `UIElement.aria_describedby` method.
+* `UIElement.aria_live` method.
+* `UIElement.aria_selected?` method.
+* `UIElement.aria_hidden?` method.
+* `UIElement.aria_expanded?` method.
+* `UIElement.aria_required?` method.
+* Updated `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods to support verification of `role`, `tabindex`, `aria-labelledby`,
+`aria-describedby`, `aria-live`, `aria-selected`, `aria-hidden`, `aria-expanded`, and `aria-required` properties.
+
+
 ## [3.0.20] - 2018-11-08
 
 ### Changed

data/Gemfile.lock

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

data/README.md

@@ -494,9 +494,21 @@ With TestCentricity, all UI elements are based on the **UIElement** class, and i
     element.y
     element.get_attribute(attrib)
     element.get_native_attribute(attrib)
+
+**Object Accessibility methods:**
+
     element.aria_disabled?
     element.aria_label
-    
+    element.role
+    element.tabindex
+    element.aria_labelledby
+    element.aria_describedby
+    element.aria_live
+    element.aria_selected?
+    element.aria_hidden?
+    element.aria_expanded?
+    element.aria_required?
+
 **Waiting methods:**
 
     element.wait_until_exists(seconds)

data/lib/testcentricity_web/data_objects/environment.rb

@@ -47,6 +47,8 @@ module TestCentricity
     attr_accessor :portal_context
     attr_accessor :external_page
 
+    attr_accessor :a11y_standard
+
     attr_accessor :protocol
     attr_accessor :hostname
     attr_accessor :base_url
@@ -60,17 +62,19 @@ module TestCentricity
     attr_accessor :db_password
 
     def initialize(data)
-      @protocol    = data['PROTOCOL']
-      @hostname    = data['HOST_NAME']
-      @base_url    = data['BASE_URL']
-      @user_id	   = data['USER_ID']
-      @password	   = data['PASSWORD']
-      @append	     = data['APPEND']
-      @option1	   = data['OPTIONAL_1']
-      @option2	   = data['OPTIONAL_2']
-      @dns	       = data['DNS']
-      @db_username = data['DB_USERNAME']
-      @db_password = data['DB_PASSWORD']
+      @protocol      = data['PROTOCOL']
+      @hostname      = data['HOST_NAME']
+      @base_url      = data['BASE_URL']
+      @user_id	     = data['USER_ID']
+      @password	     = data['PASSWORD']
+      @append	       = data['APPEND']
+      @option1	     = data['OPTIONAL_1']
+      @option2	     = data['OPTIONAL_2']
+      @dns	         = data['DNS']
+      @db_username   = data['DB_USERNAME']
+      @db_password   = data['DB_PASSWORD']
+      @a11y_standard = ENV['ACCESSIBILITY_STANDARD'] || 'best-practice'
+
       super
     end
 
@@ -290,6 +294,7 @@ module TestCentricity
       report_header = "#{report_header}  <b>Locale:</b>\t\t #{ENV['LOCALE']}\n" if ENV['LOCALE']
       report_header = "#{report_header}  <b>Language:</b>\t #{ENV['LANGUAGE']}\n" if ENV['LANGUAGE']
       report_header = "#{report_header}  <b>Country:</b>\t #{ENV['COUNTRY']}\n" if ENV['COUNTRY']
+      report_header = "#{report_header}  <b>WCAG Accessibility Standard:</b>\t #{ENV['ACCESSIBILITY_STANDARD']}\n" if ENV['ACCESSIBILITY_STANDARD']
       "#{report_header}\n\n"
     end
   end

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '3.0.20'
+  VERSION = '3.1.0'
 end

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -664,10 +664,28 @@ module TestCentricity
             actual = ui_object.get_siebel_options
           when :style
             actual = ui_object.style
+          when :role
+            actual = ui_object.role
           when :aria_label
             actual = ui_object.aria_label
           when :aria_disabled
             actual = ui_object.aria_disabled?
+          when :tabindex
+            actual = ui_object.tabindex
+          when :aria_labelledby
+            actual = ui_object.aria_labelledby
+          when :aria_describedby
+            actual = ui_object.aria_describedby
+          when :aria_live
+            actual = ui_object.aria_live
+          when :aria_selected
+            actual = ui_object.aria_selected?
+          when :aria_hidden
+            actual = ui_object.aria_hidden?
+          when :aria_expanded
+            actual = ui_object.aria_expanded?
+          when :aria_required
+            actual = ui_object.aria_required?
           else
             if property.is_a?(Hash)
               property.each do |key, value|

data/lib/testcentricity_web/web_core/page_sections_helper.rb

@@ -864,10 +864,28 @@ module TestCentricity
             actual = ui_object.get_siebel_options
           when :style
             actual = ui_object.style
+          when :role
+            actual = ui_object.role
           when :aria_label
             actual = ui_object.aria_label
           when :aria_disabled
             actual = ui_object.aria_disabled?
+          when :tabindex
+            actual = ui_object.tabindex
+          when :aria_labelledby
+            actual = ui_object.aria_labelledby
+          when :aria_describedby
+            actual = ui_object.aria_describedby
+          when :aria_live
+            actual = ui_object.aria_live
+          when :aria_selected
+            actual = ui_object.aria_selected?
+          when :aria_hidden
+            actual = ui_object.aria_hidden?
+          when :aria_expanded
+            actual = ui_object.aria_expanded?
+          when :aria_required
+            actual = ui_object.aria_required?
           else
             if property.is_a?(Hash)
               property.each do |key, value|

data/lib/testcentricity_web/web_elements/ui_elements_helper.rb

@@ -566,6 +566,26 @@ module TestCentricity
       get_attribute('style')
     end
 
+    # Return state of UI object's role property
+    #
+    # @return [String]
+    # @example
+    #   buy_now_button.role
+    #
+    def role
+      get_attribute('role')
+    end
+
+    # Return state of UI object's tabindex property
+    #
+    # @return [String]
+    # @example
+    #   buy_now_button.tabindex
+    #
+    def tabindex
+      get_attribute('tabindex')
+    end
+
     # Return state of UI object's aria-label property
     #
     # @return [String]
@@ -576,6 +596,36 @@ module TestCentricity
       get_attribute('aria-label')
     end
 
+    # Return state of UI object's aria-labelledby property
+    #
+    # @return [String]
+    # @example
+    #   buy_now_button.aria_labelledby
+    #
+    def aria_labelledby
+      get_attribute('aria-labelledby')
+    end
+
+    # Return state of UI object's aria-describedby property
+    #
+    # @return [String]
+    # @example
+    #   buy_now_button.aria_describedby
+    #
+    def aria_describedby
+      get_attribute('aria-describedby')
+    end
+
+    # Return state of UI object's aria-live property
+    #
+    # @return [String]
+    # @example
+    #   properties_list.aria_live
+    #
+    def aria_live
+      get_attribute('aria-live')
+    end
+
     # Return state of UI object's aria-disabled property
     #
     # @return [Boolean]
@@ -587,6 +637,50 @@ module TestCentricity
       state.boolean? ? state : state == 'true'
     end
 
+    # Return state of UI object's aria-selected property
+    #
+    # @return [Boolean]
+    # @example
+    #   nutrition_info_tab.aria_selected?
+    #
+    def aria_selected?
+      state = get_attribute('aria-selected')
+      state.boolean? ? state : state == 'true'
+    end
+
+    # Return state of UI object's aria-hidden property
+    #
+    # @return [Boolean]
+    # @example
+    #   nutrition_info_tab.aria_hidden?
+    #
+    def aria_hidden?
+      state = get_attribute('aria-hidden')
+      state.boolean? ? state : state == 'true'
+    end
+
+    # Return state of UI object's aria-expanded property
+    #
+    # @return [Boolean]
+    # @example
+    #   catalog_tree.aria_expanded?
+    #
+    def aria_expanded?
+      state = get_attribute('aria-expanded')
+      state.boolean? ? state : state == 'true'
+    end
+
+    # Return state of UI object's aria-required property
+    #
+    # @return [Boolean]
+    # @example
+    #   home_phone_field.aria_required?
+    #
+    def aria_required?
+      state = get_attribute('aria-required')
+      state.boolean? ? state : state == 'true'
+    end
+
     def get_attribute(attrib)
       obj, type = find_element(false)
       object_not_found_exception(obj, type)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 3.0.20
+  version: 3.1.0
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-08 00:00:00.000000000 Z
+date: 2018-11-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler