watir 1.4.1 → 7.3.0

data/spec/watirspec/adjacent_spec.rb

@@ -0,0 +1,256 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe Element do
+    before(:all) do
+      browser.goto(WatirSpec.url_for('nested_elements.html'))
+    end
+
+    describe '#parent' do
+      it 'gets immediate parent of an element by default' do
+        expect(browser.div(id: 'first_sibling').parent.id).to eq 'parent'
+        expect(browser.div(id: 'first_sibling').parent).to be_a Watir::HTMLElement
+      end
+
+      it 'accepts index argument' do
+        expect(browser.div(id: 'first_sibling').parent(index: 2).id).to eq 'grandparent'
+        expect(browser.div(id: 'first_sibling').parent(index: 2)).to be_a Watir::HTMLElement
+      end
+
+      it 'accepts tag_name argument' do
+        expect(browser.div(id: 'first_sibling').parent(tag_name: 'div').id).to eq 'parent'
+        expect(browser.div(id: 'first_sibling').parent(tag_name: 'div')).to be_a Watir::Div
+      end
+
+      it 'accepts custom tag_name argument' do
+        expect(browser.div(id: 'regular_child').parent(tag_name: 'grandelement').id).to eq 'custom_grandparent'
+        expect(browser.div(id: 'regular_child').parent(tag_name: 'grandelement')).to be_a Watir::HTMLElement
+      end
+
+      it 'accepts class_name argument' do
+        expect(browser.div(id: 'first_sibling').parent(class_name: 'parent').id).to eq 'parent_span'
+      end
+
+      it 'accepts index and tag_name arguments' do
+        expect(browser.div(id: 'first_sibling').parent(tag_name: 'div', index: 1).id).to eq 'grandparent'
+        expect(browser.div(id: 'first_sibling').parent(tag_name: 'div', index: 1)).to be_a Watir::Div
+      end
+
+      it 'does not error when no parent element of an index exists' do
+        expect(browser.body.parent(index: 2)).not_to exist
+      end
+
+      it 'does not error when no parent element of a tag_name exists' do
+        expect(browser.div(id: 'first_sibling').parent(tag_name: 'table')).not_to exist
+      end
+    end
+
+    describe '#siblings' do
+      it 'gets collection of all siblings of an element' do
+        expect(browser.div(id: 'second_sibling').siblings).to be_a Watir::HTMLElementCollection
+        expect(browser.div(id: 'second_sibling').siblings.size).to eq 5
+      end
+
+      it 'accepts a tag name argument' do
+        siblings = browser.div(id: 'second_sibling').siblings(tag_name: 'div')
+        expect(siblings.size).to eq 3
+        expect(siblings.all?(Watir::Div)).to be true
+      end
+
+      it 'accepts custom tag name argument' do
+        siblings = browser.div(id: 'regular_child').siblings(tag_name: 'childelement')
+        expect(siblings.size).to eq 3
+        expect(siblings.all?(Watir::HTMLElement)).to be true
+      end
+
+      it 'accepts a class_name argument' do
+        siblings = browser.div(id: 'second_sibling').siblings(class_name: 'b')
+        expect(siblings.first).to be_a Watir::Div
+        expect(siblings[0]).to be_a Watir::Div
+        expect(siblings.size).to eq 2
+        expect(siblings.all?(Watir::Div)).to be true
+      end
+    end
+
+    describe '#following_sibling' do
+      it 'gets immediate following sibling of an element by default' do
+        expect(browser.div(id: 'first_sibling').following_sibling.id).to eq 'between_siblings1'
+        expect(browser.div(id: 'first_sibling').following_sibling).to be_a Watir::HTMLElement
+      end
+
+      it 'accepts index argument' do
+        expect(browser.div(id: 'first_sibling').following_sibling(index: 2).id).to eq 'between_siblings2'
+        expect(browser.div(id: 'first_sibling').following_sibling(index: 2)).to be_a Watir::HTMLElement
+      end
+
+      it 'accepts tag_name argument' do
+        expect(browser.div(id: 'first_sibling').following_sibling(tag_name: 'div').id).to eq 'second_sibling'
+        expect(browser.div(id: 'first_sibling').following_sibling(tag_name: 'div')).to be_a Watir::Div
+      end
+
+      it 'accepts class_name argument' do
+        expect(browser.div(id: 'first_sibling').following_sibling(class_name: 'b').id).to eq 'second_sibling'
+      end
+
+      it 'accepts index and tag_name arguments' do
+        expect(browser.div(id: 'first_sibling').following_sibling(tag_name: 'div', index: 1).id).to eq 'third_sibling'
+        expect(browser.div(id: 'first_sibling').following_sibling(tag_name: 'div', index: 1)).to be_a Watir::Div
+      end
+
+      it 'accepts text as Regexp' do
+        expect(browser.div(id: 'first_sibling').following_sibling(text: /T/).id).to eq 'third_sibling'
+      end
+
+      it 'accepts text as String' do
+        expect(browser.div(id: 'first_sibling').following_sibling(text: 'Third').id).to eq 'third_sibling'
+      end
+
+      it 'does not error when no next sibling of an index exists' do
+        expect(browser.body.following_sibling(index: 1)).not_to exist
+      end
+
+      it 'does not error when no next sibling of a tag_name exists' do
+        expect(browser.div(id: 'first_sibling').following_sibling(tag_name: 'table')).not_to exist
+      end
+    end
+
+    describe '#following_siblings' do
+      it 'gets collection of subsequent siblings of an element by default' do
+        expect(browser.div(id: 'second_sibling').following_siblings).to be_a Watir::HTMLElementCollection
+        expect(browser.div(id: 'second_sibling').following_siblings.size).to eq 2
+      end
+
+      it 'accepts tag_name argument' do
+        expect(browser.div(id: 'second_sibling').following_siblings(tag_name: 'div').size).to eq 1
+        expect(browser.div(id: 'second_sibling').following_siblings(tag_name: 'div').first).to be_a Watir::Div
+      end
+
+      it 'accepts class_name argument for single class' do
+        expect(browser.div(id: 'second_sibling').following_siblings(class_name: 'b').size).to eq 1
+        expect(browser.div(id: 'second_sibling').following_siblings(class_name: 'b').first).to be_a Watir::Div
+      end
+
+      it 'accepts class_name argument for multiple classes' do
+        expect(browser.div(id: 'second_sibling').following_siblings(class_name: %w[a b]).size).to eq 1
+        expect(browser.div(id: 'second_sibling').following_siblings(class_name: %w[a b]).first).to be_a Watir::Div
+      end
+    end
+
+    describe '#previous_sibling' do
+      it 'gets immediate preceeding sibling of an element by default' do
+        expect(browser.div(id: 'third_sibling').previous_sibling.id).to eq 'between_siblings2'
+        expect(browser.div(id: 'third_sibling').previous_sibling).to be_a Watir::HTMLElement
+      end
+
+      it 'accepts index argument' do
+        expect(browser.div(id: 'third_sibling').previous_sibling(index: 2).id).to eq 'between_siblings1'
+        expect(browser.div(id: 'third_sibling').previous_sibling(index: 2)).to be_a Watir::HTMLElement
+      end
+
+      it 'accepts tag_name argument' do
+        expect(browser.div(id: 'third_sibling').previous_sibling(tag_name: 'div').id).to eq 'second_sibling'
+        expect(browser.div(id: 'third_sibling').previous_sibling(tag_name: 'div')).to be_a Watir::Div
+      end
+
+      it 'accepts class_name argument' do
+        expect(browser.div(id: 'third_sibling').previous_sibling(class_name: 'a').id).to eq 'between_siblings2'
+      end
+
+      it 'accepts index and tag_name arguments' do
+        expect(browser.div(id: 'third_sibling').previous_sibling(tag_name: 'div', index: 1).id).to eq 'first_sibling'
+        expect(browser.div(id: 'third_sibling').previous_sibling(tag_name: 'div', index: 1)).to be_a Watir::Div
+      end
+
+      it 'does not error when no next sibling of an index exists' do
+        expect(browser.body.previous_sibling(index: 1)).not_to exist
+      end
+
+      it 'does not error when no next sibling of a tag_name exists' do
+        expect(browser.div(id: 'third_sibling').previous_sibling(tag_name: 'table')).not_to exist
+      end
+    end
+
+    describe '#previous_siblings' do
+      it 'gets collection of previous siblings of an element by default' do
+        expect(browser.div(id: 'second_sibling').previous_siblings).to be_a Watir::HTMLElementCollection
+        expect(browser.div(id: 'second_sibling').previous_siblings.size).to eq 2
+      end
+
+      it 'accepts tag_name argument' do
+        expect(browser.div(id: 'second_sibling').previous_siblings(tag_name: 'div').size).to eq 1
+        expect(browser.div(id: 'second_sibling').previous_siblings(tag_name: 'div').first).to be_a Watir::Div
+      end
+
+      it 'accepts class_name argument' do
+        expect(browser.div(id: 'second_sibling').previous_siblings(class_name: 'a').size).to eq 1
+        expect(browser.div(id: 'second_sibling').previous_siblings(class_name: 'a').first.id).to eq 'between_siblings1'
+      end
+    end
+
+    describe '#child' do
+      it 'gets immediate child of an element by default' do
+        expect(browser.div(id: 'parent').child.id).to eq 'first_sibling'
+        expect(browser.div(id: 'parent').child).to be_a Watir::HTMLElement
+      end
+
+      it 'accepts index argument' do
+        expect(browser.div(id: 'parent').child(index: 2).id).to eq 'second_sibling'
+        expect(browser.div(id: 'parent').child(index: 2)).to be_a Watir::HTMLElement
+      end
+
+      it 'accepts tag_name argument' do
+        expect(browser.div(id: 'parent').child(tag_name: 'span').id).to eq 'between_siblings1'
+        expect(browser.div(id: 'parent').child(tag_name: 'span')).to be_a Watir::Span
+      end
+
+      it 'accepts custom tag_name argument' do
+        expect(browser.element(id: 'custom_parent').child(tag_name: 'childelement').id).to eq 'custom_child'
+        expect(browser.element(id: 'custom_parent').child(tag_name: 'childelement')).to be_a Watir::HTMLElement
+      end
+
+      it 'accepts class_name argument' do
+        expect(browser.div(id: 'parent').child(class_name: 'b').id).to eq 'second_sibling'
+      end
+
+      it 'accepts index and tag_name arguments' do
+        expect(browser.div(id: 'parent').child(tag_name: 'div', index: 1).id).to eq 'second_sibling'
+        expect(browser.div(id: 'parent').child(tag_name: 'div', index: 1)).to be_a Watir::Div
+      end
+
+      it 'does not error when no next sibling of an index exists' do
+        expect(browser.div(id: 'second_sibling').child(index: 1)).not_to exist
+      end
+
+      it 'does not error when no next sibling of a tag_name exists' do
+        expect(browser.div(id: 'parent').child(tag_name: 'table')).not_to exist
+      end
+    end
+
+    describe '#children' do
+      it 'gets collection of children of an element by default' do
+        expect(browser.div(id: 'parent').children).to be_a Watir::HTMLElementCollection
+        expect(browser.div(id: 'parent').children.size).to eq 5
+      end
+
+      it 'accepts tag_name argument' do
+        children = browser.div(id: 'parent').children(tag_name: 'div')
+        expect(children.size).to eq 3
+        expect(children.all?(Watir::Div)).to be true
+      end
+
+      it 'accepts custom tag_name argument' do
+        children = browser.element(id: 'custom_parent').children(tag_name: 'childelement')
+        expect(children.size).to eq 3
+        expect(children.all?(Watir::HTMLElement)).to be true
+      end
+
+      it 'accepts a class_name argument' do
+        children = browser.div(id: 'parent').children(class_name: 'b')
+        expect(children.size).to eq 2
+        expect(children.all?(Watir::Div)).to be true
+      end
+    end
+  end
+end

data/spec/watirspec/after_hooks_spec.rb

@@ -0,0 +1,204 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe AfterHooks do
+    describe '#add' do
+      it 'raises ArgumentError when not given any arguments' do
+        expect { browser.after_hooks.add }.to raise_error(ArgumentError)
+      end
+
+      it 'runs the given proc on each page load' do
+        proc = proc { |browser| @output = browser.text }
+
+        begin
+          browser.alert.dismiss if browser.alert.exists?
+          browser.after_hooks.add(proc)
+          browser.goto(WatirSpec.url_for('non_control_elements.html'))
+
+          expect(@output).to include('Dubito, ergo cogito, ergo sum')
+        ensure
+          browser.after_hooks.delete(proc)
+        end
+      end
+
+      it 'runs the given block on each page load' do
+        browser.after_hooks.add { |browser| @output = browser.text }
+        browser.goto(WatirSpec.url_for('non_control_elements.html'))
+
+        expect(@output).to include('Dubito, ergo cogito, ergo sum')
+      ensure
+        browser.after_hooks.delete browser.after_hooks[0]
+      end
+    end
+
+    describe '#delete' do
+      it 'removes a previously added after_hook' do
+        after_hook = ->(browser) { @output = browser.text }
+
+        browser.after_hooks.add(after_hook)
+        browser.goto(WatirSpec.url_for('non_control_elements.html'))
+        expect(@output).to include('Dubito, ergo cogito, ergo sum')
+
+        browser.after_hooks.delete(after_hook)
+        browser.goto(WatirSpec.url_for('definition_lists.html'))
+        expect(@output).not_to include('definition_lists')
+      end
+    end
+
+    describe '#run' do
+      before { @yield = nil }
+
+      after do
+        browser.after_hooks.delete @page_after_hook
+      end
+
+      it 'runs after_hooks after Browser#goto' do
+        @page_after_hook = proc { @yield = browser.title == 'The font element' }
+        browser.after_hooks.add @page_after_hook
+        browser.goto WatirSpec.url_for('font.html')
+        expect(@yield).to be true
+      end
+
+      it 'runs after_hooks after Browser#refresh' do
+        browser.goto WatirSpec.url_for('font.html')
+        @page_after_hook = proc do
+          @yield = browser.title == 'The font element'
+        end
+        browser.after_hooks.add @page_after_hook
+        browser.refresh
+        expect(@yield).to be true
+      end
+
+      it 'runs after_hooks after Element#click' do
+        browser.goto(WatirSpec.url_for('non_control_elements.html'))
+        @page_after_hook = proc do
+          browser.wait_until { |b| b.title == 'Forms with input elements' }
+          @yield = true
+        end
+        browser.after_hooks.add @page_after_hook
+        browser.link(index: 2).click
+        expect(@yield).to be true
+      end
+
+      it 'runs after_hooks after Element#submit' do
+        browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+        @page_after_hook = proc { @yield = browser.div(id: 'messages').text == 'submit' }
+        browser.after_hooks.add @page_after_hook
+        browser.form(id: 'new_user').submit
+        expect(@yield).to be true
+      end
+
+      it 'runs after_hooks after Element#double_click' do
+        browser.goto(WatirSpec.url_for('non_control_elements.html'))
+        @page_after_hook = proc { @yield = browser.title == 'Non-control elements' }
+        browser.after_hooks.add @page_after_hook
+        div = browser.div(id: 'html_test')
+        div.double_click
+        expect(@yield).to be true
+      end
+
+      it 'runs after_hooks after Element#right_click' do
+        browser.goto(WatirSpec.url_for('right_click.html'))
+        @page_after_hook = proc { @yield = browser.title == 'Right Click Test' }
+        browser.after_hooks.add @page_after_hook
+        div = browser.div(id: 'click')
+        div.right_click
+        expect(@yield).to be true
+      end
+
+      it 'runs after_hooks after Alert#ok' do
+        browser.goto(WatirSpec.url_for('alerts.html'))
+        @page_after_hook = proc { @yield = browser.title == 'Alerts' }
+        browser.after_hooks.add @page_after_hook
+        browser.after_hooks.without { browser.button(id: 'alert').click }
+        browser.alert.ok
+        expect(@yield).to be true
+      end
+
+      it 'runs after_hooks after Alert#close' do
+        browser.goto(WatirSpec.url_for('alerts.html'))
+        @page_after_hook = proc { @yield = browser.title == 'Alerts' }
+        browser.after_hooks.add @page_after_hook
+        browser.after_hooks.without { browser.button(id: 'alert').click }
+        browser.alert.close
+        expect(@yield).to be true
+      end
+
+      it 'does not run error checks with alert present' do
+        browser.goto WatirSpec.url_for('alerts.html')
+
+        @page_after_hook = proc { @yield = browser.title == 'Alerts' }
+        browser.after_hooks.add @page_after_hook
+
+        browser.button(id: 'alert').click
+        expect(@yield).to be_nil
+
+        browser.alert.ok
+        expect(@yield).to be true
+      end
+
+      it 'does not raise error when running error checks using #after_hooks#without with alert present' do
+        url = WatirSpec.url_for('alerts.html')
+        @page_after_hook = proc { browser.url }
+        browser.after_hooks.add @page_after_hook
+        browser.goto url
+        expect { browser.after_hooks.without { browser.button(id: 'alert').click } }.not_to raise_error
+        browser.alert.ok
+      end
+
+      it 'does not raise error if no error checks are defined with alert present' do
+        url = WatirSpec.url_for('alerts.html')
+        @page_after_hook = proc { browser.url }
+        browser.after_hooks.add @page_after_hook
+        browser.goto url
+        browser.after_hooks.delete @page_after_hook
+        expect { browser.button(id: 'alert').click }.not_to raise_error
+        browser.alert.ok
+      end
+
+      it 'does not raise error when running error checks on closed window',
+         exclude: [{browser: :safari,
+                    reason: 'Clicking an Element that Closes a Window is returning NoMatchingWindowFoundException'},
+                   {browser: :firefox,
+                    platform: :windows,
+                    reason: 'https://github.com/mozilla/geckodriver/issues/1847'},
+                   {browser: :ie,
+                    reason: 'IE and windows do not play well together'}] do
+        url = WatirSpec.url_for('window_switching.html')
+        @page_after_hook = proc { browser.url }
+        browser.after_hooks.add @page_after_hook
+        browser.goto url
+        browser.a(id: 'open').click
+
+        window = browser.window(title: 'closeable window')
+        window.use
+        expect { browser.a(id: 'close').click }.not_to raise_error
+        browser.original_window.use
+      end
+    end
+
+    describe '#length' do
+      it 'provides the number of after hooks' do
+        hook = proc { true }
+        begin
+          4.times { browser.after_hooks.add(hook) }
+          expect(browser.after_hooks.length).to eq 4
+        ensure
+          4.times { browser.after_hooks.delete(hook) }
+        end
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the after hook at the provided index' do
+        hook1 = proc { true }
+        hook2 = proc { false }
+        browser.after_hooks.add(hook1)
+        browser.after_hooks.add(hook2)
+        expect(browser.after_hooks[1]).to eq hook2
+      end
+    end
+  end
+end

data/spec/watirspec/alert_spec.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe Alert do
+    before do
+      browser.goto WatirSpec.url_for('alerts.html')
+    end
+
+    after do
+      browser.alert.ok if browser.alert.exists?
+    end
+
+    describe 'Waits' do
+      context 'when acting on an alert' do
+        it 'raises exception after timing out' do
+          expect { browser.alert.text }.to wait_and_raise_unknown_object_exception
+        end
+      end
+    end
+
+    describe 'alert' do
+      describe '#text' do
+        it 'returns text of alert' do
+          browser.button(id: 'alert').click
+          expect(browser.alert.text).to include('ok')
+        end
+      end
+
+      describe '#exists?' do
+        it 'returns false if alert is not present' do
+          expect(browser.alert).not_to exist
+        end
+
+        it 'returns true if alert is present' do
+          browser.button(id: 'alert').click
+          browser.wait_until(timeout: 10) { browser.alert.exists? }
+          expect(browser.alert.exist?).to be true
+        end
+      end
+
+      describe '#ok' do
+        it 'closes alert' do
+          browser.button(id: 'alert').click
+          browser.alert.ok
+          expect(browser.alert).not_to exist
+        end
+      end
+
+      describe '#close' do
+        it 'closes alert' do
+          browser.button(id: 'alert').click
+          browser.alert.close
+          expect(browser.alert).not_to exist
+        end
+      end
+    end
+
+    describe 'confirm' do
+      describe '#ok' do
+        it 'accepts confirm' do
+          browser.button(id: 'confirm').click
+          browser.alert.ok
+          expect(browser.button(id: 'confirm').value).to eq 'true'
+        end
+      end
+
+      describe '#close' do
+        it 'cancels confirm' do
+          browser.button(id: 'confirm').click
+          browser.alert.close
+          expect(browser.button(id: 'confirm').value).to eq 'false'
+        end
+      end
+    end
+
+    describe 'prompt' do
+      describe '#set' do
+        it 'enters text to prompt' do
+          browser.button(id: 'prompt').click
+          browser.alert.set 'My Name'
+          browser.alert.ok
+          expect(browser.button(id: 'prompt').value).to eq 'My Name'
+        end
+      end
+    end
+  end
+end