watir 6.0.0.beta5 → 6.0.0

data/spec/watirspec/elements/links_spec.rb

@@ -0,0 +1,44 @@
+require "watirspec_helper"
+
+describe "Links" do
+
+  before :each 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 4
+    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]).to_not 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
+
+end

data/spec/watirspec/elements/lis_spec.rb

@@ -0,0 +1,42 @@
+require "watirspec_helper"
+
+describe "Lis" do
+
+  before :each 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

data/spec/watirspec/elements/map_spec.rb

@@ -0,0 +1,79 @@
+require "watirspec_helper"
+
+describe "Map" do
+
+  before :each 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")).to_not exist
+      expect(browser.map(id: /no_such_id/)).to_not exist
+      expect(browser.map(name: "no_such_id")).to_not exist
+      expect(browser.map(name: /no_such_id/)).to_not exist
+      expect(browser.map(index: 1337)).to_not exist
+      expect(browser.map(xpath: "//map[@id='no_such_id']")).to_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.map(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.map(no_such_how: 'some_value').exists? }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+    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

data/spec/watirspec/elements/maps_spec.rb

@@ -0,0 +1,41 @@
+require "watirspec_helper"
+
+describe "Maps" do
+
+  before :each 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

data/spec/watirspec/elements/meta_spec.rb

@@ -0,0 +1,23 @@
+require "watirspec_helper"
+
+describe "Meta" do
+  before :each 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

data/spec/watirspec/elements/metas_spec.rb

@@ -0,0 +1,40 @@
+require "watirspec_helper"
+
+describe "Metas" do
+
+  before :each 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

data/spec/watirspec/elements/ol_spec.rb

@@ -0,0 +1,89 @@
+require "watirspec_helper"
+
+describe "Ol" do
+
+  before :each 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")).to_not exist
+        expect(browser.ol(id: /no_such_id/)).to_not exist
+        expect(browser.ol(text: "no_such_text")).to_not exist
+        expect(browser.ol(text: /no_such_text/)).to_not exist
+        expect(browser.ol(class: "no_such_class")).to_not exist
+        expect(browser.ol(class: /no_such_class/)).to_not exist
+        expect(browser.ol(index: 1337)).to_not exist
+        expect(browser.ol(xpath: "//ol[@id='no_such_id']")).to_not exist
+      end
+
+    it "returns false if the 'ol' doesn't exist" do
+      expect(browser.ol(id: "no_such_id")).to_not exist
+      expect(browser.ol(id: /no_such_id/)).to_not exist
+      expect(browser.ol(text: "no_such_text")).to_not exist
+      expect(browser.ol(text: /no_such_text/)).to_not exist
+      expect(browser.ol(class: "no_such_class")).to_not exist
+      expect(browser.ol(class: /no_such_class/)).to_not exist
+      expect(browser.ol(index: 1337)).to_not exist
+      expect(browser.ol(xpath: "//ol[@id='no_such_id']")).to_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.ol(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.ol(no_such_how: 'some_value').exists? }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+    end
+  end
+
+  # Attribute methods
+  describe "#class_name" do
+    it "returns the class attribute" do
+      expect(browser.ol(id: 'favorite_compounds').class_name).to eq 'chemistry'
+    end
+
+    it "returns an empty string if the element exists and the attribute doesn't" do
+      expect(browser.ol(index: 1).class_name).to eq ''
+    end
+
+    it "raises UnknownObjectException if the ol doesn't exist" do
+      expect { browser.ol(id: 'no_such_id').class_name }.to raise_unknown_object_exception
+    end
+  end
+
+  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

data/spec/watirspec/elements/ols_spec.rb

@@ -0,0 +1,40 @@
+require "watirspec_helper"
+
+describe "Ols" do
+
+  before :each 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

data/spec/watirspec/elements/option_spec.rb

@@ -0,0 +1,152 @@
+require "watirspec_helper"
+
+describe "Option" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("forms_with_input_elements.html"))
+  end
+
+  describe "#exists?" do
+    it "returns true if the element exists (page context)" do
+      expect(browser.option(id: "nor")).to exist
+      expect(browser.option(id: /nor/)).to exist
+      expect(browser.option(value: "2")).to exist
+      expect(browser.option(value: /2/)).to exist
+      expect(browser.option(text: "Norway")).to exist
+      expect(browser.option(text: /Norway/)).to exist
+      expect(browser.option(class: "scandinavia")).to exist
+      expect(browser.option(index: 1)).to exist
+      expect(browser.option(xpath: "//option[@id='nor']")).to exist
+    end
+
+    it "returns the first option if given no args" do
+      expect(browser.option).to exist
+    end
+
+    it "returns true if the element exists (select_list context)" do
+      expect(browser.select_list(name: "new_user_country").option(id: "nor")).to exist
+      expect(browser.select_list(name: "new_user_country").option(id: /nor/)).to exist
+      expect(browser.select_list(name: "new_user_country").option(value: "2")).to exist
+      expect(browser.select_list(name: "new_user_country").option(value: /2/)).to exist
+      expect(browser.select_list(name: "new_user_country").option(text: "Norway")).to exist
+      expect(browser.select_list(name: "new_user_country").option(text: /Norway/)).to exist
+      expect(browser.select_list(name: "new_user_country").option(class: "scandinavia")).to exist
+      expect(browser.select_list(name: "new_user_country").option(index: 1)).to exist
+      expect(browser.select_list(name: "new_user_country").option(xpath: "//option[@id='nor']")).to exist
+      expect(browser.select_list(name: "new_user_country").option(label: "Germany")).to exist
+    end
+
+    it "returns false if the element does not exist (page context)" do
+      expect(browser.option(id: "no_such_id")).to_not exist
+      expect(browser.option(id: /no_such_id/)).to_not exist
+      expect(browser.option(value: "no_such_value")).to_not exist
+      expect(browser.option(value: /no_such_value/)).to_not exist
+      expect(browser.option(text: "no_such_text")).to_not exist
+      expect(browser.option(text: /no_such_text/)).to_not exist
+      expect(browser.option(class: "no_such_class")).to_not exist
+      expect(browser.option(index: 1337)).to_not exist
+      expect(browser.option(xpath: "//option[@id='no_such_id']")).to_not exist
+    end
+
+    it "returns false if the element does not exist (select_list context)" do
+      expect(browser.select_list(name: "new_user_country").option(id: "no_such_id")).to_not exist
+      expect(browser.select_list(name: "new_user_country").option(id: /no_such_id/)).to_not exist
+      expect(browser.select_list(name: "new_user_country").option(value: "no_such_value")).to_not exist
+      expect(browser.select_list(name: "new_user_country").option(value: /no_such_value/)).to_not exist
+      expect(browser.select_list(name: "new_user_country").option(text: "no_such_text")).to_not exist
+      expect(browser.select_list(name: "new_user_country").option(text: /no_such_text/)).to_not exist
+      expect(browser.select_list(name: "new_user_country").option(class: "no_such_class")).to_not exist
+      expect(browser.select_list(name: "new_user_country").option(index: 1337)).to_not exist
+      expect(browser.select_list(name: "new_user_country").option(xpath: "//option[@id='no_such_id']")).to_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.option(id: 3.14).exists? }.to raise_error(TypeError)
+      expect { browser.select_list(name: "new_user_country").option(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.option(no_such_how: 'some_value').exists? }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+      expect { browser.select_list(name: "new_user_country").option(no_such_how: 'some_value').exists? }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+    end
+  end
+
+  bug "https://bugzilla.mozilla.org/show_bug.cgi?id=1255957", :firefox do
+    describe "#select" do
+      it "selects the chosen option (page context)" do
+        browser.option(text: "Denmark").select
+        expect(browser.select_list(name: "new_user_country").selected_options.map(&:text)).to eq ["Denmark"]
+      end
+
+      it "selects the chosen option (select_list context)" do
+        browser.select_list(name: "new_user_country").option(text: "Denmark").select
+        expect(browser.select_list(name: "new_user_country").selected_options.map(&:text)).to eq ["Denmark"]
+      end
+
+      it "selects the option when found by text (page context)" do
+        browser.option(text: 'Sweden').select
+        expect(browser.option(text: 'Sweden')).to be_selected
+      end
+
+      it "selects the option when found by text (select_list context)" do
+        browser.select_list(name: 'new_user_country').option(text: 'Sweden').select
+        expect(browser.select_list(name: 'new_user_country').option(text: 'Sweden')).to be_selected
+      end
+
+      # there's no onclick event for Option in IE / WebKit
+      # http://msdn.microsoft.com/en-us/library/ms535877(VS.85).aspx
+      compliant_on :ff_legacy do
+        it "fires the onclick event (page context)" do
+          browser.option(text: "Username 3").select
+          expect(browser.textarea(id: 'delete_user_comment').value).to eq 'Don\'t do it!'
+        end
+      end
+    end
+
+    # there's no onclick event for Option in IE / WebKit
+    # http://msdn.microsoft.com/en-us/library/ms535877(VS.85).aspx
+    compliant_on :ff_legacy do
+      it "fires onclick event (select_list context)" do
+        browser.select_list(id: 'delete_user_username').option(text: "Username 3").select
+        expect(browser.textarea(id: 'delete_user_comment').value).to eq 'Don\'t do it!'
+      end
+    end
+
+    it "raises UnknownObjectException if the option does not exist (page context)" do
+      expect { browser.option(text: "no_such_text").select }.to raise_unknown_object_exception
+      expect { browser.option(text: /missing/).select }.to raise_unknown_object_exception
+    end
+
+    it "raises UnknownObjectException if the option does not exist (select_list context)" do
+      expect { browser.select_list(name: "new_user_country").option(text: "no_such_text").select }.to raise_unknown_object_exception
+      expect { browser.select_list(name: "new_user_country").option(text: /missing/).select }.to raise_unknown_object_exception
+    end
+
+    it "raises MissingWayOfFindingObjectException when given a bad 'how' (page context)" do
+      expect { browser.option(missing: "Denmark").select }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+    end
+
+    it "raises MissingWayOfFindingObjectException when given a bad 'how' (select_list context)" do
+      expect { browser.select_list(name: "new_user_country").option(missing: "Denmark").select }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+    end
+  end
+
+  describe "#class_name" do
+    it "is able to get attributes (page context)" do
+      expect(browser.option(text: 'Sweden').class_name).to eq "scandinavia"
+    end
+
+    it "is able to get attributes (select_list context)" do
+      expect(browser.select_list(name: "new_user_country").option(text: 'Sweden').class_name).to eq "scandinavia"
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      expect(browser.select_list(name: "new_user_country").option(text: 'Sweden')).to respond_to(:class_name)
+      expect(browser.select_list(name: "new_user_country").option(text: 'Sweden')).to respond_to(:id)
+      expect(browser.select_list(name: "new_user_country").option(text: 'Sweden')).to respond_to(:text)
+    end
+  end
+
+end