watir 1.4.1 → 7.3.0

data/spec/watirspec/elements/dd_spec.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe 'Dd' do
+    before do
+      browser.goto(WatirSpec.url_for('definition_lists.html'))
+    end
+
+    # Exists method
+    describe '#exists?' do
+      it 'returns true if the element exists' do
+        expect(browser.dd(id: 'someone')).to exist
+        expect(browser.dd(class: 'name')).to exist
+        expect(browser.dd(xpath: "//dd[@id='someone']")).to exist
+        expect(browser.dd(index: 0)).to exist
+      end
+
+      it 'returns the first dd if given no args' do
+        expect(browser.dd).to exist
+      end
+
+      it 'returns false if the element does not exist' do
+        expect(browser.dd(id: 'no_such_id')).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.dd(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.dd(class: 'name').id).to eq 'someone'
+      end
+
+      it "returns an empty string if the element exists, but the attribute doesn't" do
+        expect(browser.dd(class: 'address').id).to eq ''
+      end
+
+      it 'raises UnknownObjectException if the element does not exist' do
+        expect { browser.dd(id: 'no_such_id').id }.to raise_unknown_object_exception
+        expect { browser.dd(title: 'no_such_id').id }.to raise_unknown_object_exception
+        expect { browser.dd(index: 1337).id }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#title' do
+      it 'returns the title of the element' do
+        expect(browser.dd(class: 'name').title).to eq 'someone'
+      end
+    end
+
+    describe '#text' do
+      it 'returns the text of the element' do
+        expect(browser.dd(id: 'someone').text).to eq 'John Doe'
+      end
+
+      it 'returns an empty string if the element exists but contains no text',
+         except: {browser: :safari, reason: 'Safari does not strip text'} do
+        expect(browser.dd(class: 'noop').text).to eq ''
+      end
+
+      it 'raises UnknownObjectException if the element does not exist' do
+        expect { browser.dd(id: 'no_such_id').text }.to raise_unknown_object_exception
+        expect { browser.dd(title: 'no_such_title').text }.to raise_unknown_object_exception
+        expect { browser.dd(index: 1337).text }.to raise_unknown_object_exception
+        expect { browser.dd(xpath: "//dd[@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.dd(index: 0)).to respond_to(:id)
+        expect(browser.dd(index: 0)).to respond_to(:class_name)
+        expect(browser.dd(index: 0)).to respond_to(:style)
+        expect(browser.dd(index: 0)).to respond_to(:text)
+        expect(browser.dd(index: 0)).to respond_to(:title)
+      end
+    end
+
+    # Manipulation methods
+    describe '#click' do
+      it 'fires events when clicked' do
+        expect(browser.dd(title: 'education').text).not_to eq 'changed'
+        browser.dd(title: 'education').click
+        expect(browser.dd(title: 'education').text).to eq 'changed'
+      end
+
+      it 'raises UnknownObjectException if the element does not exist' do
+        expect { browser.dd(id: 'no_such_id').click }.to raise_unknown_object_exception
+        expect { browser.dd(title: 'no_such_title').click }.to raise_unknown_object_exception
+        expect { browser.dd(index: 1337).click }.to raise_unknown_object_exception
+        expect { browser.dd(xpath: "//dd[@id='no_such_id']").click }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#html' do
+      it 'returns the HTML of the element' do
+        html = browser.dd(id: 'someone').html
+        expect(html).to match(/John Doe/m)
+        expect(html).not_to include('</body>')
+      end
+    end
+  end
+end

data/spec/watirspec/elements/dds_spec.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe 'Dds' do
+    before do
+      browser.goto(WatirSpec.url_for('definition_lists.html'))
+    end
+
+    describe 'with selectors' do
+      it 'returns the matching elements' do
+        expect(browser.dds(text: '11 years').to_a).to eq [browser.dd(text: '11 years')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of dds' do
+        expect(browser.dds.length).to eq 11
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the dd at the given index' do
+        expect(browser.dds[1].title).to eq 'education'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through dds correctly' do
+        count = 0
+
+        browser.dds.each_with_index do |d, index|
+          expect(d.id).to eq browser.dd(index: index).id
+          expect(d.class_name).to eq browser.dd(index: index).class_name
+
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/elements/del_spec.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe 'Del' do
+    before do
+      browser.goto(WatirSpec.url_for('non_control_elements.html'))
+    end
+
+    # Exists method
+    describe '#exist?' do
+      it "returns true if the 'del' exists" do
+        expect(browser.del(id: 'lead')).to exist
+        expect(browser.del(id: /lead/)).to exist
+        expect(browser.del(text: 'This is a deleted text tag 1')).to exist
+        expect(browser.del(text: /This is a deleted text tag 1/)).to exist
+        expect(browser.del(class: 'lead')).to exist
+        expect(browser.del(class: /lead/)).to exist
+        expect(browser.del(index: 0)).to exist
+        expect(browser.del(xpath: "//del[@id='lead']")).to exist
+      end
+
+      it 'returns the first del if given no args' do
+        expect(browser.del).to exist
+      end
+
+      it "returns false if the element doesn't exist" do
+        expect(browser.del(id: 'no_such_id')).not_to exist
+        expect(browser.del(id: /no_such_id/)).not_to exist
+        expect(browser.del(text: 'no_such_text')).not_to exist
+        expect(browser.del(text: /no_such_text/)).not_to exist
+        expect(browser.del(class: 'no_such_class')).not_to exist
+        expect(browser.del(class: /no_such_class/)).not_to exist
+        expect(browser.del(index: 1337)).not_to exist
+        expect(browser.del(xpath: "//del[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.del(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    # Attribute methods
+    describe '#id' do
+      it 'returns the id attribute' do
+        expect(browser.del(index: 0).id).to eq 'lead'
+      end
+
+      it "returns an empty string if the element exists and the attribute doesn't" do
+        expect(browser.del(index: 2).id).to eq ''
+      end
+
+      it "raises UnknownObjectException if the del doesn't exist" do
+        expect { browser.del(id: 'no_such_id').id }.to raise_unknown_object_exception
+        expect { browser.del(index: 1337).id }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#title' do
+      it 'returns the title attribute' do
+        expect(browser.del(index: 0).title).to eq 'Lorem ipsum'
+      end
+
+      it "returns an empty string if the element exists and the attribute doesn't" do
+        expect(browser.del(index: 2).title).to eq ''
+      end
+
+      it "raises UnknownObjectException if the del doesn't exist" do
+        expect { browser.del(id: 'no_such_id').title }.to raise_unknown_object_exception
+        expect { browser.del(xpath: "//del[@id='no_such_id']").title }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#text' do
+      it 'returns the text of the del' do
+        expect(browser.del(index: 1).text).to eq 'This is a deleted text tag 2'
+      end
+
+      it "returns an empty string if the element doesn't contain any text" do
+        expect(browser.del(index: 3).text).to eq ''
+      end
+
+      it "raises UnknownObjectException if the del doesn't exist" do
+        expect { browser.del(id: 'no_such_id').text }.to raise_unknown_object_exception
+        expect { browser.del(xpath: "//del[@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.del(index: 0)).to respond_to(:class_name)
+        expect(browser.del(index: 0)).to respond_to(:id)
+        expect(browser.del(index: 0)).to respond_to(:title)
+        expect(browser.del(index: 0)).to respond_to(:text)
+      end
+    end
+
+    # Other
+    describe '#click', except: {headless: true} do
+      it 'fires events' do
+        expect(browser.del(class: 'footer').text).not_to include('Javascript')
+        browser.del(class: 'footer').click
+        expect(browser.del(class: 'footer').text).to include('Javascript')
+      end
+
+      it "raises UnknownObjectException if the del doesn't exist" do
+        expect { browser.del(id: 'no_such_id').click }.to raise_unknown_object_exception
+        expect { browser.del(title: 'no_such_title').click }.to raise_unknown_object_exception
+      end
+    end
+  end
+end

data/spec/watirspec/elements/dels_spec.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe 'Dels' 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.dels(class: 'lead').to_a).to eq [browser.del(class: 'lead')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of dels' do
+        expect(browser.dels.length).to eq 5
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the del at the given index' do
+        expect(browser.dels[0].id).to eq 'lead'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through dels correctly' do
+        count = 0
+
+        browser.dels.each_with_index do |s, index|
+          expect(s.id).to eq browser.del(index: index).id
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/elements/div_spec.rb

@@ -0,0 +1,232 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe Div do
+    before do
+      browser.goto(WatirSpec.url_for('non_control_elements.html'))
+    end
+
+    describe '#exists?' do
+      it 'returns true if the element exists' do
+        expect(browser.div(id: 'header')).to exist
+        expect(browser.div(id: /header/)).to exist
+        expect(browser.div(title: 'Header and primary navigation')).to exist
+        expect(browser.div(title: /Header and primary navigation/)).to exist
+        expect(browser.div(text: 'Not shownNot hidden')).to exist
+        expect(browser.div(text: /Not hidden/)).to exist
+        expect(browser.div(class: 'profile')).to exist
+        expect(browser.div(class: /profile/)).to exist
+        expect(browser.div(index: 0)).to exist
+        expect(browser.div(xpath: "//div[@id='header']")).to exist
+        expect(browser.div(custom_attribute: 'custom')).to exist
+        expect(browser.div(custom_attribute: /custom/)).to exist
+        expect(browser.div(text: /some visible/)).to exist
+        expect(browser.div(text: /some (visible|Jeff)/)).to exist
+        expect(browser.div(text: /none visible/)).to exist
+      end
+
+      it 'returns the first div if given no args' do
+        expect(browser.div).to exist
+      end
+
+      it 'returns false if the element does not exist' do
+        expect(browser.div(id: 'no_such_id')).not_to exist
+        expect(browser.div(id: /no_such_id/)).not_to exist
+        expect(browser.div(title: 'no_such_title')).not_to exist
+        expect(browser.div(title: /no_such_title/)).not_to exist
+        expect(browser.div(text: 'no_such_text')).not_to exist
+        expect(browser.div(text: /no_such_text/)).not_to exist
+        expect(browser.div(class: 'no_such_class')).not_to exist
+        expect(browser.div(class: /no_such_class/)).not_to exist
+        expect(browser.div(text: /some visible some hidden/)).to exist
+        expect(browser.div(index: 1337)).not_to exist
+        expect(browser.div(xpath: "//div[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.div(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.div(index: 1).id).to eq 'outer_container'
+      end
+
+      it "returns an empty string if the element exists, but the attribute doesn't" do
+        expect(browser.div(index: 0).id).to eq ''
+      end
+
+      it 'raises UnknownObjectException if the element does not exist' do
+        expect { browser.div(id: 'no_such_id').id }.to raise_unknown_object_exception
+        expect { browser.div(title: 'no_such_id').id }.to raise_unknown_object_exception
+        expect { browser.div(index: 1337).id }.to raise_unknown_object_exception
+      end
+
+      it 'takes all conditions into account when locating by id' do
+        browser.goto WatirSpec.url_for 'multiple_ids.html'
+        expect(browser.div(id: 'multiple', class: 'bar').class_name).to eq 'bar'
+      end
+
+      it 'finds the id with the correct tag name' do
+        browser.goto WatirSpec.url_for 'multiple_ids.html'
+        expect(browser.span(id: 'multiple').class_name).to eq 'foobar'
+      end
+    end
+
+    describe '#style' do
+      it 'returns the style attribute if the element exists' do
+        expect(browser.div(id: 'best_language').style).to eq 'color: red; text-decoration: underline; cursor: pointer;'
+      end
+
+      it "returns an empty string if the element exists but the attribute doesn't" do
+        expect(browser.div(id: 'promo').style).to eq ''
+      end
+
+      it 'raises UnknownObjectException if the element does not exist' do
+        expect { browser.div(id: 'no_such_id').style }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#text' do
+      it 'returns the text of the div' do
+        expect(browser.div(id: 'footer').text.strip).to eq 'This is a footer.'
+        expect(browser.div(title: 'Closing remarks').text.strip).to eq 'This is a footer.'
+        expect(browser.div(xpath: "//div[@id='footer']").text.strip).to eq 'This is a footer.'
+      end
+
+      it 'returns an empty string if the element exists but contains no text' do
+        expect(browser.div(index: 0).text.strip).to eq ''
+      end
+
+      it 'returns an empty string if the div is hidden',
+         except: {browser: :safari, reason: 'Safari is not filtering out hidden text'} do
+        expect(browser.div(id: 'hidden').text).to eq ''
+      end
+
+      it 'raises UnknownObjectException if the element does not exist' do
+        expect { browser.div(id: 'no_such_id').text }.to raise_unknown_object_exception
+        expect { browser.div(title: 'no_such_title').text }.to raise_unknown_object_exception
+        expect { browser.div(index: 1337).text }.to raise_unknown_object_exception
+        expect { browser.div(xpath: "//div[@id='no_such_id']").text }.to raise_unknown_object_exception
+      end
+    end
+
+    describe 'custom methods' do
+      it 'returns the custom attribute if the element exists' do
+        expect(browser.div(custom_attribute: 'custom').attribute_value('custom-attribute')).to eq 'custom'
+      end
+    end
+
+    describe '#respond_to?' do
+      it 'returns true for all attribute methods' do
+        expect(browser.div(index: 0)).to respond_to(:class_name)
+        expect(browser.div(index: 0)).to respond_to(:id)
+        expect(browser.div(index: 0)).to respond_to(:style)
+        expect(browser.div(index: 0)).to respond_to(:text)
+      end
+    end
+
+    # Manipulation methods
+    describe '#click' do
+      it 'fires events when clicked' do
+        expect(browser.div(id: 'best_language').text).not_to eq 'Ruby!'
+
+        div = browser.div(id: 'best_language')
+        div.scroll.to
+        div.click
+        expect(browser.div(id: 'best_language').text).to eq 'Ruby!'
+      end
+
+      it 'raises UnknownObjectException if the element does not exist' do
+        expect { browser.div(id: 'no_such_id').click }.to raise_unknown_object_exception
+        expect { browser.div(title: 'no_such_title').click }.to raise_unknown_object_exception
+        expect { browser.div(index: 1337).click }.to raise_unknown_object_exception
+        expect { browser.div(xpath: "//div[@id='no_such_id']").click }.to raise_unknown_object_exception
+      end
+
+      it 'includes custom message if element with a custom attribute does not exist' do
+        message = /Watir treated \["custom_attribute"\] as a non-HTML compliant attribute, ensure that was intended/
+        expect { browser.div(custom_attribute: 'not_there').click }.to raise_unknown_object_exception(message)
+      end
+    end
+
+    describe '#click!' do
+      it 'fires events when clicked' do
+        expect(browser.div(id: 'best_language').text).not_to eq 'Ruby!'
+        browser.div(id: 'best_language').click!
+        expect(browser.div(id: 'best_language').text).to eq 'Ruby!'
+      end
+
+      it 'raises UnknownObjectException if the element does not exist' do
+        expect { browser.div(id: 'no_such_id').click! }.to raise_unknown_object_exception
+        expect { browser.div(title: 'no_such_title').click! }.to raise_unknown_object_exception
+        expect { browser.div(index: 1337).click! }.to raise_unknown_object_exception
+        expect { browser.div(xpath: "//div[@id='no_such_id']").click! }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#double_click',
+             except: {browser: :safari, reason: 'command correctly received, but action not taken'} do
+      it 'fires the ondblclick event' do
+        div = browser.div(id: 'html_test')
+        div.double_click
+        expect(messages).to include('double clicked')
+      end
+
+      it 'fires the ondblclick event with specified scroll position' do
+        div = browser.div(id: 'html_test')
+        div.double_click(scroll_to: :center)
+        expect(messages).to include('double clicked')
+      end
+    end
+
+    describe '#double_click!' do
+      it 'fires the ondblclick event' do
+        browser.div(id: 'html_test').double_click!
+        expect(messages).to include('double clicked')
+      end
+    end
+
+    describe '#right_click' do
+      it 'fires the oncontextmenu event' do
+        browser.goto(WatirSpec.url_for('right_click.html'))
+        browser.div(id: 'click').right_click
+        expect(messages.first).to eq 'right-clicked'
+      end
+
+      it 'accepts modifiers', except: {browser: :ie} do
+        browser.goto(WatirSpec.url_for('right_click.html'))
+        browser.div(id: 'click-logger').right_click(:control, :alt)
+        expect(event_log.first).to eq('control=true alt=true')
+      end
+
+      it 'accepts modifiers with scroll position', except: {browser: :ie} do
+        browser.goto(WatirSpec.url_for('right_click.html'))
+        browser.div(id: 'click-logger').right_click(:control, :alt, scroll_to: :center)
+        expect(event_log.first).to eq('control=true alt=true')
+      end
+
+      it 'scrolls' do
+        expect {
+          browser.del(class: 'footer').double_click
+        }.not_to raise_exception
+      end
+    end
+
+    describe '#html' do
+      it 'returns the HTML of the element' do
+        html = browser.div(id: 'footer').html.downcase
+        expect(html).to include('id="footer"')
+        expect(html).to include('title="closing remarks"')
+        expect(html).to include('class="profile"')
+
+        expect(html).not_to include('<div id="content">')
+        expect(html).not_to include('</body>')
+      end
+    end
+  end
+end

data/spec/watirspec/elements/divs_spec.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe DivCollection 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.divs(id: 'header').to_a).to eq [browser.div(id: 'header')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of divs' do
+        expect(browser.divs.length).to eq 20
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the div at the given index' do
+        expect(browser.divs[1].id).to eq 'outer_container'
+      end
+
+      it 'returns an array of divs with a given range of positive values' do
+        divs = browser.divs[2..4]
+        ids = divs.map(&:id)
+        expect(ids).to eq %w[header promo content]
+      end
+
+      it 'returns an array of divs with a given range including negative values' do
+        divs = browser.divs[11..-7]
+        ids = divs.map(&:id)
+        expect(ids).to eq %w[messages ins_tag_test del_tag_test]
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through divs correctly' do
+        count = 0
+
+        browser.divs.each_with_index do |d, index|
+          expect(d.id).to eq browser.div(index: index).id
+          expect(d.class_name).to eq browser.div(index: index).class_name
+
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end