watir 1.4.1 → 7.3.0

data/spec/watirspec/elements/link_spec.rb

@@ -0,0 +1,180 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe Anchor do
+    before do
+      browser.goto(WatirSpec.url_for('non_control_elements.html'))
+    end
+
+    # Exists method
+    describe '#exist?' do
+      it 'returns true if the link exists' do
+        expect(browser.link(id: 'link_2')).to exist
+        expect(browser.link(id: /link_2/)).to exist
+        expect(browser.link(title: 'link_title_2')).to exist
+        expect(browser.link(title: /link_title_2/)).to exist
+        expect(browser.link(text: 'Link 2')).to exist
+        expect(browser.link(text: /Link 2/i)).to exist
+        expect(browser.link(href: 'non_control_elements.html')).to exist
+        expect(browser.link(href: /non_control_elements.html/)).to exist
+        expect(browser.link(index: 1)).to exist
+        expect(browser.link(xpath: "//a[@id='link_2']")).to exist
+      end
+
+      it 'returns the first link if given no args' do
+        expect(browser.link).to exist
+      end
+
+      it 'strips spaces from href attribute when locating elements' do
+        expect(browser.link(href: /strip_space$/)).to exist
+      end
+
+      it "returns false if the link doesn't exist" do
+        expect(browser.link(id: 'no_such_id')).not_to exist
+        expect(browser.link(id: /no_such_id/)).not_to exist
+        expect(browser.link(title: 'no_such_title')).not_to exist
+        expect(browser.link(title: /no_such_title/)).not_to exist
+        expect(browser.link(text: 'no_such_text')).not_to exist
+        expect(browser.link(text: /no_such_text/i)).not_to exist
+        expect(browser.link(href: 'no_such_href')).not_to exist
+        expect(browser.link(href: /no_such_href/)).not_to exist
+        expect(browser.link(index: 1337)).not_to exist
+        expect(browser.link(xpath: "//a[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.link(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    # Attribute methods
+    describe '#href' do
+      it 'returns the href attribute if the link exists' do
+        expect(browser.link(index: 1).href).to match(/non_control_elements/)
+      end
+
+      it "returns an empty string if the link exists and the attribute doesn't" do
+        expect(browser.link(index: 0).href).to eq ''
+      end
+
+      it "raises an UnknownObjectException if the link doesn't exist" do
+        expect { browser.link(index: 1337).href }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#id' do
+      it 'returns the id attribute if the link exists' do
+        expect(browser.link(index: 1).id).to eq 'link_2'
+      end
+
+      it "returns an empty string if the link exists and the attribute doesn't" do
+        expect(browser.link(index: 0).id).to eq ''
+      end
+
+      it "raises an UnknownObjectException if the link doesn't exist" do
+        expect { browser.link(index: 1337).id }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#text' do
+      it 'returns the link text' do
+        expect(browser.link(index: 1).text).to eq 'Link 2'
+      end
+
+      it 'returns an empty string if the link exists and contains no text' do
+        expect(browser.link(index: 0).text).to eq ''
+      end
+
+      it "raises an UnknownObjectException if the link doesn't exist" do
+        expect { browser.link(index: 1337).text }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#title' do
+      it 'returns the type attribute if the link exists' do
+        expect(browser.link(index: 1).title).to eq 'link_title_2'
+      end
+
+      it "returns an empty string if the link exists and the attribute doesn't" do
+        expect(browser.link(index: 0).title).to eq ''
+      end
+
+      it "raises an UnknownObjectException if the link doesn't exist" do
+        expect { browser.link(index: 1337).title }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#respond_to?' do
+      it 'returns true for all attribute methods' do
+        expect(browser.link(index: 0)).to respond_to(:class_name)
+        expect(browser.link(index: 0)).to respond_to(:href)
+        expect(browser.link(index: 0)).to respond_to(:id)
+        expect(browser.link(index: 0)).to respond_to(:style)
+        expect(browser.link(index: 0)).to respond_to(:text)
+        expect(browser.link(index: 0)).to respond_to(:title)
+      end
+    end
+
+    # Manipulation methods
+    # Note: the #wait_until calls are hacks for Safari specifically
+    describe '#click' do
+      it 'finds an existing link by (text: String) and clicks it' do
+        element = browser.link(text: 'Link 3')
+        element.wait_until { |link| !link.exist? || link.click }
+        expect(browser.h1(text: 'User administration')).to exist
+      end
+
+      it 'finds an existing link by (text: Regexp) and clicks it' do
+        element = browser.link(href: /forms_with_input_elements/)
+        element.wait_until { |link| !link.exist? || link.click }
+        expect(browser.h1(text: 'User administration')).to exist
+      end
+
+      it 'finds an existing link by (index: Integer) and clicks it' do
+        element = browser.link(index: 2)
+        element.wait_until { |link| !link.exist? || link.click }
+        expect(browser.h1(text: 'User administration')).to exist
+      end
+
+      it "raises an UnknownObjectException if the link doesn't exist" do
+        expect { browser.link(index: 1337).click }.to raise_unknown_object_exception
+      end
+
+      it 'clicks a link with no text content but an img child' do
+        browser.goto WatirSpec.url_for('images.html')
+        browser.link(href: /definition_lists.html/).click
+        browser.wait_while(title: /^(Images|)$/)
+        expect(browser.title).to eq 'definition_lists'
+      end
+    end
+
+    describe 'visible text' do
+      it 'finds links by visible text' do
+        browser.goto WatirSpec.url_for('non_control_elements.html')
+
+        expect(browser.link(visible_text: 'all visible')).to exist
+        expect(browser.link(visible_text: /all visible/)).to exist
+        expect(browser.link(visible_text: /some visible/)).to exist
+
+        expect(browser.link(visible_text: 'Link 2', class: 'external')).to exist
+        expect(browser.link(visible_text: /Link 2/, class: 'external')).to exist
+      end
+
+      it 'finds links in spite of hidden text' do
+        browser.goto WatirSpec.url_for('non_control_elements.html')
+
+        expect(browser.link(visible_text: 'some visible')).to exist
+        expect(browser.link(visible_text: 'none visible')).not_to exist
+        expect(browser.link(visible_text: /none visible/)).not_to exist
+      end
+
+      it 'raises exception unless value is a String or a RegExp' do
+        browser.goto WatirSpec.url_for('non_control_elements.html')
+        msg = /expected one of \[String, Regexp\], got 7:Integer/
+        expect { browser.link(visible_text: 7).exists? }.to raise_exception(TypeError, msg)
+      end
+    end
+  end
+end

data/spec/watirspec/elements/links_spec.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe AnchorCollection 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.links(title: 'link_title_2').to_a).to eq [browser.link(title: 'link_title_2')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of links' do
+        expect(browser.links.length).to eq 7
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the link at the given index' do
+        expect(browser.links[2].id).to eq 'link_3'
+      end
+
+      it 'returns a Link object also when the index is out of bounds' do
+        expect(browser.links[2000]).not_to be_nil
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through links correctly' do
+        count = 0
+
+        browser.links.each_with_index do |c, index|
+          expect(c.id).to eq browser.link(index: index).id
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+
+    describe 'visible text' do
+      it 'finds links by visible text' do
+        browser.goto WatirSpec.url_for('non_control_elements.html')
+        container = browser.div(id: 'visible_link')
+        expect(container.links(visible_text: 'all visible').count).to eq(1)
+        expect(container.links(visible_text: /all visible/).count).to eq(1)
+        expect(container.links(visible_text: /some visible/).count).to eq(1)
+      end
+
+      it 'finds links 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.divs(visible_text: 'some visible').count).to eq(1)
+        expect(container.divs(visible_text: 'none visible').count).to eq(0)
+        expect(container.divs(visible_text: /none visible/).count).to eq(0)
+      end
+    end
+  end
+end

data/spec/watirspec/elements/lis_spec.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe LICollection 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.lis(class: 'nonlink').to_a).to eq [browser.li(class: 'nonlink')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of lis' do
+        expect(browser.lis.length).to eq 18
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the li at the given index' do
+        expect(browser.lis[4].id).to eq 'non_link_1'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through lis correctly' do
+        count = 0
+
+        browser.lis.each_with_index do |l, index|
+          expect(l.id).to eq browser.li(index: index).id
+          expect(l.value).to eq browser.li(index: index).value
+
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/elements/list_spec.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe List do
+    before do
+      browser.goto(WatirSpec.url_for('non_control_elements.html'))
+    end
+
+    it 'returns the list items assocaited with an Ol' do
+      items = browser.ol(id: 'favorite_compounds').list_items
+      expect(items).to be_a Watir::LICollection
+      expect(items).to all(be_a Watir::LI)
+    end
+
+    it 'returns the list items assocaited with an Ul' do
+      items = browser.ul(id: 'navbar').list_items
+      expect(items).to be_a Watir::LICollection
+      expect(items).to all(be_a Watir::LI)
+    end
+
+    it 'gets the size of a list' do
+      ul = browser.ul(id: 'navbar')
+      expect(ul.size).to eq 7
+    end
+
+    it 'iterates over a list' do
+      ul = browser.ul(id: 'navbar')
+      expect(ul.map(&:tag_name)).to eq Array.new(7, 'li')
+    end
+
+    it 'gets a list item at the specified index' do
+      ul = browser.ul(id: 'navbar')
+      expect(ul[4].text).to eq 'Non-link 1'
+    end
+
+    it 'returns the list item size' do
+      items = browser.ol(id: 'favorite_compounds').list_items
+      expect(items.size).to eq 5
+    end
+
+    it 'returns list item at an index' do
+      items = browser.ol(id: 'favorite_compounds').list_items
+      third = browser.ol(id: 'favorite_compounds').li(index: 2)
+
+      expect(items[2]).to eq third
+    end
+  end
+end

data/spec/watirspec/elements/map_spec.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe Map do
+    before do
+      browser.goto(WatirSpec.url_for('images.html'))
+    end
+
+    # Exists method
+    describe '#exist?' do
+      it "returns true if the 'map' exists" do
+        expect(browser.map(id: 'triangle_map')).to exist
+        expect(browser.map(id: /triangle_map/)).to exist
+        expect(browser.map(name: 'triangle_map')).to exist
+        expect(browser.map(name: /triangle_map/)).to exist
+        expect(browser.map(index: 0)).to exist
+        expect(browser.map(xpath: "//map[@id='triangle_map']")).to exist
+      end
+
+      it 'returns the first map if given no args' do
+        expect(browser.map).to exist
+      end
+
+      it "returns false if the 'map' doesn't exist" do
+        expect(browser.map(id: 'no_such_id')).not_to exist
+        expect(browser.map(id: /no_such_id/)).not_to exist
+        expect(browser.map(name: 'no_such_id')).not_to exist
+        expect(browser.map(name: /no_such_id/)).not_to exist
+        expect(browser.map(index: 1337)).not_to exist
+        expect(browser.map(xpath: "//map[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.map(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    # Attribute methods
+    describe '#id' do
+      it 'returns the id attribute' do
+        expect(browser.map(index: 0).id).to eq 'triangle_map'
+      end
+
+      it "returns an empty string if the element exists and the attribute doesn't" do
+        expect(browser.map(index: 1).id).to eq ''
+      end
+
+      it "raises UnknownObjectException if the p doesn't exist" do
+        expect { browser.map(id: 'no_such_id').id }.to raise_unknown_object_exception
+        expect { browser.map(index: 1337).id }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#name' do
+      it 'returns the name attribute' do
+        expect(browser.map(index: 0).name).to eq 'triangle_map'
+      end
+
+      it "returns an empty string if the element exists and the attribute doesn't" do
+        expect(browser.map(index: 1).name).to eq ''
+      end
+
+      it "raises UnknownObjectException if the map doesn't exist" do
+        expect { browser.map(id: 'no_such_id').name }.to raise_unknown_object_exception
+        expect { browser.map(index: 1337).name }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#respond_to?' do
+      it 'returns true for all attribute methods' do
+        expect(browser.map(index: 0)).to respond_to(:id)
+        expect(browser.map(index: 0)).to respond_to(:name)
+      end
+    end
+  end
+end

data/spec/watirspec/elements/maps_spec.rb

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

data/spec/watirspec/elements/meta_spec.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe Meta do
+    before do
+      browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+    end
+
+    describe '#exist?' do
+      it 'returns true if the meta tag exists' do
+        expect(browser.meta(http_equiv: 'Content-Type')).to exist
+      end
+
+      it 'returns the first meta if given no args' do
+        expect(browser.meta).to exist
+      end
+    end
+
+    describe 'content' do
+      it 'returns the content attribute of the tag' do
+        expect(browser.meta(http_equiv: 'Content-Type').content).to eq 'text/html; charset=utf-8'
+      end
+    end
+  end
+end

data/spec/watirspec/elements/metas_spec.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe MetaCollection 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.metas(name: 'description').to_a).to eq [browser.meta(name: 'description')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of meta elements' do
+        expect(browser.metas.length).to eq 2
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the meta element at the given index' do
+        expect(browser.metas[1].name).to eq 'description'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through meta elements correctly' do
+        count = 0
+
+        browser.metas.each_with_index do |m, index|
+          expect(m.content).to eq browser.meta(index: index).content
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/elements/ol_spec.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe OList do
+    before do
+      browser.goto(WatirSpec.url_for('non_control_elements.html'))
+    end
+
+    # Exists method
+    describe '#exist?' do
+      it "returns true if the 'ol' exists" do
+        expect(browser.ol(id: 'favorite_compounds')).to exist
+        expect(browser.ol(id: /favorite_compounds/)).to exist
+        expect(browser.ol(index: 0)).to exist
+        expect(browser.ol(xpath: "//ol[@id='favorite_compounds']")).to exist
+      end
+
+      it 'returns the first ol if given no args' do
+        expect(browser.ol).to exist
+      end
+
+      it "returns false if the 'ol' doesn't exist" do
+        expect(browser.ol(id: 'no_such_id')).not_to exist
+        expect(browser.ol(id: /no_such_id/)).not_to exist
+        expect(browser.ol(text: 'no_such_text')).not_to exist
+        expect(browser.ol(text: /no_such_text/)).not_to exist
+        expect(browser.ol(class: 'no_such_class')).not_to exist
+        expect(browser.ol(class: /no_such_class/)).not_to exist
+        expect(browser.ol(index: 1337)).not_to exist
+        expect(browser.ol(xpath: "//ol[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.ol(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    # Attribute methods
+    describe '#id' do
+      it 'returns the id attribute' do
+        expect(browser.ol(class: 'chemistry').id).to eq 'favorite_compounds'
+      end
+
+      it "returns an empty string if the element exists and the attribute doesn't" do
+        expect(browser.ol(index: 1).id).to eq ''
+      end
+
+      it "raises UnknownObjectException if the ol doesn't exist" do
+        expect { browser.ol(id: 'no_such_id').id }.to raise_unknown_object_exception
+        expect { browser.ol(index: 1337).id }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#respond_to?' do
+      it 'returns true for all attribute methods' do
+        expect(browser.ol(index: 0)).to respond_to(:class_name)
+        expect(browser.ol(index: 0)).to respond_to(:id)
+      end
+    end
+  end
+end

data/spec/watirspec/elements/ols_spec.rb

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