testcentricity_web 3.0.9 → 3.0.10

data/lib/testcentricity_web/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityWeb
-  VERSION = '3.0.9'
+  VERSION = '3.0.10'
 end

data/lib/testcentricity_web/web_core/page_objects_helper.rb

@@ -517,7 +517,7 @@ module TestCentricity
     #   home_page.secure?
     #
     def secure?
-      !current_url.match(/^https/).nil?
+      current_url.start_with?('https')
     end
 
     def verify_ui_states(ui_states, fail_message = nil)
@@ -568,6 +568,10 @@ module TestCentricity
             actual = ui_object.get_max
           when :step
             actual = ui_object.get_step
+          when :loaded
+            actual = ui_object.loaded?
+          when :broken
+            actual = ui_object.broken?
           when :options, :items, :list_items
             actual = ui_object.get_list_items
           when :optioncount, :itemcount
@@ -618,7 +622,7 @@ module TestCentricity
             end
           end
           error_msg = "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) #{property} property to"
-          ExceptionQueue.enqueue_comparison(state, actual, error_msg)
+          ExceptionQueue.enqueue_comparison(ui_object, state, actual, error_msg)
         end
       end
     rescue ObjectNotFoundError => e

data/lib/testcentricity_web/web_core/page_sections_helper.rb

@@ -13,8 +13,8 @@ module TestCentricity
     attr_accessor :list_index
     attr_accessor :locator_type
 
-    XPATH_SELECTORS = ['//', '[@', '[contains(@']
-    CSS_SELECTORS   = ['#', ':nth-child(', ':nth-of-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
@@ -743,6 +743,10 @@ module TestCentricity
             actual = ui_object.get_max
           when :step
             actual = ui_object.get_step
+          when :loaded
+            actual = ui_object.loaded?
+          when :broken
+            actual = ui_object.broken?
           when :options, :items, :list_items
             actual = ui_object.get_list_items
           when :optioncount, :itemcount
@@ -793,7 +797,7 @@ module TestCentricity
             end
           end
           error_msg = "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) #{property} property to"
-          ExceptionQueue.enqueue_comparison(state, actual, error_msg)
+          ExceptionQueue.enqueue_comparison(ui_object, state, actual, error_msg)
         end
       end
     rescue ObjectNotFoundError => e
@@ -874,7 +878,7 @@ module TestCentricity
 
     def find_section
       locator = get_locator
-      locator = locator.gsub('|', ' ')
+      locator = locator.tr('|', ' ')
       obj = page.find(@locator_type, locator, wait: 0.1)
       [obj, @locator_type]
     rescue

data/lib/testcentricity_web/web_elements/image.rb

@@ -11,12 +11,30 @@ module TestCentricity
     # @example
     #   company_logo_image.is_loaded??
     #
-    def is_loaded?
+    def loaded?
       obj, = find_element
       object_not_found_exception(obj, nil)
       obj.native.attribute('complete')
     end
 
+    alias is_loaded? loaded?
+
+    # Is image broken?
+    #
+    # @return [Boolean]
+    # @example
+    #   company_logo_image.broken???
+    #
+    def broken?
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      result = page.execute_script(
+        'return arguments[0].complete && typeof arguments[0].naturalWidth != "undefined" && arguments[0].naturalWidth > 0',
+        obj
+      )
+      !result
+    end
+
     # Wait until the image is fully loaded, or until the specified wait time has expired.
     #
     # @param seconds [Integer or Float] wait time in seconds

data/lib/testcentricity_web/web_elements/table.rb

@@ -15,13 +15,13 @@ module TestCentricity
       @type = :table
 
       table_spec = {
-          table_body:    'tbody',
-          table_section: nil,
-          table_row:     'tr',
-          table_column:  'td',
-          table_header:  'thead',
-          header_row:    'tr',
-          header_column: 'th'
+        table_body:    'tbody',
+        table_section: nil,
+        table_row:     'tr',
+        table_column:  'td',
+        table_header:  'thead',
+        header_row:    'tr',
+        header_column: 'th'
       }
 
       case @locator_type

data/lib/testcentricity_web/web_elements/ui_elements_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'test/unit'
 
 Capybara::Node::Element.class_eval do
@@ -35,18 +37,19 @@ module TestCentricity
     include Test::Unit::Assertions
 
     attr_reader   :parent, :locator, :context, :type, :name
-    attr_accessor :alt_locator, :locator_type
+    attr_accessor :alt_locator, :locator_type, :original_style
 
-    XPATH_SELECTORS = ['//', '[@', '[contains(@']
-    CSS_SELECTORS   = ['#', ':nth-child(', ':nth-of-type(', '^=', '$=', '*=']
+    XPATH_SELECTORS = ['//', '[@', '[contains('].freeze
+    CSS_SELECTORS   = ['#', ':nth-child(', ':first-child', ':last-child', ':nth-of-type(', ':first-of-type', ':last-of-type', '^=', '$=', '*=', ':contains('].freeze
 
     def initialize(name, parent, locator, context)
-      @name        = name
-      @parent      = parent
-      @locator     = locator
-      @context     = context
-      @type        = nil
-      @alt_locator = nil
+      @name           = name
+      @parent         = parent
+      @locator        = locator
+      @context        = context
+      @type           = nil
+      @alt_locator    = nil
+      @original_style = nil
       set_locator_type
     end
 
@@ -105,7 +108,7 @@ module TestCentricity
       object_not_found_exception(obj, type)
       begin
         obj.click
-      rescue
+      rescue StandardError
         obj.click_at(10, 10) unless Capybara.current_driver == :poltergeist
       end
     end
@@ -249,7 +252,7 @@ module TestCentricity
       timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { exists? }
-    rescue
+    rescue StandardError
       raise "Could not find UI #{object_ref_message} after #{timeout} seconds" unless exists?
     end
 
@@ -264,7 +267,7 @@ module TestCentricity
       timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { !exists? }
-    rescue
+    rescue StandardError
       raise "UI #{object_ref_message} remained visible after #{timeout} seconds" if exists?
     end
 
@@ -279,7 +282,7 @@ module TestCentricity
       timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { visible? }
-    rescue
+    rescue StandardError
       raise "Could not find UI #{object_ref_message} after #{timeout} seconds" unless visible?
     end
 
@@ -294,7 +297,7 @@ module TestCentricity
       timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { hidden? }
-    rescue
+    rescue StandardError
       raise "UI #{object_ref_message} remained visible after #{timeout} seconds" if visible?
     end
 
@@ -312,7 +315,7 @@ module TestCentricity
       timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { compare(value, get_value) }
-    rescue
+    rescue StandardError
       raise "Value of UI #{object_ref_message} failed to equal '#{value}' after #{timeout} seconds" unless get_value == value
     end
 
@@ -328,7 +331,7 @@ module TestCentricity
       timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
       wait = Selenium::WebDriver::Wait.new(timeout: timeout)
       wait.until { get_value != value }
-    rescue
+    rescue StandardError
       raise "Value of UI #{object_ref_message} failed to change from '#{value}' after #{timeout} seconds" if get_value == value
     end
 
@@ -442,6 +445,54 @@ module TestCentricity
       page.driver.browser.action.move_to(target_drop.native, right_offset.to_i, down_offset.to_i).release.perform
     end
 
+    # Highlight an object with a 3 pixel wide, red dashed border for the specified wait time.
+    # If wait time is zero, then the highlight will remain until the page is refreshed
+    #
+    # @param seconds [Integer or Float] wait time in seconds
+    # @example
+    #   error_message.highlight(3)
+    #
+    def highlight(duration = 1)
+      obj, type = find_element
+      object_not_found_exception(obj, type)
+      # store original style so it can be reset later
+      @original_style = obj.native.attribute('style')
+      # style element with red border
+      page.execute_script(
+        'arguments[0].setAttribute(arguments[1], arguments[2])',
+        obj,
+        'style',
+        'border: 3px solid red; border-style: dashed;'
+      )
+      # keep element highlighted for duration and then revert to original style
+      if duration.positive?
+        sleep duration
+        page.execute_script(
+          'arguments[0].setAttribute(arguments[1], arguments[2])',
+          obj,
+          'style',
+          @original_style
+        )
+      end
+    end
+
+    # Restore a highlighted object's original style
+    #
+    # @example
+    #   store_link.unhighlight
+    #
+    def unhighlight
+      obj, type = find_element
+      object_not_found_exception(obj, type)
+      return if @original_style.nil?
+      page.execute_script(
+        'arguments[0].setAttribute(arguments[1], arguments[2])',
+        obj,
+        'style',
+        @original_style
+      )
+    end
+
     def get_attribute(attrib)
       obj, type = find_element(false)
       object_not_found_exception(obj, type)
@@ -462,33 +513,33 @@ module TestCentricity
     end
 
     def find_object(visible = true)
-      @alt_locator.nil? ? obj_locator = @locator : obj_locator = @alt_locator
+      obj_locator = @alt_locator.nil? ? @locator : @alt_locator
       parent_section = @context == :section && !@parent.get_locator.nil?
-      parent_section ? tries ||= 2 : tries ||= 1
+      tries ||= parent_section ? 2 : 1
 
       if parent_section && tries > 1
         parent_locator = @parent.get_locator
-        parent_locator = parent_locator.gsub('|', ' ')
+        parent_locator = parent_locator.tr('|', ' ')
         parent_locator_type = @parent.get_locator_type
         obj = page.find(parent_locator_type, parent_locator, wait: 0.01).find(@locator_type, obj_locator, wait: 0.01, visible: visible)
       else
         obj = page.find(@locator_type, obj_locator, wait: 0.01, visible: visible)
       end
       [obj, @locator_type]
-    rescue
+    rescue StandardError
       retry if (tries -= 1) > 0
       [nil, nil]
     end
 
     def object_not_found_exception(obj, obj_type)
-      @alt_locator.nil? ? locator = @locator : locator = @alt_locator
-      obj_type.nil? ? object_type = 'Object' : object_type = obj_type
-      raise ObjectNotFoundError.new("#{object_type} named '#{@name}' (#{locator}) not found") unless obj
+      locator = @alt_locator.nil? ? @locator : @alt_locator
+      object_type = obj_type.nil? ? 'Object' : obj_type
+      raise ObjectNotFoundError, "#{object_type} named '#{@name}' (#{locator}) not found" unless obj
     end
 
     def invalid_object_type_exception(obj, obj_type)
       unless obj.tag_name == obj_type || obj.native.attribute('type') == obj_type
-        @alt_locator.nil? ? locator = @locator : locator = @alt_locator
+        locator = @alt_locator.nil? ? @locator : @alt_locator
         raise "#{locator} is not a #{obj_type} element"
       end
     end

data/my_templates/default/method_details/setup.rb

@@ -0,0 +1,3 @@
+def source
+  return
+end

data/testcentricity_web.gemspec

@@ -15,12 +15,12 @@ Gem::Specification.new do |spec|
     The TestCentricity™ Web core generic framework for desktop and mobile web browser-based applications testing implements
     a Page Object Model DSL for use with Cucumber, Capybara, and Selenium-Webdriver. The gem provides support for running
     automated tests against locally hosted desktop browsers, locally hosted emulated mobile browsers (iOS, Android, Windows
-    Phone, Blackberry, Kindle Fire) running within a locally hosted instance of Chrome, mobile Safari browsers on iOS device
-    simulators or physical iOS devices (using Appium and XCode on OS X), mobile Chrome or Android browsers on Android Studio
-    virtual device emulators (using Appium and Android Studio on OS X), or cloud hosted desktop or mobile web browsers (using
-    the BrowserStack, Sauce Labs, CrossBrowserTesting, TestingBot, or Gridlastic services).}
+    Phone, Blackberry, Kindle Fire) running within a local instance of Chrome, mobile Safari browsers on iOS device simulators
+     or physical iOS devices (using Appium and XCode on OS X), mobile Chrome or Android browsers on Android Studio virtual
+    device emulators (using Appium and Android Studio on OS X), or cloud hosted desktop or mobile web browsers (using the
+    BrowserStack, Sauce Labs, CrossBrowserTesting, TestingBot, or Gridlastic services).}
   spec.homepage      = ''
-  spec.license       = 'BSD3'
+  spec.license       = 'BSD-3-Clause'
 
   spec.files         = `git ls-files -z`.split("\x0")
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
@@ -31,16 +31,16 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'bundler', '~> 1.5'
   spec.add_development_dependency 'rake'
 
+  spec.add_runtime_dependency 'appium_lib'
+  spec.add_runtime_dependency 'browserstack-local'
   spec.add_runtime_dependency 'capybara', '>= 3.1', '< 4'
-  spec.add_runtime_dependency 'test-unit'
-  spec.add_runtime_dependency 'selenium-webdriver', ['>= 3.11.0', '< 4.0']
-  spec.add_runtime_dependency 'faker'
+  spec.add_runtime_dependency 'childprocess', '~> 0.5'
   spec.add_runtime_dependency 'chronic', '0.10.2'
-  spec.add_runtime_dependency 'spreadsheet', '1.1.1'
-  spec.add_runtime_dependency 'os', '~> 1.0'
+  spec.add_runtime_dependency 'faker'
   spec.add_runtime_dependency 'i18n'
-  spec.add_runtime_dependency 'browserstack-local'
-  spec.add_runtime_dependency 'appium_lib'
+  spec.add_runtime_dependency 'os', '~> 1.0'
+  spec.add_runtime_dependency 'selenium-webdriver', ['>= 3.11.0', '< 4.0']
+  spec.add_runtime_dependency 'spreadsheet', '1.1.7'
+  spec.add_runtime_dependency 'test-unit'
   spec.add_runtime_dependency 'webdrivers', '~> 3.3'
-  spec.add_runtime_dependency 'childprocess', '~> 0.5'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 3.0.9
+  version: 3.0.10
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-05 00:00:00.000000000 Z
+date: 2018-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -39,27 +39,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: capybara
+  name: appium_lib
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.1'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '4'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.1'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '4'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: test-unit
+  name: browserstack-local
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -73,39 +67,39 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: selenium-webdriver
+  name: capybara
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.11.0
+        version: '3.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.11.0
+        version: '3.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '4'
 - !ruby/object:Gem::Dependency
-  name: faker
+  name: childprocess
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: chronic
   requirement: !ruby/object:Gem::Requirement
@@ -121,19 +115,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.10.2
 - !ruby/object:Gem::Dependency
-  name: spreadsheet
+  name: faker
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.1
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.1
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: os
   requirement: !ruby/object:Gem::Requirement
@@ -149,35 +157,41 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: i18n
+  name: selenium-webdriver
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 3.11.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 3.11.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
 - !ruby/object:Gem::Dependency
-  name: browserstack-local
+  name: spreadsheet
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.1.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.1.7
 - !ruby/object:Gem::Dependency
-  name: appium_lib
+  name: test-unit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -204,29 +218,15 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.3'
-- !ruby/object:Gem::Dependency
-  name: childprocess
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
 description: |2-
 
       The TestCentricity™ Web core generic framework for desktop and mobile web browser-based applications testing implements
       a Page Object Model DSL for use with Cucumber, Capybara, and Selenium-Webdriver. The gem provides support for running
       automated tests against locally hosted desktop browsers, locally hosted emulated mobile browsers (iOS, Android, Windows
-      Phone, Blackberry, Kindle Fire) running within a locally hosted instance of Chrome, mobile Safari browsers on iOS device
-      simulators or physical iOS devices (using Appium and XCode on OS X), mobile Chrome or Android browsers on Android Studio
-      virtual device emulators (using Appium and Android Studio on OS X), or cloud hosted desktop or mobile web browsers (using
-      the BrowserStack, Sauce Labs, CrossBrowserTesting, TestingBot, or Gridlastic services).
+      Phone, Blackberry, Kindle Fire) running within a local instance of Chrome, mobile Safari browsers on iOS device simulators
+       or physical iOS devices (using Appium and XCode on OS X), mobile Chrome or Android browsers on Android Studio virtual
+      device emulators (using Appium and Android Studio on OS X), or cloud hosted desktop or mobile web browsers (using the
+      BrowserStack, Sauce Labs, CrossBrowserTesting, TestingBot, or Gridlastic services).
 email:
 - testcentricity@gmail.com
 executables: []
@@ -239,10 +239,15 @@ files:
 - ".idea/misc.xml"
 - ".idea/modules.xml"
 - ".idea/vcs.xml"
+- ".rspec"
 - ".rubocop.yml"
+- ".ruby-gemset"
+- ".ruby-version"
 - ".yardopts"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
 - Gemfile
-- HISTORY.md
+- Gemfile.lock
 - LICENSE.md
 - README.md
 - Rakefile
@@ -283,10 +288,11 @@ files:
 - lib/testcentricity_web/web_elements/textfield.rb
 - lib/testcentricity_web/web_elements/ui_elements_helper.rb
 - lib/testcentricity_web/world_extensions.rb
+- my_templates/default/method_details/setup.rb
 - testcentricity_web.gemspec
 homepage: ''
 licenses:
-- BSD3
+- BSD-3-Clause
 metadata: {}
 post_install_message: 
 rdoc_options: []