watir 1.4.1 → 7.3.0

data/spec/watirspec/elements/elements_spec.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe ElementCollection do
+    before do
+      browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+    end
+
+    describe '#[]' do
+      context 'when elements do not exist' do
+        it 'returns not existing element' do
+          expect(browser.elements(id: 'non-existing')[0]).not_to exist
+        end
+      end
+    end
+
+    describe '#eq and #eql?' do
+      before { browser.goto WatirSpec.url_for('forms_with_input_elements.html') }
+
+      it 'returns true if the two collections have the same Watir Elements' do
+        a = browser.select_list(name: 'new_user_languages').options
+        b = browser.select_list(id: 'new_user_languages').options
+
+        expect(a).to eq b
+        expect(a).to eql(b)
+      end
+
+      it 'returns false if the two collections are not the same' do
+        a = browser.select_list(name: 'new_user_languages').options
+        b = browser.select_list(id: 'new_user_role').options
+
+        expect(a).not_to eq b
+        expect(a).not_to eql(b)
+      end
+    end
+
+    describe 'visible text' do
+      it 'finds elements by visible text' do
+        browser.goto WatirSpec.url_for('non_control_elements.html')
+        container = browser.div(id: 'visible_text')
+
+        expect(container.elements(visible_text: 'all visible').count).to eq(1)
+        expect(container.elements(visible_text: /all visible/).count).to eq(1)
+        expect(container.elements(visible_text: /some visible/).count).to eq(1)
+      end
+
+      it 'finds elements in spite of hidden text',
+         except: {browser: :safari, reason: 'Safari is not filtering out hidden text'} do
+        browser.goto WatirSpec.url_for('non_control_elements.html')
+        container = browser.div(id: 'visible_text')
+
+        expect(container.elements(visible_text: 'some visible').count).to eq(1)
+        expect(container.elements(visible_text: 'none visible').count).to eq(0)
+        expect(container.elements(visible_text: /none visible/).count).to eq(0)
+      end
+    end
+  end
+end

data/spec/watirspec/elements/em_spec.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe 'Em' do
+    before do
+      browser.goto(WatirSpec.url_for('non_control_elements.html'))
+    end
+
+    # Exists method
+    describe '#exists?' do
+      it 'returns true if the element exists' do
+        expect(browser.em(id: 'important-id')).to exist
+        expect(browser.em(class: 'important-class')).to exist
+        expect(browser.em(xpath: "//em[@id='important-id']")).to exist
+        expect(browser.em(index: 0)).to exist
+      end
+
+      it 'returns the first em if given no args' do
+        expect(browser.em).to exist
+      end
+
+      it 'returns false if the element does not exist' do
+        expect(browser.em(id: 'no_such_id')).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.em(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    # Attribute methods
+    describe '#id' do
+      it 'returns the id attribute if the element exists' do
+        expect(browser.em(class: 'important-class').id).to eq 'important-id'
+      end
+
+      it 'raises UnknownObjectException if the element does not exist' do
+        expect { browser.em(id: 'no_such_id').id }.to raise_unknown_object_exception
+        expect { browser.em(title: 'no_such_id').id }.to raise_unknown_object_exception
+        expect { browser.em(index: 1337).id }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#title' do
+      it 'returns the title of the element' do
+        expect(browser.em(class: 'important-class').title).to eq 'ergo cogito'
+      end
+    end
+
+    describe '#text' do
+      it 'returns the text of the element' do
+        expect(browser.em(id: 'important-id').text).to eq 'ergo cogito'
+      end
+
+      it 'raises UnknownObjectException if the element does not exist' do
+        expect { browser.em(id: 'no_such_id').text }.to raise_unknown_object_exception
+        expect { browser.em(title: 'no_such_title').text }.to raise_unknown_object_exception
+        expect { browser.em(index: 1337).text }.to raise_unknown_object_exception
+        expect { browser.em(xpath: "//em[@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.em(index: 0)).to respond_to(:id)
+        expect(browser.em(index: 0)).to respond_to(:class_name)
+        expect(browser.em(index: 0)).to respond_to(:style)
+        expect(browser.em(index: 0)).to respond_to(:text)
+        expect(browser.em(index: 0)).to respond_to(:title)
+      end
+    end
+
+    # Manipulation methods
+    describe '#click' do
+      it 'raises UnknownObjectException if the element does not exist' do
+        expect { browser.em(id: 'no_such_id').click }.to raise_unknown_object_exception
+        expect { browser.em(title: 'no_such_title').click }.to raise_unknown_object_exception
+        expect { browser.em(index: 1337).click }.to raise_unknown_object_exception
+        expect { browser.em(xpath: "//em[@id='no_such_id']").click }.to raise_unknown_object_exception
+      end
+    end
+  end
+end

data/spec/watirspec/elements/ems_spec.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe 'Ems' 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.ems(class: 'important-class').to_a).to eq [browser.em(class: 'important-class')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of ems' do
+        expect(browser.ems.length).to eq 1
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the em at the given index' do
+        expect(browser.ems[0].id).to eq 'important-id'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through ems correctly' do
+        count = 0
+
+        browser.ems.each_with_index do |e, index|
+          expect(e.text).to eq browser.em(index: index).text
+          expect(e.id).to eq browser.em(index: index).id
+          expect(e.class_name).to eq browser.em(index: index).class_name
+
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/elements/filefield_spec.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe FileField do
+    before do
+      browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+    end
+
+    describe '#exist?' do
+      it 'returns true if the file field exists' do
+        expect(browser.file_field(id: 'new_user_portrait')).to exist
+        expect(browser.file_field(id: /new_user_portrait/)).to exist
+        expect(browser.file_field(name: 'new_user_portrait')).to exist
+        expect(browser.file_field(name: /new_user_portrait/)).to exist
+        expect(browser.file_field(class: 'portrait')).to exist
+        expect(browser.file_field(class: /portrait/)).to exist
+        expect(browser.file_field(index: 0)).to exist
+        expect(browser.file_field(xpath: "//input[@id='new_user_portrait']")).to exist
+      end
+
+      it 'returns the first file field if given no args' do
+        expect(browser.file_field).to exist
+      end
+
+      it 'returns true for element with upper case type' do
+        expect(browser.file_field(id: 'new_user_resume')).to exist
+      end
+
+      it "returns false if the file field doesn't exist" do
+        expect(browser.file_field(id: 'no_such_id')).not_to exist
+        expect(browser.file_field(id: /no_such_id/)).not_to exist
+        expect(browser.file_field(name: 'no_such_name')).not_to exist
+        expect(browser.file_field(name: /no_such_name/)).not_to exist
+        expect(browser.file_field(class: 'no_such_class')).not_to exist
+        expect(browser.file_field(class: /no_such_class/)).not_to exist
+        expect(browser.file_field(index: 1337)).not_to exist
+        expect(browser.file_field(xpath: "//input[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.file_field(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.file_field(index: 0).id).to eq 'new_user_portrait'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.file_field(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.file_field(index: 0).name).to eq 'new_user_portrait'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.file_field(index: 1337).name }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#title' do
+      it 'returns the title attribute if the text field exists' do
+        expect(browser.file_field(id: 'new_user_portrait').title).to eq 'Smile!'
+      end
+    end
+
+    describe '#type' do
+      it 'returns the type attribute if the text field exists' do
+        expect(browser.file_field(index: 0).type).to eq 'file'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.file_field(index: 1337).type }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#respond_to?' do
+      it 'returns true for all attribute methods' do
+        expect(browser.file_field(index: 0)).to respond_to(:class_name)
+        expect(browser.file_field(index: 0)).to respond_to(:id)
+        expect(browser.file_field(index: 0)).to respond_to(:name)
+        expect(browser.file_field(index: 0)).to respond_to(:title)
+        expect(browser.file_field(index: 0)).to respond_to(:type)
+        expect(browser.file_field(index: 0)).to respond_to(:value)
+      end
+    end
+
+    # Manipulation methods
+
+    describe '#set' do
+      it 'is able to set a file path in the field and click the upload button and fire the onchange event' do
+        browser.goto WatirSpec.url_for('forms_with_input_elements.html')
+
+        element = browser.file_field(name: 'new_user_portrait')
+        element.upload __FILE__
+
+        expect(element.value).to include(File.basename(__FILE__)) # only some browser will return the full path
+        expect(messages.first).to include(File.basename(__FILE__))
+
+        browser.button(name: 'new_user_submit').click
+      end
+
+      it 'raises an error if the file does not exist' do
+        expect {
+          browser.file_field.set(File.join(Dir.tmpdir, 'unlikely-to-exist'))
+        }.to raise_error(Errno::ENOENT)
+      end
+    end
+
+    describe '#value=', exclude: {browser: :ie} do
+      it 'is able to set a file path in the field and click the upload button and fire the onchange event' do
+        browser.goto WatirSpec.url_for('forms_with_input_elements.html')
+
+        path = File.expand_path(__FILE__)
+        element = browser.file_field(name: 'new_user_portrait')
+
+        element.value = path
+        expect(element.value).to include(File.basename(path)) # only some browser will return the full path
+      end
+
+      it 'does not alter its argument' do
+        value = File.expand_path '.rubocop.yml'
+        browser.file_field.value = value
+        expect(value).to match(/\.rubocop\.yml$/)
+      end
+    end
+  end
+end

data/spec/watirspec/elements/filefields_spec.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe FileFieldCollection 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.file_fields(class: 'portrait').to_a).to eq [browser.file_field(class: 'portrait')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the correct number of file fields' do
+        expect(browser.file_fields.length).to eq 3
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the file field at the given index' do
+        expect(browser.file_fields[0].id).to eq 'new_user_portrait'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through file fields correctly' do
+        count = 0
+
+        browser.file_fields.each_with_index do |f, index|
+          expect(f.name).to eq browser.file_field(index: index).name
+          expect(f.id).to eq browser.file_field(index: index).id
+          expect(f.value).to eq browser.file_field(index: index).value
+
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/elements/font_spec.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe Font do
+    before do
+      browser.goto(WatirSpec.url_for('font.html'))
+    end
+
+    it 'finds the font element' do
+      expect(browser.font(index: 0)).to exist
+    end
+
+    it 'knows about the color attribute' do
+      expect(browser.font(index: 0).color).to eq '#ff00ff'
+    end
+
+    it 'knows about the face attribute' do
+      expect(browser.font(index: 0).face).to eq 'Helvetica'
+    end
+
+    it 'knows about the size attribute' do
+      expect(browser.font(index: 0).size).to eq '12'
+    end
+
+    it 'finds all font elements' do
+      expect(browser.fonts.size).to eq 1
+    end
+  end
+end

data/spec/watirspec/elements/form_spec.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe Form do
+    before do
+      browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+    end
+
+    describe '#exists?' do
+      it 'returns true if the form exists' do
+        expect(browser.form(id: 'new_user')).to exist
+        expect(browser.form(id: /new_user/)).to exist
+
+        expect(browser.form(class: 'user')).to exist
+        expect(browser.form(class: /user/)).to exist
+
+        expect(browser.form(method: 'post')).to exist
+        expect(browser.form(method: /post/)).to exist
+        expect(browser.form(action: /to_me/)).to exist
+        expect(browser.form(index: 0)).to exist
+        expect(browser.form(xpath: "//form[@id='new_user']")).to exist
+      end
+
+      it 'returns the first form if given no args' do
+        expect(browser.form).to exist
+      end
+
+      it "returns false if the form doesn't exist" do
+        expect(browser.form(id: 'no_such_id')).not_to exist
+        expect(browser.form(id: /no_such_id/)).not_to exist
+
+        expect(browser.form(class: 'no_such_class')).not_to exist
+        expect(browser.form(class: /no_such_class/)).not_to exist
+
+        expect(browser.form(method: 'no_such_method')).not_to exist
+        expect(browser.form(method: /no_such_method/)).not_to exist
+        expect(browser.form(action: 'no_such_action')).not_to exist
+        expect(browser.form(action: /no_such_action/)).not_to exist
+        expect(browser.form(index: 1337)).not_to exist
+        expect(browser.form(xpath: "//form[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.form(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    describe '#submit' do
+      it 'submits the form' do
+        browser.form(id: 'delete_user').submit
+        browser.wait_while(url: /forms_with_input_elements\.html$/)
+        expect(browser.text).to include('Semantic table')
+      end
+
+      it 'triggers onsubmit event and takes its result into account' do
+        form = browser.form(name: 'user_new')
+        form.submit
+        expect(form).to exist
+        expect(messages.size).to eq 1
+        expect(messages[0]).to eq 'submit'
+      end
+
+      it 'times out when submitting an element that is not displayed' do
+        expect { browser.form(name: 'no').submit }.to raise_unknown_object_exception
+      end
+    end
+  end
+end

data/spec/watirspec/elements/forms_spec.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe FormCollection 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.forms(method: 'post').to_a).to eq [browser.form(method: 'post')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of forms in the container' do
+        expect(browser.forms.length).to eq 2
+      end
+    end
+
+    describe '#[]n' do
+      it 'provides access to the nth form' do
+        expect(browser.forms[0].action).to match(/post_to_me$/) # varies between browsers
+        expect(browser.forms[0].attribute_value('method')).to eq 'post'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through forms correctly' do
+        count = 0
+
+        browser.forms.each_with_index do |f, index|
+          expect(f.name).to eq browser.form(index: index).name
+          expect(f.id).to eq browser.form(index: index).id
+          expect(f.class_name).to eq browser.form(index: index).class_name
+
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/elements/frame_spec.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+#
+# TODO: fix duplication with iframe_spec
+#
+
+module Watir
+  describe Frame do
+    before do
+      browser.goto(WatirSpec.url_for('frames.html'))
+    end
+
+    it 'handles crossframe javascript' do
+      expect(browser.frame(id: 'frame_1').text_field(name: 'senderElement').value).to eq 'send_this_value'
+      expect(browser.frame(id: 'frame_2').text_field(name: 'recieverElement').value).to eq 'old_value'
+      browser.frame(id: 'frame_1').button(id: 'send').click
+      expect(browser.frame(id: 'frame_2').text_field(name: 'recieverElement').value).to eq 'send_this_value'
+    end
+
+    describe '#exist?' do
+      it 'returns true if the frame exists' do
+        expect(browser.frame(id: 'frame_1')).to exist
+        expect(browser.frame(name: 'frame1')).to exist
+        expect(browser.frame(index: 0)).to exist
+        expect(browser.frame(class: 'half')).to exist
+        expect(browser.frame(xpath: "//frame[@id='frame_1']")).to exist
+        expect(browser.frame(src: 'frame_1.html')).to exist
+        expect(browser.frame(id: /frame/)).to exist
+        expect(browser.frame(name: /frame/)).to exist
+        expect(browser.frame(src: /frame_1/)).to exist
+        expect(browser.frame(class: /half/)).to exist
+      end
+
+      it 'returns the first frame if given no args' do
+        expect(browser.frame).to exist
+      end
+
+      it "returns false if the frame doesn't exist" do
+        expect(browser.frame(id: 'no_such_id')).not_to exist
+        expect(browser.frame(name: 'no_such_text')).not_to exist
+        expect(browser.frame(index: 1337)).not_to exist
+        expect(browser.frame(src: 'no_such_src')).not_to exist
+        expect(browser.frame(class: 'no_such_class')).not_to exist
+        expect(browser.frame(id: /no_such_id/)).not_to exist
+        expect(browser.frame(name: /no_such_text/)).not_to exist
+        expect(browser.frame(src: /no_such_src/)).not_to exist
+        expect(browser.frame(class: /no_such_class/)).not_to exist
+        expect(browser.frame(xpath: "//frame[@id='no_such_id']")).not_to exist
+      end
+
+      it 'handles nested frames' do
+        browser.goto(WatirSpec.url_for('nested_frames.html'))
+
+        browser.frame(id: 'two').frame(id: 'three').link(id: 'four').click
+
+        browser.wait_until(title: 'definition_lists')
+        expect { browser.goto(WatirSpec.url_for('nested_frames.html')) }.not_to raise_exception
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.frame(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    it 'raises UnknownFrameException when accessing elements inside non-existing frame' do
+      expect { browser.frame(name: 'no_such_name').p(index: 0).id }.to raise_unknown_frame_exception
+    end
+
+    it 'raises UnknownFrameException when accessing a non-existing frame' do
+      expect { browser.frame(name: 'no_such_name').id }.to raise_unknown_frame_exception
+    end
+
+    it 'raises UnknownFrameException when accessing a non-existing subframe' do
+      expect { browser.frame(name: 'frame1').frame(name: 'no_such_name').id }.to raise_unknown_frame_exception
+    end
+
+    it 'raises UnknownObjectException when accessing a non-existing element inside an existing frame' do
+      expect { browser.frame(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.frame(index: 0).foo }.to raise_error(NoMethodError)
+    end
+
+    it 'is able to set a field' do
+      browser.frame(index: 0).text_field(name: 'senderElement').set('new value')
+      expect(browser.frame(index: 0).text_field(name: 'senderElement').value).to eq 'new value'
+    end
+
+    it "can access the frame's parent element after use" do
+      el = browser.frameset
+      el.frame.text_field.value
+      expect(el.attribute_value('cols')).to be_a(String)
+    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.frame(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.'
+        frame.execute_script(%{document.getElementById('set_by_js').innerHTML = '#{inner_html}'})
+        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 frame' do
+        browser.goto WatirSpec.url_for('frames.html')
+        expect(browser.frame.html.downcase).to include('<title>frame 1</title>')
+      end
+    end
+  end
+end

data/spec/watirspec/elements/frames_spec.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe FrameCollection do
+    before do
+      browser.goto(WatirSpec.url_for('frames.html'))
+    end
+
+    describe 'with selectors' do
+      it 'returns the matching elements' do
+        expect(browser.frames(name: 'frame2').to_a).to eq [browser.frame(name: 'frame2')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the correct number of frames' do
+        expect(browser.frames.length).to eq 2
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the frame at the given index' do
+        expect(browser.frames[0].id).to eq 'frame_1'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through frames correctly' do
+        count = 0
+
+        browser.frames.each_with_index do |f, index|
+          expect(f.name).to eq browser.frame(index: index).name
+          expect(f.id).to eq browser.frame(index: index).id
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end