testcentricity_web 4.1.8 → 4.1.9

data/lib/testcentricity_web/web_elements/checkbox.rb

@@ -2,11 +2,13 @@ module TestCentricity
   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
       }
@@ -16,6 +18,8 @@ module TestCentricity
     def define_custom_elements(element_spec)
       element_spec.each do |element, value|
         case element
+        when :input
+          @input = value
         when :proxy
           @proxy = value
         when :label
@@ -44,9 +48,14 @@ module TestCentricity
     #   remember_me_checkbox.checked?
     #
     def checked?
-      obj, = find_element(:all)
-      object_not_found_exception(obj, 'Checkbox')
-      obj.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?
@@ -67,7 +76,14 @@ module TestCentricity
     #   remember_me_checkbox.visible?
     #
     def visible?
-      @proxy.nil? ? super : page.find(:css, @proxy).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.visible?
+      end
     end
 
     # Is checkbox disabled (not enabled)?
@@ -77,10 +93,14 @@ module TestCentricity
     #   remember_me_checkbox.disabled?
     #
     def disabled?
-      visibility = @proxy.nil? ? true : :all
-      obj, type = find_element(visibility)
-      object_not_found_exception(obj, type)
-      obj.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
 
     # Return checkbox caption
@@ -91,9 +111,15 @@ module TestCentricity
     #
     def get_value
       if @label.nil?
-        @proxy.nil? ? super : page.find(:css, @proxy).text
+        if @proxy.nil?
+          super
+        else
+          proxy = find_component(@proxy, 'checkbox proxy')
+          proxy.text
+        end
       else
-        page.find(:css, @label).text
+        label = find_component(@label, 'checkbox label')
+        label.text
       end
     end
 
@@ -108,17 +134,22 @@ module TestCentricity
     #   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?
-        begin
-          obj.set(state)
-        rescue
-          obj.click unless state == obj.checked?
+      @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
-        page.find(:css, @proxy).click unless state == obj.checked?
+        if @proxy.nil?
+          @base_object.click unless state == chk.checked?
+        else
+          proxy.click unless state == chk.checked?
+        end
       end
     end
 

data/lib/testcentricity_web/web_elements/media.rb

@@ -178,7 +178,7 @@ module TestCentricity
     def ready_state
       obj, = find_element(visible = :all)
       object_not_found_exception(obj, @type)
-      obj.native.attribute('readyState').to_i
+      page.execute_script('return arguments[0].readyState', obj)
     end
 
     # Wait until the media object's readyState value equals the specified value, or until the specified wait time has expired. If the wait

data/lib/testcentricity_web/web_elements/radio.rb

@@ -2,11 +2,13 @@ module TestCentricity
   class Radio < UIElement
     attr_accessor :proxy
     attr_accessor :label
+    attr_accessor :input
 
     def initialize(name, parent, locator, context)
       super
       @type = :radio
       radio_spec = {
+        input: nil,
         proxy: nil,
         label: nil
       }
@@ -16,6 +18,8 @@ module TestCentricity
     def define_custom_elements(element_spec)
       element_spec.each do |element, value|
         case element
+        when :input
+          @input = value
         when :proxy
           @proxy = value
         when :label
@@ -44,9 +48,14 @@ module TestCentricity
     #   accept_terms_radio.selected?
     #
     def selected?
-      obj, = find_element(:all)
-      object_not_found_exception(obj, 'Radio')
-      obj.checked?
+      @base_object, = find_element(:all)
+      object_not_found_exception(@base_object, 'Radio')
+      rad = if @input.nil?
+              @base_object
+            else
+              find_component(@input, 'Radio')
+            end
+      rad.checked?
     end
 
     # Is radio button visible?
@@ -56,7 +65,14 @@ module TestCentricity
     #   accept_terms_radio.visible?
     #
     def visible?
-      @proxy.nil? ? super : page.find(:css, @proxy).visible?
+      if @proxy.nil?
+        super
+      else
+        @base_object, = find_element(:all)
+        object_not_found_exception(@base_object, 'Radio')
+        proxy = find_component(@proxy, 'radio proxy')
+        proxy.visible?
+      end
     end
 
     # Is radio button disabled (not enabled)?
@@ -66,10 +82,14 @@ module TestCentricity
     #   accept_terms_radio.disabled?
     #
     def disabled?
-      visibility = @proxy.nil? ? true : :all
-      obj, type = find_element(visibility)
-      object_not_found_exception(obj, type)
-      obj.disabled?
+      if @input.nil?
+        super
+      else
+        @base_object, = find_element(:all)
+        object_not_found_exception(@base_object, 'Radio')
+        rad = find_component(@input, 'radio')
+        rad.disabled?
+      end
     end
 
     # Return radio button caption
@@ -80,9 +100,15 @@ module TestCentricity
     #
     def get_value
       if @label.nil?
-        @proxy.nil? ? super : page.find(:css, @proxy).text
+        if @proxy.nil?
+          super
+        else
+          proxy = find_component(@proxy, 'radio proxy')
+          proxy.text
+        end
       else
-        page.find(:css, @label).text
+        label = find_component(@label, 'radio label')
+        label.text
       end
     end
 
@@ -97,17 +123,22 @@ module TestCentricity
     #   accept_terms_radio.set_selected_state(true)
     #
     def set_selected_state(state)
-      obj, = find_element(:all)
-      object_not_found_exception(obj, 'Radio')
-      invalid_object_type_exception(obj, 'radio')
-      if @proxy.nil?
-        begin
-          obj.set(state)
-        rescue
-          obj.click unless state == obj.checked?
+      @base_object, = find_element(:all)
+      object_not_found_exception(@base_object, 'Radio')
+      proxy = find_component(@proxy, 'radio proxy') unless @proxy.nil?
+      rad = find_component(@input, 'radio') 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
-        page.find(:css, @proxy).click unless state == obj.checked?
+        if @proxy.nil?
+          @base_object.click unless state == rad.checked?
+        else
+          proxy.click unless state == rad.checked?
+        end
       end
     end
 

data/lib/testcentricity_web/web_elements/select_list.rb

@@ -61,7 +61,7 @@ module TestCentricity
     #
     def choose_option(option)
       @base_object, = find_element
-      object_not_found_exception(@base_object, nil)
+      object_not_found_exception(@base_object, 'SelectList')
 
       trigger_list
 
@@ -75,9 +75,9 @@ module TestCentricity
           end
         else
           if option.is_a?(Hash)
-            page.find(:css, "#{@list_item}:nth-of-type(#{option[:index]})").click if option.key?(:index)
-            page.find(:css, "#{@list_item}:nth-of-type(#{option[:value]})").click if option.key?(:value)
-            page.find(:css, "#{@list_item}:nth-of-type(#{option[:text]})").click if option.key?(:text)
+            @base_object.first(:css, "#{@list_item}:nth-of-type(#{option[:index]})").click if option.key?(:index)
+            @base_object.first(:css, "#{@list_item}:nth-of-type(#{option[:value]})").click if option.key?(:value)
+            @base_object.first(:css, "#{@list_item}:nth-of-type(#{option[:text]})").click if option.key?(:text)
           else
             options = @base_object.all(@list_item).collect(&:text)
             sleep(2) unless options.include?(option)
@@ -117,10 +117,10 @@ module TestCentricity
     def set(text)
       raise "A 'text_field' list element must be defined before calling the 'set' method on a selectlist object" if @text_field.nil?
       @base_object, = find_element
-      object_not_found_exception(@base_object, nil)
+      object_not_found_exception(@base_object, 'SelectList')
       trigger_list
-
-      page.find(:css, @text_field, wait: 2).set(text)
+      input = find_component(@text_field, 'text field')
+      input.set("#{text}\n")
     end
 
     # Return array of strings of all options in a select box object.
@@ -132,7 +132,7 @@ module TestCentricity
     #
     def get_options
       @base_object, = find_element
-      object_not_found_exception(@base_object, nil)
+      object_not_found_exception(@base_object, 'SelectList')
       if @options_list.nil?
         if @base_object.first(:css, @list_item, minimum: 0, wait: 2)
           @base_object.all(@list_item).collect(&:text)
@@ -159,7 +159,7 @@ module TestCentricity
     #
     def get_option_count
       @base_object, = find_element
-      object_not_found_exception(@base_object, nil)
+      object_not_found_exception(@base_object, 'SelectList')
       if @options_list.nil?
         if @base_object.first(:css, @list_item, minimum: 0, wait: 2)
           @base_object.all(@list_item).count
@@ -186,7 +186,7 @@ module TestCentricity
     #
     def get_group_headings
       @base_object, = find_element
-      object_not_found_exception(@base_object, nil)
+      object_not_found_exception(@base_object, 'SelectList')
       if @options_list.nil?
         if @base_object.first(:css, @group_heading, minimum: 0, wait: 2)
           @base_object.all(@group_heading).collect(&:text)
@@ -211,7 +211,7 @@ module TestCentricity
     #
     def get_group_count
       @base_object, = find_element
-      object_not_found_exception(@base_object, nil)
+      object_not_found_exception(@base_object, 'SelectList')
       if @options_list.nil?
         if @base_object.first(:css, @group_item, minimum: 0, wait: 2)
           @base_object.all(@group_item).count
@@ -245,7 +245,7 @@ module TestCentricity
     #
     def get_selected_option
       @base_object, = find_element
-      object_not_found_exception(@base_object, nil)
+      object_not_found_exception(@base_object, 'SelectList')
       trigger_list unless @options_list.nil?
       selection = if @base_object.first(:css, @list_item, minimum: 0, wait: 1, visible: :all)
                     @base_object.first(:css, @selected_item, wait: 1, visible: :all).text

data/lib/testcentricity_web/web_elements/ui_elements_helper.rb

@@ -527,7 +527,7 @@ module TestCentricity
              else
                obj.text
              end
-      text.gsub(/[[:space:]]+/, ' ').strip
+      text.gsub(/[[:space:]]+/, ' ').strip unless text.nil?
     end
 
     alias get_caption get_value
@@ -1096,10 +1096,10 @@ module TestCentricity
 
     def find_component(component, component_name)
       begin
-        element = @base_object.find(:css, component, minimum: 0, wait: 1)
+        element = @base_object.find(:css, component, visible: :all, minimum: 0, wait: 1)
       rescue
         begin
-          element = page.find(:css, component, minimum: 0, wait: 5)
+          element = page.find(:css, component, visible: :all, minimum: 0, wait: 2)
         rescue
           raise "Component #{component_name} (#{component}) for #{@type} named '#{@name}' (#{locator}) not found"
         end

data/spec/fixtures/page_object.rb

@@ -0,0 +1,22 @@
+class TestPage < TestCentricity::PageObject
+  trait(:page_name)    { 'Basic Test Page' }
+  trait(:page_url)     { '/basic_test_page.html' }
+  trait(:page_locator) { 'form#HTMLFormElements' }
+
+  elements    element1: 'div#element1'
+  buttons     button1:  'button#button1'
+  textfields  field1:   'input#field1'
+  links       link1:    'a#link1'
+  ranges      range1:   'input#range1'
+  images      image1:   'img#image1'
+  radios      radio1:   'input#radio1'
+  checkboxes  check1:   'input#check1'
+  filefields  file1:    'input#file1'
+  labels      label1:   'label#label1'
+  tables      table1:   'table#table1'
+  selectlists select1:  'select#select1'
+  lists       list1:    'ul#list1'
+  videos      video1:   'video#video1'
+  audios      audio1:   'audio#audio1'
+  sections    section1: TestSection
+end

data/spec/fixtures/section_object.rb

@@ -0,0 +1,21 @@
+class TestSection < TestCentricity::PageSection
+  trait(:section_locator) { 'div#section' }
+  trait(:section_name)    { 'Basic Test Section' }
+
+  elements    element1: 'div#element1'
+  buttons     button1:  'button#button1'
+  textfields  field1:   'input#field1'
+  links       link1:    'a#link1'
+  ranges      range1:   'input#range1'
+  images      image1:   'img#image1'
+  radios      radio1:   'input#radio1'
+  checkboxes  check1:   'input#check1'
+  filefields  file1:    'input#file1'
+  labels      label1:   'label#label1'
+  tables      table1:   'table#table1'
+  selectlists select1:  'select#select1'
+  lists       list1:    'ul#list1'
+  videos      video1:   'video#video1'
+  audios      audio1:   'audio#audio1'
+  sections    section2: TestSection
+end

data/spec/spec_helper.rb

@@ -0,0 +1,31 @@
+require 'require_all'
+require 'capybara/rspec'
+require 'httparty'
+require 'simplecov'
+require 'testcentricity_web'
+
+require_rel 'fixtures'
+
+include TestCentricity
+
+SimpleCov.command_name("RSpec-#{Time.now.strftime('%Y%m%d%H%M%S')}")
+
+$LOAD_PATH << './lib'
+
+# set the default locale and auto load all translations from config/locales/*.rb,yml.
+ENV['LOCALE'] = 'en-US' unless ENV['LOCALE']
+I18n.load_path += Dir['config/locales/*.{rb,yml}']
+I18n.default_locale = 'en-US'
+I18n.locale = ENV['LOCALE']
+Faker::Config.locale = ENV['LOCALE']
+
+# prevent Test::Unit's AutoRunner from executing during RSpec's rake task
+Test::Unit.run = true if defined?(Test::Unit) && Test::Unit.respond_to?(:run=)
+
+RSpec.configure do |config|
+  config.mock_with :rspec do |mocks|
+    mocks.allow_message_expectations_on_nil = true
+    mocks.verify_doubled_constant_names = true
+    mocks.verify_partial_doubles = true
+  end
+end

data/spec/testcentricity_web/browser_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+describe TestCentricity::Browsers, required: true do
+  before(:context) do
+    # instantiate local test environment
+    @environs ||= EnvironData
+    @environs.find_environ('LOCAL', :yaml)
+    ENV['WEB_BROWSER'] = 'chrome_headless'
+  end
+
+  context 'web browser with multiple tabs/windows' do
+    it 'returns number of browser windows/tabs' do
+      WebDriverConnect.initialize_web_driver
+      Capybara.current_session.open_new_window
+      Capybara.current_session.open_new_window
+      expect(Browsers.num_browser_instances).to eql 3
+    end
+
+    it 'closes original browser instance' do
+      WebDriverConnect.initialize_web_driver
+      Capybara.current_session.open_new_window
+      Browsers.close_old_browser_instance
+      expect(Browsers.num_browser_instances).to eql 1
+    end
+
+    it 'closes current browser instance' do
+      WebDriverConnect.initialize_web_driver
+      Capybara.current_session.open_new_window
+      Browsers.switch_to_new_browser_instance
+      Capybara.current_session.open_new_window
+      Browsers.close_current_browser_instance
+      expect(Browsers.num_browser_instances).to eql 2
+    end
+  end
+
+  after(:each) do
+    Browsers.close_all_browser_instances
+    Capybara.current_session.quit
+    Environ.session_state = :quit
+  end
+end

data/spec/testcentricity_web/elements/audio_spec.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+describe TestCentricity::Audio, required: true do
+  subject(:css_audio) { described_class.new(:test_audio, self, 'audio#css_audio', :page) }
+
+  it 'returns class' do
+    expect(css_audio.class).to eql TestCentricity::Audio
+  end
+
+  it 'registers with type audio' do
+    expect(css_audio.get_object_type).to eql :audio
+  end
+
+  it 'returns autoplay' do
+    allow(css_audio).to receive(:autoplay?).and_return(false)
+    expect(css_audio.autoplay?).to eql false
+  end
+
+  it 'returns controls' do
+    allow(css_audio).to receive(:controls?).and_return(true)
+    expect(css_audio.controls?).to eql true
+  end
+
+  it 'returns ended' do
+    allow(css_audio).to receive(:ended?).and_return(true)
+    expect(css_audio.ended?).to eql true
+  end
+
+  it 'returns loop' do
+    allow(css_audio).to receive(:loop?).and_return(false)
+    expect(css_audio.loop?).to eql false
+  end
+
+  it 'returns muted' do
+    allow(css_audio).to receive(:muted?).and_return(false)
+    expect(css_audio.muted?).to eql false
+  end
+
+  it 'returns paused' do
+    allow(css_audio).to receive(:paused?).and_return(true)
+    expect(css_audio.paused?).to eql true
+  end
+
+  it 'returns seeking' do
+    allow(css_audio).to receive(:seeking?).and_return(false)
+    expect(css_audio.seeking?).to eql false
+  end
+
+  it 'should play the audio' do
+    expect(css_audio).to receive(:play)
+    css_audio.play
+  end
+
+  it 'should pause the audio' do
+    expect(css_audio).to receive(:pause)
+    css_audio.pause
+  end
+
+  it 'should mute the audio' do
+    expect(css_audio).to receive(:mute)
+    css_audio.mute
+  end
+
+  it 'should unmute the audio' do
+    expect(css_audio).to receive(:unmute)
+    css_audio.unmute
+  end
+end

data/spec/testcentricity_web/elements/button_spec.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+describe TestCentricity::Button, required: true do
+  subject(:css_button) { described_class.new(:test_button, self, 'button#css_button', :page) }
+
+  it 'returns class' do
+    expect(css_button.class).to eql TestCentricity::Button
+  end
+
+  it 'registers with type button' do
+    expect(css_button.get_object_type).to eql :button
+  end
+
+  it 'should click the button' do
+    expect(css_button).to receive(:click)
+    css_button.click
+  end
+end

data/spec/testcentricity_web/elements/checkbox_spec.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+describe TestCentricity::CheckBox, required: true do
+  subject(:css_check) { described_class.new(:test_check, self, 'input#css_check', :page) }
+
+  it 'returns class' do
+    expect(css_check.class).to eql TestCentricity::CheckBox
+  end
+
+  it 'registers with type checkbox' do
+    expect(css_check.get_object_type).to eql :checkbox
+  end
+
+  it 'should check the checkbox' do
+    expect(css_check).to receive(:check)
+    css_check.check
+  end
+
+  it 'should uncheck the checkbox' do
+    expect(css_check).to receive(:uncheck)
+    css_check.uncheck
+  end
+
+  it 'should know if checkbox is checked' do
+    allow(css_check).to receive(:checked?).and_return(true)
+    expect(css_check.checked?).to eq(true)
+  end
+
+  it 'should know if checkbox is indeterminate' do
+    allow(css_check).to receive(:indeterminate?).and_return(true)
+    expect(css_check.indeterminate?).to eq(true)
+  end
+end

data/spec/testcentricity_web/elements/file_field_spec.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+describe TestCentricity::FileField, required: true do
+  subject(:css_filefield) { described_class.new(:test_filefield, self, 'input#css_filefield', :page) }
+
+  it 'returns class' do
+    expect(css_filefield.class).to eql TestCentricity::FileField
+  end
+
+  it 'registers with type label' do
+    expect(css_filefield.get_object_type).to eql :filefield
+  end
+end

data/spec/testcentricity_web/elements/image_spec.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+describe TestCentricity::Image, required: true do
+  subject(:css_image) { described_class.new(:test_image, self, 'img#css_image', :page) }
+
+  it 'returns class' do
+    expect(css_image.class).to eql TestCentricity::Image
+  end
+
+  it 'registers with type image' do
+    expect(css_image.get_object_type).to eql :image
+  end
+
+  it 'returns loaded' do
+    allow(css_image).to receive(:loaded?).and_return(true)
+    expect(css_image.loaded?).to eql true
+  end
+
+  it 'returns broken' do
+    allow(css_image).to receive(:broken?).and_return(false)
+    expect(css_image.broken?).to eql false
+  end
+
+  it 'returns alt' do
+    allow(css_image).to receive(:alt).and_return('alt')
+    expect(css_image.alt).to eql 'alt'
+  end
+
+  it 'returns src' do
+    allow(css_image).to receive(:src).and_return('src')
+    expect(css_image.src).to eql 'src'
+  end
+end

data/spec/testcentricity_web/elements/label_spec.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+describe TestCentricity::Label, required: true do
+  subject(:css_label) { described_class.new(:test_label, self, 'label#css_label', :page) }
+
+  it 'returns class' do
+    expect(css_label.class).to eql TestCentricity::Label
+  end
+
+  it 'registers with type label' do
+    expect(css_label.get_object_type).to eql :label
+  end
+
+  it 'returns caption' do
+    allow(css_label).to receive(:caption).and_return('caption')
+    expect(css_label.caption).to eql 'caption'
+  end
+end