watir 6.0.0.beta5 → 6.0.0

data/spec/watirspec/elements/hns_spec.rb

@@ -0,0 +1,38 @@
+require "watirspec_helper"
+
+describe ["H1s", "H2s", "H3s", "H4s", "H5s", "H6s"] 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.h1s(class: "primary").to_a).to eq [browser.h1(class: "primary")]
+    end
+  end
+
+  describe "#length" do
+    it "returns the number of h1s" do
+      expect(browser.h2s.length).to eq 9
+    end
+  end
+
+  describe "#[]" do
+    it "returns the h1 at the given index" do
+      expect(browser.h1s[0].id).to eq "first_header"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through header collections correctly" do
+      lengths = (1..6).collect do |i|
+        collection = browser.send(:"h#{i}s")
+        collection.each_with_index do |h, index|
+          expect(h.id).to eq browser.send(:"h#{i}", :index, index).id
+        end
+        collection.length
+      end
+      expect(lengths).to eq [2, 9, 2, 1, 1, 2]
+    end
+  end
+end

data/spec/watirspec/elements/iframe_spec.rb

@@ -0,0 +1,174 @@
+require "watirspec_helper"
+
+#
+# TODO: fix duplication with frame_spec
+#
+
+describe "IFrame" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("iframes.html"))
+  end
+
+  bug "https://bugzilla.mozilla.org/show_bug.cgi?id=1255906", :firefox do
+    it "handles crossframe javascript" do
+      browser.goto WatirSpec.url_for("iframes.html")
+
+      expect(browser.iframe(id: "iframe_1").text_field(name: 'senderElement').value).to eq 'send_this_value'
+      expect(browser.iframe(id: "iframe_2").text_field(name: 'recieverElement').value).to eq 'old_value'
+      browser.iframe(id: "iframe_1").button(id: 'send').click
+      expect(browser.iframe(id: "iframe_2").text_field(name: 'recieverElement').value).to eq 'send_this_value'
+    end
+  end
+
+  describe "#exist?" do
+    it "returns true if the iframe exists" do
+      expect(browser.iframe(id: "iframe_1")).to exist
+      expect(browser.iframe(name: "iframe1")).to exist
+      expect(browser.iframe(index: 0)).to exist
+      expect(browser.iframe(class: "half")).to exist
+      expect(browser.iframe(xpath: "//iframe[@id='iframe_1']")).to exist
+      expect(browser.iframe(src: "iframe_1.html")).to exist
+      expect(browser.iframe(id: /iframe/)).to exist
+      expect(browser.iframe(name: /iframe/)).to exist
+      expect(browser.iframe(src: /iframe_1/)).to exist
+      expect(browser.iframe(class: /half/)).to exist
+    end
+
+    it "returns the first iframe if given no args" do
+      expect(browser.iframe).to exist
+    end
+
+    it "returns false if the iframe doesn't exist" do
+      expect(browser.iframe(id: "no_such_id")).to_not exist
+      expect(browser.iframe(name: "no_such_text")).to_not exist
+      expect(browser.iframe(index: 1337)).to_not exist
+      expect(browser.iframe(src: "no_such_src")).to_not exist
+      expect(browser.iframe(class: "no_such_class")).to_not exist
+      expect(browser.iframe(id: /no_such_id/)).to_not exist
+      expect(browser.iframe(name: /no_such_text/)).to_not exist
+      expect(browser.iframe(src: /no_such_src/)).to_not exist
+      expect(browser.iframe(class: /no_such_class/)).to_not exist
+      expect(browser.iframe(xpath: "//iframe[@id='no_such_id']")).to_not exist
+    end
+
+    it "returns false if an element in an iframe does exist" do
+      expect(browser.iframe.element(css: "#senderElement")).to exist
+      expect(browser.iframe.element(id: "senderElement")).to exist
+    end
+
+    it "returns true if an element in an iframe does not exist" do
+      expect(browser.iframe.element(css: "#no_such_id")).to_not exist
+      expect(browser.iframe.element(id: "no_such_id")).to_not exist
+    end
+
+    it "returns true if an element outside an iframe exists after checking for one inside that does exist" do
+      existing_element = browser.element(css: "#iframe_1")
+      expect(existing_element).to exist
+      expect(browser.iframe.element(css: "#senderElement")).to exist
+      expect(existing_element).to exist
+    end
+
+    it "returns true if an element outside an iframe exists after checking for one inside that does not exist" do
+      existing_element = browser.element(css: "#iframe_1")
+      expect(existing_element).to exist
+      expect(browser.iframe.element(css: "#no_such_id")).to_not exist
+      expect(existing_element).to exist
+    end
+
+    it "returns true if an element exists in a frame generated in a collection" do
+      nested_element = browser.body.iframes.first.div
+      expect(nested_element).to exist
+    end
+
+
+    bug "https://github.com/detro/ghostdriver/issues/159", :phantomjs do
+      bug "https://bugzilla.mozilla.org/show_bug.cgi?id=1255946", :firefox do
+        it "handles nested iframes" do
+          browser.goto(WatirSpec.url_for("nested_iframes.html"))
+
+          browser.iframe(id: "two").iframe(id: "three").link(id: "four").click
+
+          Watir::Wait.until { browser.title == "definition_lists" }
+        end
+      end
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.iframe(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.iframe(no_such_how: 'some_value').exists? }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+    end
+  end
+
+  it 'handles all locators for element which do not exist' do
+    expect(browser.iframe(index: 0).div(id: 'invalid')).to_not exist
+  end
+
+  it 'switches between iframe and parent when needed' do
+    browser.iframe(id: "iframe_1").elements.each do |element|
+      element.text
+      browser.h1.text
+    end
+  end
+
+  it 'switches back to top level browsing context' do
+    # Point driver to browsing context of first iframe
+    browser.iframes.first.ps.to_a
+
+    expect(browser.h1s.first.text).to be == 'Iframes'
+  end
+
+  it "raises UnknownFrameException when accessing elements inside non-existing iframe" do
+    expect { browser.iframe(name: "no_such_name").p(index: 0).id }.to raise_unknown_frame_exception
+  end
+
+  it "raises UnknownFrameException when accessing a non-existing iframe" do
+    expect { browser.iframe(name: "no_such_name").id }.to raise_unknown_frame_exception
+  end
+
+  it "raises UnknownFrameException when accessing a non-existing subframe" do
+    expect { browser.iframe(name: "iframe1").iframe(name: "no_such_name").id }.to raise_unknown_frame_exception
+  end
+
+  it "raises UnknownObjectException when accessing a non-existing element inside an existing iframe" do
+    expect { browser.iframe(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.iframe(index: 0).foo }.to raise_error(NoMethodError)
+  end
+
+  bug "https://bugzilla.mozilla.org/show_bug.cgi?id=1255906", :firefox do
+    it "is able to set a field" do
+      browser.iframe(index: 0).text_field(name: 'senderElement').set("new value")
+      expect(browser.iframe(index: 0).text_field(name: 'senderElement').value).to eq "new value"
+    end
+  end
+
+  describe "#execute_script" do
+    it "executes the given javascript in the specified frame" do
+      frame = browser.iframe(index: 0)
+      expect(frame.div(id: 'set_by_js').text).to eq ""
+      frame.execute_script(%Q{document.getElementById('set_by_js').innerHTML = 'Art consists of limitation. The most beautiful part of every picture is the frame.'})
+      expect(frame.div(id: 'set_by_js').text).to eq "Art consists of limitation. The most beautiful part of every picture is the frame."
+    end
+  end
+
+  describe "#html" do
+    it "returns the full HTML source of the iframe" do
+      browser.goto WatirSpec.url_for("iframes.html")
+      expect(browser.iframe.html.downcase).to include("<title>iframe 1</title>")
+    end
+  end
+
+  describe "#text" do
+    it "returns the text inside the iframe" do
+      browser.goto WatirSpec.url_for("iframes.html")
+      expect(browser.iframe.text).to include("Frame 1")
+    end
+  end
+
+end

data/spec/watirspec/elements/iframes_spec.rb

@@ -0,0 +1,47 @@
+require "watirspec_helper"
+
+describe "IFrames" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("iframes.html"))
+  end
+
+  describe "with selectors" do
+    it "returns the matching elements" do
+      expect(browser.iframes(id: "iframe_2").to_a).to eq [browser.iframe(id: "iframe_2")]
+    end
+  end
+
+  describe "eql?" do
+    it "matches equality of iframe with that from a collection" do
+      expect(browser.iframes.last).to eq browser.iframe(id: "iframe_2")
+    end
+
+  end
+
+  describe "#length" do
+    it "returns the correct number of iframes" do
+      expect(browser.iframes.length).to eq 2
+    end
+  end
+
+  describe "#[]" do
+    it "returns the iframe at the given index" do
+      expect(browser.iframes[0].id).to eq "iframe_1"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through frames correctly" do
+      count = 0
+
+      browser.iframes.each_with_index do |f, index|
+        expect(f.name).to eq browser.iframe(index: index).name
+        expect(f.id).to eq browser.iframe(index: index).id
+        count += 1
+      end
+
+      expect(count).to be > 0
+    end
+  end
+end

data/spec/watirspec/elements/image_spec.rb

@@ -0,0 +1,164 @@
+require "watirspec_helper"
+
+describe "Image" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("images.html"))
+  end
+
+  # Exists method
+  describe "#exists?" do
+    it "returns true when the image exists" do
+      expect(browser.image(id: 'square')).to exist
+      expect(browser.image(id: /square/)).to exist
+      expect(browser.image(src: 'images/circle.png')).to exist
+      expect(browser.image(src: /circle/)).to exist
+      expect(browser.image(alt: 'circle')).to exist
+      expect(browser.image(alt: /cir/)).to exist
+      expect(browser.image(title: 'Circle')).to exist
+    end
+
+    it "returns the first image if given no args" do
+      expect(browser.image).to exist
+    end
+
+    it "returns false when the image doesn't exist" do
+      expect(browser.image(id: 'no_such_id')).to_not exist
+      expect(browser.image(id: /no_such_id/)).to_not exist
+      expect(browser.image(src: 'no_such_src')).to_not exist
+      expect(browser.image(src: /no_such_src/)).to_not exist
+      expect(browser.image(alt: 'no_such_alt')).to_not exist
+      expect(browser.image(alt: /no_such_alt/)).to_not exist
+      expect(browser.image(title: 'no_such_title')).to_not exist
+      expect(browser.image(title: /no_such_title/)).to_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.image(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.image(no_such_how: 'some_value').exists? }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+    end
+  end
+
+  # Attribute methods
+  describe "#alt" do
+    it "returns the alt attribute of the image if the image exists" do
+      expect(browser.image(id: 'square').alt).to eq "square"
+      expect(browser.image(title: 'Circle').alt).to eq 'circle'
+    end
+
+    it "returns an empty string if the image exists and the attribute doesn't" do
+      expect(browser.image(index: 0).alt).to eq ""
+    end
+
+    it "raises UnknownObjectException if the image doesn't exist" do
+      expect { browser.image(index: 1337).alt }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#id" do
+    it "returns the id attribute of the image if the image exists" do
+      expect(browser.image(title: 'Square').id).to eq 'square'
+    end
+
+    it "returns an empty string if the image exists and the attribute doesn't" do
+      expect(browser.image(index: 0).id).to eq ""
+    end
+
+    it "raises UnknownObjectException if the image doesn't exist" do
+      expect { browser.image(index: 1337).id }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#src" do
+    it "returns the src attribute of the image if the image exists" do
+      expect(browser.image(id: 'square').src).to include("square.png")
+    end
+
+    it "returns an empty string if the image exists and the attribute doesn't" do
+      expect(browser.image(index: 0).src).to eq ""
+    end
+
+    it "raises UnknownObjectException if the image doesn't exist" do
+      expect { browser.image(index: 1337).src }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#title" do
+    it "returns the title attribute of the image if the image exists" do
+      expect(browser.image(id: 'square').title).to eq 'Square'
+    end
+
+    it "returns an empty string if the image exists and the attribute doesn't" do
+      expect(browser.image(index: 0).title).to eq ""
+    end
+
+    it "raises UnknownObjectException if the image doesn't exist" do
+      expect { browser.image(index: 1337).title }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      expect(browser.image(index: 0)).to respond_to(:class_name)
+      expect(browser.image(index: 0)).to respond_to(:id)
+      expect(browser.image(index: 0)).to respond_to(:style)
+      expect(browser.image(index: 0)).to respond_to(:text)
+    end
+  end
+
+  # Manipulation methods
+  describe "#click" do
+    it "raises UnknownObjectException when the image doesn't exist" do
+      expect { browser.image(id: 'missing_attribute').click }.to raise_unknown_object_exception
+      expect { browser.image(class: 'missing_attribute').click }.to raise_unknown_object_exception
+      expect { browser.image(src: 'missing_attribute').click }.to raise_unknown_object_exception
+      expect { browser.image(alt: 'missing_attribute').click }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#height" do
+    it "returns the height of the image if the image exists" do
+      expect(browser.image(id: 'square').height).to eq 88
+    end
+
+    it "raises UnknownObjectException if the image doesn't exist" do
+      expect { browser.image(index: 1337).height }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#width" do
+    it "returns the width of the image if the image exists" do
+      expect(browser.image(id: 'square').width).to eq 88
+    end
+
+    it "raises UnknownObjectException if the image doesn't exist" do
+      expect { browser.image(index: 1337).width }.to raise_unknown_object_exception
+    end
+  end
+
+  # Other
+  bug "https://bugzilla.mozilla.org/show_bug.cgi?id=1297339", :firefox do
+    describe "#loaded?" do
+      it "returns true if the image has been loaded" do
+        expect(browser.image(title: 'Circle')).to be_loaded
+        expect(browser.image(alt: 'circle')).to be_loaded
+        expect(browser.image(alt: /circle/)).to be_loaded
+      end
+
+      it "returns false if the image has not been loaded" do
+        expect(browser.image(id: 'no_such_file')).to_not be_loaded
+      end
+
+      it "raises UnknownObjectException if the image doesn't exist" do
+        expect { browser.image(id: 'no_such_image').loaded? }.to raise_unknown_object_exception
+        expect { browser.image(src: 'no_such_image').loaded? }.to raise_unknown_object_exception
+        expect { browser.image(alt: 'no_such_image').loaded? }.to raise_unknown_object_exception
+        expect { browser.image(index: 1337).loaded? }.to raise_unknown_object_exception
+      end
+    end
+  end
+
+end

data/spec/watirspec/elements/images_spec.rb

@@ -0,0 +1,40 @@
+require "watirspec_helper"
+
+describe "Images" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("images.html"))
+  end
+
+  describe "with selectors" do
+    it "returns the matching elements" do
+      expect(browser.images(alt: "circle").to_a).to eq [browser.image(alt: "circle")]
+    end
+  end
+
+  describe "#length" do
+    it "returns the number of images" do
+      expect(browser.images.length).to eq 10
+    end
+  end
+
+  describe "#[]" do
+    it "returns the image at the given index" do
+      expect(browser.images[5].id).to eq "square"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through images correctly" do
+      count = 0
+
+      browser.images.each_with_index do |c, index|
+        expect(c.id).to eq browser.image(index: index).id
+        count += 1
+      end
+
+      expect(count).to be > 0
+    end
+  end
+
+end