watir 1.4.1 → 7.3.0

data/spec/watirspec/elements/hidden_spec.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe Hidden do
+    before do
+      browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+    end
+
+    # Exist method
+    describe '#exists?' do
+      it 'returns true if the element exists' do
+        expect(browser.hidden(id: 'new_user_interests_dolls')).to exist
+        expect(browser.hidden(id: /new_user_interests_dolls/)).to exist
+        expect(browser.hidden(name: 'new_user_interests')).to exist
+        expect(browser.hidden(name: /new_user_interests/)).to exist
+        expect(browser.hidden(value: 'dolls')).to exist
+        expect(browser.hidden(value: /dolls/)).to exist
+        expect(browser.hidden(class: 'fun')).to exist
+        expect(browser.hidden(class: /fun/)).to exist
+        expect(browser.hidden(index: 0)).to exist
+        expect(browser.hidden(xpath: "//input[@id='new_user_interests_dolls']")).to exist
+      end
+
+      it 'returns the first hidden if given no args' do
+        expect(browser.hidden).to exist
+      end
+
+      it 'returns false if the element does not exist' do
+        expect(browser.hidden(id: 'no_such_id')).not_to exist
+        expect(browser.hidden(id: /no_such_id/)).not_to exist
+        expect(browser.hidden(name: 'no_such_name')).not_to exist
+        expect(browser.hidden(name: /no_such_name/)).not_to exist
+        expect(browser.hidden(value: 'no_such_value')).not_to exist
+        expect(browser.hidden(value: /no_such_value/)).not_to exist
+        expect(browser.hidden(text: 'no_such_text')).not_to exist
+        expect(browser.hidden(text: /no_such_text/)).not_to exist
+        expect(browser.hidden(class: 'no_such_class')).not_to exist
+        expect(browser.hidden(class: /no_such_class/)).not_to exist
+        expect(browser.hidden(index: 1337)).not_to exist
+        expect(browser.hidden(xpath: "//input[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.hidden(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    # Attribute methods
+    describe '#id' do
+      it 'returns the id attribute if the text field exists' do
+        expect(browser.hidden(index: 1).id).to eq 'new_user_interests_dolls'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.hidden(index: 1337).id }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#name' do
+      it 'returns the name attribute if the text field exists' do
+        expect(browser.hidden(index: 1).name).to eq 'new_user_interests'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.hidden(index: 1337).name }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#type' do
+      it 'returns the type attribute if the text field exists' do
+        expect(browser.hidden(index: 1).type).to eq 'hidden'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.hidden(index: 1337).type }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#value' do
+      it 'returns the value attribute if the text field exists' do
+        expect(browser.hidden(index: 1).value).to eq 'dolls'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.hidden(index: 1337).value }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#click' do
+      it 'raises ObjectDisabledException when attempting to click' do
+        expect { browser.hidden(index: 1337).click }.to raise_object_disabled_exception
+      end
+    end
+
+    describe '#respond_to?' do
+      it 'returns true for all attribute methods' do
+        expect(browser.hidden(index: 1)).to respond_to(:id)
+        expect(browser.hidden(index: 1)).to respond_to(:name)
+        expect(browser.hidden(index: 1)).to respond_to(:type)
+        expect(browser.hidden(index: 1)).to respond_to(:value)
+      end
+    end
+  end
+end

data/spec/watirspec/elements/hiddens_spec.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe HiddenCollection do
+    before do
+      browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+    end
+
+    describe 'with selectors' do
+      it 'returns the matching elements' do
+        expect(browser.hiddens(value: 'dolls').to_a).to eq [browser.hidden(value: 'dolls')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of hiddens' do
+        expect(browser.hiddens.length).to eq 2
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the Hidden at the given index' do
+        expect(browser.hiddens[1].id).to eq 'new_user_interests_dolls'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through hiddens correctly' do
+        count = 0
+
+        browser.hiddens.each_with_index do |h, index|
+          expect(h.name).to eq browser.hidden(index: index).name
+          expect(h.id).to eq browser.hidden(index: index).id
+          expect(h.value).to eq browser.hidden(index: index).value
+
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/elements/hn_spec.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe Heading do
+    before do
+      browser.goto(WatirSpec.url_for('non_control_elements.html'))
+    end
+
+    # Exists method
+    describe '#exist?' do
+      it 'returns true if the element exists' do
+        expect(browser.h1(id: 'header1')).to exist
+        expect(browser.h2(id: /header2/)).to exist
+        expect(browser.h3(text: 'Header 3')).to exist
+        expect(browser.h4(text: /Header 4/)).to exist
+        expect(browser.h5(index: 0)).to exist
+        expect(browser.h6(index: 0)).to exist
+        expect(browser.h1(xpath: "//h1[@id='first_header']")).to exist
+      end
+
+      it 'returns the first h1 if given no args' do
+        expect(browser.h1).to exist
+      end
+
+      it 'returns false if the element does not exist' do
+        expect(browser.h1(id: 'no_such_id')).not_to exist
+        expect(browser.h1(id: /no_such_id/)).not_to exist
+        expect(browser.h1(text: 'no_such_text')).not_to exist
+        expect(browser.h1(text: /no_such_text 1/)).not_to exist
+        expect(browser.h1(index: 1337)).not_to exist
+        expect(browser.h1(xpath: "//p[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.h1(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    # Attribute methods
+    describe '#id' do
+      it 'returns the id attribute' do
+        expect(browser.h1(index: 0).id).to eq 'first_header'
+      end
+
+      it "returns an empty string if the element exists and the attribute doesn't" do
+        expect(browser.h3(index: 0).id).to eq ''
+      end
+
+      it "raises UnknownObjectException if the p doesn't exist" do
+        expect { browser.h1(id: 'no_such_id').id }.to raise_unknown_object_exception
+        expect { browser.h1(index: 1337).id }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#text' do
+      it 'returns the text of the element' do
+        expect(browser.h1(index: 0).text).to eq 'Header 1'
+      end
+
+      it "returns an empty string if the element doesn't contain any text" do
+        expect(browser.h6(id: 'empty_header').text).to eq ''
+      end
+
+      it "raises UnknownObjectException if the p doesn't exist" do
+        expect { browser.h1(id: 'no_such_id').text }.to raise_unknown_object_exception
+        expect { browser.h1(xpath: "//h1[@id='no_such_id']").text }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#respond_to?' do
+      it 'returns true for all attribute methods' do
+        expect(browser.h1(index: 0)).to respond_to(:class_name)
+        expect(browser.h1(index: 0)).to respond_to(:id)
+        expect(browser.h1(index: 0)).to respond_to(:text)
+      end
+    end
+  end
+end

data/spec/watirspec/elements/hns_spec.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe HeadingCollection do
+    before do
+      browser.goto(WatirSpec.url_for('non_control_elements.html'))
+    end
+
+    describe 'with selectors' do
+      it 'returns the matching elements' do
+        expect(browser.h1s(class: 'primary').to_a).to eq [browser.h1(class: 'primary')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of h1s' do
+        expect(browser.h2s.length).to eq 9
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the h1 at the given index' do
+        expect(browser.h1s[0].id).to eq 'first_header'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through header collections correctly' do
+        lengths = (1..6).collect do |i|
+          collection = browser.send(:"h#{i}s")
+          collection.each_with_index do |h, index|
+            expect(h.id).to eq browser.send(:"h#{i}", index: index).id
+          end
+          collection.length
+        end
+        expect(lengths).to eq [2, 9, 2, 1, 1, 2]
+      end
+    end
+  end
+end

data/spec/watirspec/elements/iframe_spec.rb

@@ -0,0 +1,244 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+#
+# TODO: fix duplication with frame_spec
+#
+
+module Watir
+  describe IFrame do
+    before do
+      browser.goto(WatirSpec.url_for('iframes.html'))
+    end
+
+    it 'handles crossframe javascript' do
+      browser.goto WatirSpec.url_for('iframes.html')
+
+      expect(browser.iframe(id: 'iframe_1').text_field(name: 'senderElement').value).to eq 'send_this_value'
+      expect(browser.iframe(id: 'iframe_2').text_field(name: 'recieverElement').value).to eq 'old_value'
+      browser.iframe(id: 'iframe_1').button(id: 'send').click
+      expect(browser.iframe(id: 'iframe_2').text_field(name: 'recieverElement').value).to eq 'send_this_value'
+    end
+
+    it 'locates an element defined by Selenium Element' do
+      iframe = browser.iframe(id: 'iframe_1').locate
+      se_element = iframe.instance_variable_get(:@element)
+      iframe2 = browser.element(element: se_element).to_subtype
+      expect(iframe2).to eq iframe
+    end
+
+    describe '#wd' do
+      it 'returns a Watir::FramedDriver instance' do
+        iframe = browser.iframe(id: 'iframe_1')
+        expect(iframe.wd).to be_a(Watir::FramedDriver)
+      end
+
+      it 'properly delegates driver commands' do
+        iframe = browser.iframe(id: 'iframe_1')
+        expect(iframe.wd.title).to eq 'Iframes'
+      end
+
+      it 'properly delegates element commands' do
+        iframe = browser.iframe(id: 'iframe_1')
+        expect(iframe.wd.attribute('id')).to eq 'iframe_1'
+      end
+    end
+
+    describe '#exist?' do
+      it 'returns true if the iframe exists' do
+        expect(browser.iframe(id: 'iframe_1')).to exist
+        expect(browser.iframe(name: 'iframe1')).to exist
+        expect(browser.iframe(index: 0)).to exist
+        expect(browser.iframe(class: 'half')).to exist
+        expect(browser.iframe(xpath: "//iframe[@id='iframe_1']")).to exist
+        expect(browser.iframe(src: 'iframe_1.html')).to exist
+        expect(browser.iframe(id: /iframe/)).to exist
+        expect(browser.iframe(name: /iframe/)).to exist
+        expect(browser.iframe(src: /iframe_1/)).to exist
+        expect(browser.iframe(class: /half/)).to exist
+      end
+
+      it 'returns the first iframe if given no args' do
+        expect(browser.iframe).to exist
+      end
+
+      it "returns false if the iframe doesn't exist" do
+        expect(browser.iframe(id: 'no_such_id')).not_to exist
+        expect(browser.iframe(name: 'no_such_text')).not_to exist
+        expect(browser.iframe(index: 1337)).not_to exist
+        expect(browser.iframe(src: 'no_such_src')).not_to exist
+        expect(browser.iframe(class: 'no_such_class')).not_to exist
+        expect(browser.iframe(id: /no_such_id/)).not_to exist
+        expect(browser.iframe(name: /no_such_text/)).not_to exist
+        expect(browser.iframe(src: /no_such_src/)).not_to exist
+        expect(browser.iframe(class: /no_such_class/)).not_to exist
+        expect(browser.iframe(xpath: "//iframe[@id='no_such_id']")).not_to exist
+      end
+
+      it 'returns true if an element in an iframe does exist' do
+        expect(browser.iframe.element(css: '#senderElement')).to exist
+        expect(browser.iframe.element(id: 'senderElement')).to exist
+      end
+
+      it 'returns true for multiple elements that exist in an iframe with a parent selector' do
+        expect(browser.div(class: 'wrapper').iframe.element(id: 'first_grandson')).to exist
+        expect(browser.div(class: 'wrapper').iframe.element(id: 'second_grandson')).to exist
+      end
+
+      it 'returns false if an element in an iframe does not exist' do
+        expect(browser.iframe.element(css: '#no_such_id')).not_to exist
+        expect(browser.iframe.element(id: 'no_such_id')).not_to exist
+      end
+
+      it 'returns true if an element outside an iframe exists after checking for one inside that does exist' do
+        existing_element = browser.element(css: '#iframe_1')
+        expect(existing_element).to exist
+        expect(browser.iframe.element(css: '#senderElement')).to exist
+        expect(existing_element).to exist
+      end
+
+      it 'returns true if an element outside an iframe exists after checking for one inside that does not exist' do
+        existing_element = browser.element(css: '#iframe_1')
+        expect(existing_element).to exist
+        expect(browser.iframe.element(css: '#no_such_id')).not_to exist
+        expect(existing_element).to exist
+      end
+
+      it 'returns true if an element exists in a frame generated in a collection' do
+        nested_element = browser.body.iframes.first.div
+        expect(nested_element).to exist
+      end
+
+      it 'returns false for sub-element of a non-existing iframe' do
+        expect(browser.iframe(id: 'no_such_id').element).not_to exist
+      end
+
+      it 'handles nested iframes' do
+        browser.goto(WatirSpec.url_for('nested_iframes.html'))
+        browser.iframe(id: 'two').iframe(id: 'three').link(id: 'four').click
+
+        expect {
+          browser.wait_until { |b| b.title == 'definition_lists' }
+        }.not_to raise_exception
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.iframe(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    it 'handles all locators for element which do not exist' do
+      expect(browser.iframe(index: 0).div(id: 'invalid')).not_to exist
+    end
+
+    describe '#present?' do
+      it 'returns true if the iframe present' do
+        expect(browser.iframe(id: 'iframe_1')).to be_present
+      end
+
+      it 'returns false if the iframe is not present' do
+        expect(browser.iframe(id: 'no_such_id')).not_to be_present
+      end
+    end
+
+    it 'switches between iframe and parent when needed' do
+      expect {
+        browser.iframe(id: 'iframe_1').elements.each do |element|
+          element.text
+          browser.h1.text
+        end
+      }.not_to raise_exception
+    end
+
+    it 'switches when the frame is created by subtype' do
+      subtype = browser.iframe.to_subtype
+      expect { subtype.element.locate }.not_to raise_exception
+    end
+
+    it 'switches back to top level browsing context' do
+      # Point driver to browsing context of first iframe
+      browser.iframes.first.ps.locate
+
+      expect(browser.h1s.first.text).to be == 'Iframes'
+    end
+
+    it 'raises UnknownFrameException when accessing elements inside non-existing iframe' do
+      expect { browser.iframe(name: 'no_such_name').p(index: 0).id }.to raise_unknown_frame_exception
+    end
+
+    it 'raises UnknownFrameException when accessing a non-existing iframe' do
+      expect { browser.iframe(name: 'no_such_name').id }.to raise_unknown_frame_exception
+    end
+
+    it 'raises UnknownFrameException when accessing a non-existing subframe' do
+      expect { browser.iframe(name: 'iframe1').iframe(name: 'no_such_name').id }.to raise_unknown_frame_exception
+    end
+
+    it 'raises UnknownObjectException when accessing a non-existing element inside an existing iframe' do
+      expect { browser.iframe(index: 0).p(index: 1337).id }.to raise_unknown_object_exception
+    end
+
+    it "raises NoMethodError when trying to access attributes it doesn't have" do
+      expect { browser.iframe(index: 0).foo }.to raise_error(NoMethodError)
+    end
+
+    it 'is able to set a field' do
+      browser.iframe(index: 0).text_field(name: 'senderElement').set('new value')
+      expect(browser.iframe(index: 0).text_field(name: 'senderElement').value).to eq 'new value'
+    end
+
+    it 'will suggest looking in an iframe when iframes exist' do
+      msg = 'Maybe look in an iframe?'
+      expect { browser.text_field(name: 'senderElement').set('no') }.to raise_unknown_object_exception(msg)
+    end
+
+    it 'will suggest looking in a nested iframe when iframes exist' do
+      browser.goto(WatirSpec.url_for('nested_iframes.html'))
+      top = browser.iframe(id: 'two')
+      expect { top.link(id: 'four').click }.to raise_unknown_object_exception('Maybe look in an iframe?')
+    end
+
+    describe '#execute_script' do
+      it 'executes the given javascript in the specified frame',
+         except: {browser: :safari, reason: 'Safari does not strip text'} do
+        frame = browser.iframe(index: 0)
+        expect(frame.div(id: 'set_by_js').text).to eq ''
+        inner_html = 'Art consists of limitation. The most beautiful part of every picture is the frame.'
+        script = "document.getElementById('set_by_js').innerHTML = '#{inner_html}'"
+        frame.execute_script script
+        text = 'Art consists of limitation. The most beautiful part of every picture is the frame.'
+        expect(frame.div(id: 'set_by_js').text).to eq text
+      end
+    end
+
+    describe '#html' do
+      it 'returns the full HTML source of the iframe' do
+        browser.goto WatirSpec.url_for('iframes.html')
+        expect(browser.iframe.html.downcase).to include('<title>iframe 1</title>')
+      end
+    end
+
+    describe '#text' do
+      it 'returns the text inside the iframe' do
+        browser.goto WatirSpec.url_for('iframes.html')
+        expect(browser.iframe.text).to include('Frame 1')
+      end
+    end
+  end
+
+  describe FramedDriver do
+    it 'raises name error if method is not defined on driver or element' do
+      browser.goto WatirSpec.url_for('iframes.html')
+      expect(browser.iframe(id: 'iframe_1').wd).not_to respond_to :foo
+      expect { browser.iframe(id: 'iframe_1').wd.foo }.to raise_exception NoMethodError
+    end
+
+    it 'raises exception when attempting to switch to a non-frame element' do
+      browser.goto WatirSpec.url_for('iframes.html')
+      element = browser.h1.wd
+      fd = described_class.new(element, browser)
+      expect { fd.switch! }.to raise_exception Watir::Exception::UnknownFrameException
+    end
+  end
+end

data/spec/watirspec/elements/iframes_spec.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe IFrameCollection do
+    before do
+      browser.goto(WatirSpec.url_for('iframes.html'))
+    end
+
+    describe 'with selectors' do
+      it 'returns the matching elements' do
+        expect(browser.iframes(id: 'iframe_2').to_a).to eq [browser.iframe(id: 'iframe_2')]
+      end
+    end
+
+    describe 'eql?' do
+      it 'matches equality of iframe with that from a collection' do
+        expect(browser.iframes.last).to eq browser.iframe(id: 'iframe_3')
+      end
+    end
+
+    describe '#length' do
+      it 'returns the correct number of iframes' do
+        expect(browser.iframes.length).to eq 3
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the iframe at the given index' do
+        expect(browser.iframes[0].id).to eq 'iframe_1'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through frames correctly' do
+        count = 0
+
+        browser.iframes.each_with_index do |f, index|
+          expect(f.name).to eq browser.iframe(index: index).name
+          expect(f.id).to eq browser.iframe(index: index).id
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end