testcentricity_web 4.3.0 → 4.4.0

data/lib/testcentricity_web/web_elements/audio.rb

@@ -1,8 +1,10 @@
 module TestCentricity
-  class Audio < Media
-    def initialize(name, parent, locator, context)
-      super
-      @type = :audio
+  module Elements
+    class Audio < Media
+      def initialize(name, parent, locator, context)
+        super
+        @type = :audio
+      end
     end
   end
 end

data/lib/testcentricity_web/web_elements/button.rb

@@ -1,8 +1,11 @@
 module TestCentricity
-  class Button < UIElement
-    def initialize(name, parent, locator, context)
-      super
-      @type = :button
+  module Elements
+    class Button < UIElement
+      def initialize(name, parent, locator, context)
+        super
+        @type = :button
+      end
     end
   end
 end
+

data/lib/testcentricity_web/web_elements/checkbox.rb

@@ -1,181 +1,183 @@
 module TestCentricity
-  class CheckBox < UIElement
-    attr_accessor :proxy
-    attr_accessor :label
-    attr_accessor :input
+  module Elements
+    class CheckBox < UIElement
+      attr_accessor :proxy
+      attr_accessor :label
+      attr_accessor :input
 
-    def initialize(name, parent, locator, context)
-      super
-      @type = :checkbox
-      check_spec = {
-        input: nil,
-        proxy: nil,
-        label: nil
-      }
-      define_custom_elements(check_spec)
-    end
+      def initialize(name, parent, locator, context)
+        super
+        @type = :checkbox
+        check_spec = {
+          input: nil,
+          proxy: nil,
+          label: nil
+        }
+        define_custom_elements(check_spec)
+      end
 
-    def define_custom_elements(element_spec)
-      element_spec.each do |element, value|
-        case element
-        when :input
-          @input = value
-        when :proxy
-          @proxy = value
-        when :label
-          @label = value
-        else
-          raise "#{element} is not a recognized checkbox element"
+      def define_custom_elements(element_spec)
+        element_spec.each do |element, value|
+          case element
+          when :input
+            @input = value
+          when :proxy
+            @proxy = value
+          when :label
+            @label = value
+          else
+            raise "#{element} is not a recognized checkbox element"
+          end
         end
       end
-    end
-
-    # Does checkbox object exists?
-    #
-    # @return [Boolean]
-    # @example
-    #   remember_me_checkbox.exists?
-    #
-    def exists?
-      obj, = find_object(:all)
-      obj != nil
-    end
-
-    # Is checkbox checked?
-    #
-    # @return [Boolean]
-    # @example
-    #   remember_me_checkbox.checked?
-    #
-    def checked?
-      @base_object, = find_element(:all)
-      object_not_found_exception(@base_object, 'Checkbox')
-      chk = if @input.nil?
-              @base_object
-            else
-              find_component(@input, 'checkbox')
-            end
-      chk.checked?
-    end
 
-    # Is checkbox state indeterminate?
-    #
-    # @return [Boolean]
-    # @example
-    #   remember_me_checkbox.indeterminate?
-    #
-    def indeterminate?
-      state = get_attribute('indeterminate')
-      state.boolean? ? state : state == 'true'
-    end
+      # Does checkbox object exists?
+      #
+      # @return [Boolean]
+      # @example
+      #   remember_me_checkbox.exists?
+      #
+      def exists?
+        obj, = find_object(:all)
+        obj != nil
+      end
 
-    # Is checkbox visible?
-    #
-    # @return [Boolean]
-    # @example
-    #   remember_me_checkbox.visible?
-    #
-    def visible?
-      if @proxy.nil?
-        super
-      else
+      # Is checkbox checked?
+      #
+      # @return [Boolean]
+      # @example
+      #   remember_me_checkbox.checked?
+      #
+      def checked?
         @base_object, = find_element(:all)
         object_not_found_exception(@base_object, 'Checkbox')
-        proxy = find_component(@proxy, 'checkbox proxy')
-        proxy.visible?
+        chk = if @input.nil?
+                @base_object
+              else
+                find_component(@input, 'checkbox')
+              end
+        chk.checked?
       end
-    end
 
-    # Is checkbox disabled (not enabled)?
-    #
-    # @return [Boolean]
-    # @example
-    #   remember_me_checkbox.disabled?
-    #
-    def disabled?
-      if @input.nil?
-        super
-      else
-        @base_object, = find_element(:all)
-        object_not_found_exception(@base_object, 'Checkbox')
-        chk = find_component(@input, 'checkbox')
-        chk.disabled?
+      # Is checkbox state indeterminate?
+      #
+      # @return [Boolean]
+      # @example
+      #   remember_me_checkbox.indeterminate?
+      #
+      def indeterminate?
+        state = get_attribute('indeterminate')
+        state.boolean? ? state : state == 'true'
       end
-    end
 
-    # Return checkbox caption
-    #
-    # @return [Boolean]
-    # @example
-    #   remember_me_checkbox.get_value
-    #
-    def get_value
-      if @label.nil?
+      # Is checkbox visible?
+      #
+      # @return [Boolean]
+      # @example
+      #   remember_me_checkbox.visible?
+      #
+      def visible?
         if @proxy.nil?
           super
         else
+          @base_object, = find_element(:all)
+          object_not_found_exception(@base_object, 'Checkbox')
           proxy = find_component(@proxy, 'checkbox proxy')
-          proxy.text
+          proxy.visible?
         end
-      else
-        label = find_component(@label, 'checkbox label')
-        label.text
       end
-    end
 
-    alias get_caption get_value
-    alias caption get_value
-    alias value get_value
+      # Is checkbox disabled (not enabled)?
+      #
+      # @return [Boolean]
+      # @example
+      #   remember_me_checkbox.disabled?
+      #
+      def disabled?
+        if @input.nil?
+          super
+        else
+          @base_object, = find_element(:all)
+          object_not_found_exception(@base_object, 'Checkbox')
+          chk = find_component(@input, 'checkbox')
+          chk.disabled?
+        end
+      end
 
-    # Set the check state of a checkbox object.
-    #
-    # @param state [Boolean] true = checked / false = unchecked
-    # @example
-    #   remember_me_checkbox.set_checkbox_state(true)
-    #
-    def set_checkbox_state(state)
-      @base_object, = find_element(:all)
-      object_not_found_exception(@base_object, 'Checkbox')
-      proxy = find_component(@proxy, 'checkbox proxy') unless @proxy.nil?
-      chk = find_component(@input, 'checkbox') unless @input.nil?
-      if @input.nil?
-        if @proxy.nil?
-          @base_object.click unless state == @base_object.checked?
+      # Return checkbox caption
+      #
+      # @return [Boolean]
+      # @example
+      #   remember_me_checkbox.get_value
+      #
+      def get_value
+        if @label.nil?
+          if @proxy.nil?
+            super
+          else
+            proxy = find_component(@proxy, 'checkbox proxy')
+            proxy.text
+          end
         else
-          proxy.click unless state == @base_object.checked?
+          label = find_component(@label, 'checkbox label')
+          label.text
         end
-      else
-        if @proxy.nil?
-          @base_object.click unless state == chk.checked?
+      end
+
+      alias get_caption get_value
+      alias caption get_value
+      alias value get_value
+
+      # Set the check state of a checkbox object.
+      #
+      # @param state [Boolean] true = checked / false = unchecked
+      # @example
+      #   remember_me_checkbox.set_checkbox_state(true)
+      #
+      def set_checkbox_state(state)
+        @base_object, = find_element(:all)
+        object_not_found_exception(@base_object, 'Checkbox')
+        proxy = find_component(@proxy, 'checkbox proxy') unless @proxy.nil?
+        chk = find_component(@input, 'checkbox') unless @input.nil?
+        if @input.nil?
+          if @proxy.nil?
+            @base_object.click unless state == @base_object.checked?
+          else
+            proxy.click unless state == @base_object.checked?
+          end
         else
-          proxy.click unless state == chk.checked?
+          if @proxy.nil?
+            @base_object.click unless state == chk.checked?
+          else
+            proxy.click unless state == chk.checked?
+          end
         end
       end
-    end
 
-    # Set the check state of a checkbox object.
-    #
-    # @example
-    #   remember_me_checkbox.check
-    #
-    def check
-      set_checkbox_state(true)
-    end
+      # Set the check state of a checkbox object.
+      #
+      # @example
+      #   remember_me_checkbox.check
+      #
+      def check
+        set_checkbox_state(true)
+      end
 
-    # Uncheck a checkbox object.
-    #
-    # @example
-    #   remember_me_checkbox.uncheck
-    #
-    def uncheck
-      set_checkbox_state(state = false)
-    end
+      # Uncheck a checkbox object.
+      #
+      # @example
+      #   remember_me_checkbox.uncheck
+      #
+      def uncheck
+        set_checkbox_state(state = false)
+      end
 
-    def verify_check_state(state, enqueue = false)
-      actual = checked?
-      enqueue ?
+      def verify_check_state(state, enqueue = false)
+        actual = checked?
+        enqueue ?
           ExceptionQueue.enqueue_assert_equal(state, actual, "Expected checkbox #{object_ref_message}") :
           assert_equal(state, actual, "Expected checkbox #{object_ref_message} to be #{state} but found #{actual} instead")
+      end
     end
   end
 end

data/lib/testcentricity_web/web_elements/file_field.rb

@@ -1,49 +1,51 @@
 module TestCentricity
-  class FileField < UIElement
-    def initialize(name, parent, locator, context)
-      super
-      @type = :filefield
-    end
+  module Elements
+    class FileField < UIElement
+      def initialize(name, parent, locator, context)
+        super
+        @type = :filefield
+      end
 
-    def file_upload(file_path)
-      obj, = find_element(visible = false)
-      obj.send_keys(file_path)
-    end
+      def file_upload(file_path)
+        obj, = find_element(visible = false)
+        obj.send_keys(file_path)
+      end
 
-    # :nocov:
+      # :nocov:
 
-    def file_attach(file_path)
-      Capybara.ignore_hidden_elements = false
-      page.attach_file(@locator, file_path)
-      Capybara.ignore_hidden_elements = true
-    end
+      def file_attach(file_path)
+        Capybara.ignore_hidden_elements = false
+        page.attach_file(@locator, file_path)
+        Capybara.ignore_hidden_elements = true
+      end
+
+      def drop_files(files)
+        js_script = 'fileList = Array();'
+        files.count.times do |i|
+          # generate a fake input selector
+          page.execute_script("if ($('#seleniumUpload#{i}').length == 0) { seleniumUpload#{i} = window.$('<input/>').attr({id: 'seleniumUpload#{i}', type:'file'}).appendTo('body'); }")
+          # attach file to the fake input selector through Capybara
+          attach_file("seleniumUpload#{i}", files[i])
+          # create the fake js event
+          js_script = "#{js_script} fileList.push(seleniumUpload#{i}.get(0).files[0]);"
+        end
+        # trigger the fake drop event
+        page.execute_script("#{js_script} e = $.Event('drop'); e.originalEvent = {dataTransfer : { files : fileList } }; $('#{@locator}').trigger(e);")
+      end
 
-    def drop_files(files)
-      js_script = 'fileList = Array();'
-      files.count.times do |i|
+      def ng_drop_file(file_path)
         # generate a fake input selector
-        page.execute_script("if ($('#seleniumUpload#{i}').length == 0) { seleniumUpload#{i} = window.$('<input/>').attr({id: 'seleniumUpload#{i}', type:'file'}).appendTo('body'); }")
+        page.execute_script("fakeFileInput = window.$('<input/>').attr({ id: 'fileFileInput', type: 'file' }).appendTo('body');")
         # attach file to the fake input selector through Capybara
-        attach_file("seleniumUpload#{i}", files[i])
+        page.attach_file('fakeFileInput', file_path)
         # create the fake js event
-        js_script = "#{js_script} fileList.push(seleniumUpload#{i}.get(0).files[0]);"
+        js_script = "var scope = angular.element('#{@locator}').scope();"
+        js_script = "#{js_script} scope.files = [fakeFileInput.get(0).files[0]];"
+        # trigger the fake drop event
+        page.execute_script(js_script)
       end
-      # trigger the fake drop event
-      page.execute_script("#{js_script} e = $.Event('drop'); e.originalEvent = {dataTransfer : { files : fileList } }; $('#{@locator}').trigger(e);")
-    end
 
-    def ng_drop_file(file_path)
-      # generate a fake input selector
-      page.execute_script("fakeFileInput = window.$('<input/>').attr({ id: 'fileFileInput', type: 'file' }).appendTo('body');")
-      # attach file to the fake input selector through Capybara
-      page.attach_file('fakeFileInput', file_path)
-      # create the fake js event
-      js_script = "var scope = angular.element('#{@locator}').scope();"
-      js_script = "#{js_script} scope.files = [fakeFileInput.get(0).files[0]];"
-      # trigger the fake drop event
-      page.execute_script(js_script)
+      # :nocov:
     end
-
-    # :nocov:
   end
 end

data/lib/testcentricity_web/web_elements/image.rb

@@ -1,81 +1,86 @@
 module TestCentricity
-  class Image < UIElement
-    def initialize(name, parent, locator, context)
-      super
-      @type = :image
-    end
+  module Elements
+    class Image < UIElement
+      def initialize(name, parent, locator, context)
+        super
+        @type = :image
+      end
 
-    # Is image loaded?
-    #
-    # @return [Boolean]
-    # @example
-    #   company_logo_image.is_loaded?
-    #
-    def loaded?
-      obj, = find_element
-      object_not_found_exception(obj, nil)
-      state = obj.native.attribute('complete')
-      state.boolean? ? state : state == 'true'
-    end
+      # Is image loaded?
+      #
+      # @return [Boolean]
+      # @example
+      #   company_logo_image.is_loaded?
+      #
+      def loaded?
+        obj, = find_element
+        object_not_found_exception(obj, nil)
+        state = obj.native.attribute('complete')
+        state.boolean? ? state : state == 'true'
+      end
 
-    alias is_loaded? loaded?
+      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
+      # 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
-    # @example
-    #   company_logo_image.wait_until_loaded(5)
-    #
-    def wait_until_loaded(seconds = nil, post_exception = true)
-      timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
-      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
-      wait.until { is_loaded? }
-    rescue
-      if post_exception
-        raise "Image #{object_ref_message} failed to load within #{timeout} seconds" unless loaded?
-      else
-        loaded?
+      # Wait until the image is fully loaded, or until the specified wait time has expired.
+      #
+      # @param seconds [Integer or Float] wait time in seconds
+      # @example
+      #   company_logo_image.wait_until_loaded(5)
+      #
+      def wait_until_loaded(seconds = nil, post_exception = true)
+        timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
+        wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+        wait.until do
+          reset_mru_cache
+          is_loaded?
+        end
+      rescue
+        if post_exception
+          raise "Image #{object_ref_message} failed to load within #{timeout} seconds" unless loaded?
+        else
+          loaded?
+        end
       end
-    end
 
-    # Return image alt property
-    #
-    # @return [String] value of alt property
-    # @example
-    #   alt_value = company_logo_image.alt
-    #
-    def alt
-      obj, = find_element
-      object_not_found_exception(obj, nil)
-      obj.native.attribute('alt')
-    end
+      # Return image alt property
+      #
+      # @return [String] value of alt property
+      # @example
+      #   alt_value = company_logo_image.alt
+      #
+      def alt
+        obj, = find_element
+        object_not_found_exception(obj, nil)
+        obj.native.attribute('alt')
+      end
 
-    # Return image src property
-    #
-    # @return [String] value of src property
-    # @example
-    #   src_value = company_logo_image.src
-    #
-    def src
-      obj, = find_element
-      object_not_found_exception(obj, nil)
-      obj.native.attribute('src')
+      # Return image src property
+      #
+      # @return [String] value of src property
+      # @example
+      #   src_value = company_logo_image.src
+      #
+      def src
+        obj, = find_element
+        object_not_found_exception(obj, nil)
+        obj.native.attribute('src')
+      end
     end
   end
 end

data/lib/testcentricity_web/web_elements/label.rb

@@ -1,8 +1,10 @@
 module TestCentricity
-  class Label < UIElement
-    def initialize(name, parent, locator, context)
-      super
-      @type = :label
+  module Elements
+    class Label < UIElement
+      def initialize(name, parent, locator, context)
+        super
+        @type = :label
+      end
     end
   end
 end

data/lib/testcentricity_web/web_elements/link.rb

@@ -1,18 +1,20 @@
 module TestCentricity
-  class Link < UIElement
-    def initialize(name, parent, locator, context)
-      super
-      @type = :link
-    end
+  module Elements
+    class Link < UIElement
+      def initialize(name, parent, locator, context)
+        super
+        @type = :link
+      end
 
-    # Return link object's href property
-    #
-    # @return [String]
-    # @example
-    #   contact_us_link.href
-    #
-    def href
-      get_attribute('href')
+      # Return link object's href property
+      #
+      # @return [String]
+      # @example
+      #   contact_us_link.href
+      #
+      def href
+        get_attribute('href')
+      end
     end
   end
 end