testcentricity 2.3.13

data/lib/testcentricity/web_elements/button.rb

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

data/lib/testcentricity/web_elements/cell_button.rb

@@ -0,0 +1,8 @@
+module TestCentricity
+  class CellButton < CellElement
+    def initialize(name, parent, locator, context, table, column, proxy = nil)
+      super
+      @type = :cell_button
+    end
+  end
+end

data/lib/testcentricity/web_elements/cell_checkbox.rb

@@ -0,0 +1,38 @@
+module TestCentricity
+  class CellCheckBox < CellElement
+    attr_accessor :proxy
+
+    def initialize(name, parent, locator, context, table, column, proxy = nil)
+      super
+      @type  = :cell_checkbox
+      @proxy = proxy
+    end
+
+    def checked?(row)
+      obj, = find_cell_element(row)
+      cell_object_not_found_exception(obj, 'Cell CheckBox', row)
+      obj.checked?
+    end
+
+    def set_checkbox_state(row, state)
+      obj, = find_cell_element(row)
+      cell_object_not_found_exception(obj, 'Cell CheckBox', row)
+      obj.set(state)
+    end
+
+    def check(row)
+      set_checkbox_state(row, true)
+    end
+
+    def uncheck(row)
+      set_checkbox_state(row, false)
+    end
+
+    def verify_check_state(row, state, enqueue = false)
+      actual = checked?(row)
+      enqueue ?
+          ExceptionQueue.enqueue_assert_equal(state, actual, "Expected Row #{row}/Col #{@column} Cell Checkbox #{object_ref_message}") :
+          assert_equal(state, actual, "Expected Row #{row}/Col #{@column} Cell Checkbox #{object_ref_message} to be #{state} but found #{actual} instead")
+    end
+  end
+end

data/lib/testcentricity/web_elements/cell_element.rb

@@ -0,0 +1,69 @@
+module TestCentricity
+  class CellElement < UIElement
+    attr_accessor :table
+    attr_accessor :column
+    attr_accessor :element_locator
+
+    def initialize(name, parent, locator, context, table, column, proxy = nil)
+      @name            = name
+      @parent          = parent
+      @context         = context
+      @alt_locator     = nil
+      @table           = table
+      @column          = column
+      @element_locator = locator
+
+      set_locator_type(@table.get_locator)
+      set_column(column)
+    end
+
+    def set_column(column)
+      @column  = column
+      case @locator_type
+      when :xpath
+        @locator = "#{@table.get_table_cell_locator('ROW_SPEC', @column)}/#{@element_locator}"
+      when :css
+        @locator = "#{@table.get_table_cell_locator('ROW_SPEC', @column)} > #{@element_locator}"
+      end
+    end
+
+    def exists?(row)
+      obj, = find_cell_element(row)
+      obj != nil
+    end
+
+    def click(row)
+      obj, = find_cell_element(row)
+      cell_object_not_found_exception(obj, @type, row)
+      obj.click
+    end
+
+    def get_native_attribute(row, attrib)
+      obj, = find_cell_element(row)
+      cell_object_not_found_exception(obj, @type, row)
+      obj.get_native_attribute(attrib)
+    end
+
+    def get_value(row, visible = true)
+      obj, = find_cell_element(row, visible)
+      cell_object_not_found_exception(obj, @type, row)
+      case obj.tag_name.downcase
+      when 'input', 'select', 'textarea'
+        obj.value
+      else
+        obj.text
+      end
+    end
+
+    alias get_caption get_value
+
+    def find_cell_element(row, visible = true)
+      set_alt_locator("#{@locator.gsub('ROW_SPEC', row.to_s)}")
+      find_element(visible)
+    end
+
+    def cell_object_not_found_exception(obj, obj_type, row)
+      object_not_found_exception(obj, "Row #{row}/Col #{@column} #{obj_type}")
+    end
+  end
+end

data/lib/testcentricity/web_elements/cell_image.rb

@@ -0,0 +1,8 @@
+module TestCentricity
+  class CellImage < CellElement
+    def initialize(name, parent, locator, context, table, column, proxy = nil)
+      super
+      @type = :cell_image
+    end
+  end
+end

data/lib/testcentricity/web_elements/cell_radio.rb

@@ -0,0 +1,31 @@
+module TestCentricity
+  class CellRadio < CellElement
+    attr_accessor :proxy
+
+    def initialize(name, parent, locator, context, table, column, proxy = nil)
+      super
+      @type  = :cell_radio
+      @proxy = proxy
+    end
+
+    def selected?(row)
+      obj, = find_cell_element(row)
+      cell_object_not_found_exception(obj, 'Cell Radio', row)
+      obj.checked?
+    end
+
+    def set_selected_state(row, state)
+      obj, = find_cell_element(row)
+      cell_object_not_found_exception(obj, 'Cell Radio', row)
+      obj.set(state)
+    end
+
+    def select(row)
+      set_selected_state(row, true)
+    end
+
+    def unselect(row)
+      set_selected_state(row, false)
+    end
+  end
+end

data/lib/testcentricity/web_elements/checkbox.rb

@@ -0,0 +1,100 @@
+module TestCentricity
+  class CheckBox < UIElement
+    attr_accessor :proxy
+
+    def initialize(name, parent, locator, context, proxy = nil)
+      @name        = name
+      @parent      = parent
+      @locator     = locator
+      @context     = context
+      @alt_locator = nil
+      @proxy       = proxy
+      @type        = :checkbox
+      set_locator_type
+    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?
+      obj, = find_element(:all)
+      object_not_found_exception(obj, 'Checkbox')
+      obj.checked?
+    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)
+      obj, = find_element(:all)
+      object_not_found_exception(obj, 'Checkbox')
+      invalid_object_type_exception(obj, 'checkbox')
+      if @proxy.nil?
+        if obj.native.attribute('ot') == 'JCheckBox'
+          expected = state.to_bool
+          obj.click unless expected == obj.checked?
+        else
+          obj.set(state)
+        end
+      else
+        @proxy.click unless state == obj.checked?
+      end
+    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(false)
+    end
+
+    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
+
+    # Set the check state of a Siebel OUI JCheckBox object.
+    #
+    # @param state [Boolean] true = checked / false = unchecked
+    # @example
+    #   remember_me_checkbox.set_siebel_checkbox_state(true)
+    #
+    def set_siebel_checkbox_state(state)
+      obj, = find_element
+      object_not_found_exception(obj, 'Siebel checkbox')
+      raise "UI #{object_ref_message} is not a Siebel CheckBox object" unless get_siebel_object_type == 'JCheckBox'
+      expected = state.to_bool
+      obj.click unless expected == obj.checked?
+    end
+  end
+end

data/lib/testcentricity/web_elements/file_field.rb

@@ -0,0 +1,45 @@
+module TestCentricity
+  class FileField < UIElement
+    def initialize(name, parent, locator, context)
+      super
+      @type = :filefield
+    end
+
+    def file_attach(file_path)
+      Capybara.ignore_hidden_elements = false
+      page.attach_file(@locator, file_path)
+      Capybara.ignore_hidden_elements = true
+    end
+
+    def file_upload(file_path)
+      obj, = find_element(false)
+      obj.send_keys(file_path)
+    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 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)
+    end
+  end
+end

data/lib/testcentricity/web_elements/image.rb

@@ -0,0 +1,34 @@
+module TestCentricity
+  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 is_loaded?
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      obj.native.attribute('complete')
+    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)
+      timeout = seconds.nil? ? Capybara.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { is_loaded? }
+    rescue
+      raise "Image #{object_ref_message} failed to load within #{timeout} seconds" unless is_loaded?
+    end
+  end
+end

data/lib/testcentricity/web_elements/label.rb

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

data/lib/testcentricity/web_elements/link.rb

@@ -0,0 +1,8 @@
+module TestCentricity
+  class Link < UIElement
+    def initialize(name, parent, locator, context)
+      super
+      @type = :link
+    end
+  end
+end

data/lib/testcentricity/web_elements/list.rb

@@ -0,0 +1,73 @@
+module TestCentricity
+  class List < UIElement
+    attr_accessor :list_item
+
+    def initialize(name, parent, locator, context)
+      super
+      @type = :list
+      define_list_elements({ :list_item => 'li' })
+    end
+
+    def define_list_elements(element_spec)
+      element_spec.each do |element, value|
+        case element
+        when :list_item
+          @list_item = value
+        else
+          raise "#{element} is not a recognized list element"
+        end
+      end
+    end
+
+    def get_list_items(element_spec = nil)
+      define_list_elements(element_spec) unless element_spec.nil?
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      obj.all(@list_item).collect(&:text)
+    end
+
+    def get_list_item(index, visible = true)
+      if visible
+        items = get_list_items
+      else
+        items = get_all_list_items
+      end
+      items[index - 1]
+    end
+
+    def get_item_count
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      obj.all(@list_item).count
+    end
+
+    def get_all_list_items(element_spec = nil)
+      define_list_elements(element_spec) unless element_spec.nil?
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      obj.all(@list_item, :visible => :all).collect(&:text)
+    end
+
+    def get_all_items_count
+      obj, = find_element
+      object_not_found_exception(obj, nil)
+      obj.all(@list_item, :visible => :all).count
+    end
+
+    def verify_list_items(expected, enqueue = false)
+      actual = get_list_items
+      enqueue ?
+          ExceptionQueue.enqueue_assert_equal(expected, actual, "Expected list #{object_ref_message}") :
+          assert_equal(expected, actual, "Expected list #{object_ref_message} to be #{expected} but found #{actual}")
+    end
+
+    def get_list_row_locator(row)
+      case @locator_type
+      when :xpath
+        "#{@locator}/#{@list_item}[#{row}]"
+      when :css
+        "#{@locator} > #{@list_item}:nth-of-type(#{row})"
+      end
+    end
+  end
+end