watir 6.0.0.beta5 → 6.0.0

data/spec/watirspec/elements/forms_spec.rb

@@ -0,0 +1,44 @@
+require "watirspec_helper"
+
+describe "Forms" 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.forms(method: "post").to_a).to eq [browser.form(method: "post")]
+    end
+  end
+
+  describe "#length" do
+    it "returns the number of forms in the container" do
+      expect(browser.forms.length).to eq 2
+    end
+  end
+
+  describe "#[]n" do
+    it "provides access to the nth form" do
+      expect(browser.forms[0].action).to match(/post_to_me$/) # varies between browsers
+      expect(browser.forms[0].attribute_value('method')).to eq 'post'
+    end
+  end
+
+  describe "#each" do
+    it "iterates through forms correctly" do
+      count = 0
+
+      browser.forms.each_with_index do |f, index|
+        expect(f.name).to eq browser.form(index: index).name
+        expect(f.id).to eq browser.form(index: index).id
+        expect(f.class_name).to eq browser.form(index: index).class_name
+
+        count += 1
+      end
+
+      expect(count).to be > 0
+    end
+  end
+
+end

data/spec/watirspec/elements/frame_spec.rb

@@ -0,0 +1,121 @@
+require "watirspec_helper"
+
+#
+# TODO: fix duplication with iframe_spec
+#
+
+describe "Frame" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("frames.html"))
+  end
+
+  it "handles crossframe javascript" do
+    browser.goto WatirSpec.url_for("frames.html")
+
+    expect(browser.frame(id: "frame_1").text_field(name: 'senderElement').value).to eq 'send_this_value'
+    expect(browser.frame(id: "frame_2").text_field(name: 'recieverElement').value).to eq 'old_value'
+    browser.frame(id: "frame_1").button(id: 'send').click
+    expect(browser.frame(id: "frame_2").text_field(name: 'recieverElement').value).to eq 'send_this_value'
+  end
+
+  describe "#exist?" do
+    it "returns true if the frame exists" do
+      expect(browser.frame(id: "frame_1")).to exist
+      expect(browser.frame(name: "frame1")).to exist
+      expect(browser.frame(index: 0)).to exist
+      expect(browser.frame(class: "half")).to exist
+      expect(browser.frame(xpath: "//frame[@id='frame_1']")).to exist
+      expect(browser.frame(src: "frame_1.html")).to exist
+      expect(browser.frame(id: /frame/)).to exist
+      expect(browser.frame(name: /frame/)).to exist
+      expect(browser.frame(src: /frame_1/)).to exist
+      expect(browser.frame(class: /half/)).to exist
+    end
+
+    it "returns the first frame if given no args" do
+      expect(browser.frame).to exist
+    end
+
+    it "returns false if the frame doesn't exist" do
+      expect(browser.frame(id: "no_such_id")).to_not exist
+      expect(browser.frame(name: "no_such_text")).to_not exist
+      expect(browser.frame(index: 1337)).to_not exist
+      expect(browser.frame(src: "no_such_src")).to_not exist
+      expect(browser.frame(class: "no_such_class")).to_not exist
+      expect(browser.frame(id: /no_such_id/)).to_not exist
+      expect(browser.frame(name: /no_such_text/)).to_not exist
+      expect(browser.frame(src: /no_such_src/)).to_not exist
+      expect(browser.frame(class: /no_such_class/)).to_not exist
+      expect(browser.frame(xpath: "//frame[@id='no_such_id']")).to_not 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 frames" do
+          browser.goto(WatirSpec.url_for("nested_frames.html"))
+
+          browser.frame(id: "two").frame(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.frame(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.frame(no_such_how: 'some_value').exists? }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+    end
+  end
+
+  it "raises UnknownFrameException when accessing elements inside non-existing frame" do
+    expect { browser.frame(name: "no_such_name").p(index: 0).id }.to raise_unknown_frame_exception
+  end
+
+  it "raises UnknownFrameException when accessing a non-existing frame" do
+    expect { browser.frame(name: "no_such_name").id }.to raise_unknown_frame_exception
+  end
+
+  it "raises UnknownFrameException when accessing a non-existing subframe" do
+    expect { browser.frame(name: "frame1").frame(name: "no_such_name").id }.to raise_unknown_frame_exception
+  end
+
+  it "raises UnknownObjectException when accessing a non-existing element inside an existing frame" do
+    expect { browser.frame(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.frame(index: 0).foo }.to raise_error(NoMethodError)
+  end
+
+  it "is able to set a field" do
+    browser.frame(index: 0).text_field(name: 'senderElement').set("new value")
+    expect(browser.frame(index: 0).text_field(name: 'senderElement').value).to eq "new value"
+  end
+
+  it "can access the frame's parent element after use" do
+    el = browser.frameset
+    el.frame.text_field.value
+    expect(el.attribute_value("cols")).to be_kind_of(String)
+  end
+
+  describe "#execute_script" do
+    it "executes the given javascript in the specified frame" do
+      frame = browser.frame(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 frame" do
+      browser.goto WatirSpec.url_for("frames.html")
+      expect(browser.frame.html.downcase).to include("<title>frame 1</title>")
+    end
+  end
+
+end

data/spec/watirspec/elements/frames_spec.rb

@@ -0,0 +1,41 @@
+require "watirspec_helper"
+
+describe "Frames" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("frames.html"))
+  end
+
+  describe "with selectors" do
+    it "returns the matching elements" do
+      expect(browser.frames(name: "frame2").to_a).to eq [browser.frame(name: "frame2")]
+    end
+  end
+
+  describe "#length" do
+    it "returns the correct number of frames" do
+      expect(browser.frames.length).to eq 2
+    end
+  end
+
+  describe "#[]" do
+    it "returns the frame at the given index" do
+      expect(browser.frames[0].id).to eq "frame_1"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through frames correctly" do
+      count = 0
+
+      browser.frames.each_with_index do |f, index|
+        expect(f.name).to eq browser.frame(index: index).name
+        expect(f.id).to eq browser.frame(index: index).id
+        count += 1
+      end
+
+      expect(count).to be > 0
+    end
+  end
+end
+

data/spec/watirspec/elements/hidden_spec.rb

@@ -0,0 +1,102 @@
+require "watirspec_helper"
+
+describe "Hidden" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("forms_with_input_elements.html"))
+  end
+
+  # Exist method
+  describe "#exists?" do
+    it "returns true if the element exists" do
+      expect(browser.hidden(id: 'new_user_interests_dolls')).to exist
+      expect(browser.hidden(id: /new_user_interests_dolls/)).to exist
+      expect(browser.hidden(name: 'new_user_interests')).to exist
+      expect(browser.hidden(name: /new_user_interests/)).to exist
+      expect(browser.hidden(value: 'dolls')).to exist
+      expect(browser.hidden(value: /dolls/)).to exist
+      expect(browser.hidden(class: 'fun')).to exist
+      expect(browser.hidden(class: /fun/)).to exist
+      expect(browser.hidden(index: 0)).to exist
+      expect(browser.hidden(xpath: "//input[@id='new_user_interests_dolls']")).to exist
+    end
+
+    it "returns the first hidden if given no args" do
+      expect(browser.hidden).to exist
+    end
+
+    it "returns false if the element does not exist" do
+      expect(browser.hidden(id: 'no_such_id')).to_not exist
+      expect(browser.hidden(id: /no_such_id/)).to_not exist
+      expect(browser.hidden(name: 'no_such_name')).to_not exist
+      expect(browser.hidden(name: /no_such_name/)).to_not exist
+      expect(browser.hidden(value: 'no_such_value')).to_not exist
+      expect(browser.hidden(value: /no_such_value/)).to_not exist
+      expect(browser.hidden(text: 'no_such_text')).to_not exist
+      expect(browser.hidden(text: /no_such_text/)).to_not exist
+      expect(browser.hidden(class: 'no_such_class')).to_not exist
+      expect(browser.hidden(class: /no_such_class/)).to_not exist
+      expect(browser.hidden(index: 1337)).to_not exist
+      expect(browser.hidden(xpath: "//input[@id='no_such_id']")).to_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.hidden(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.hidden(no_such_how: 'some_value').exists? }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+    end
+  end
+
+  # Attribute methods
+  describe "#id" do
+    it "returns the id attribute if the text field exists" do
+      expect(browser.hidden(index: 1).id).to eq "new_user_interests_dolls"
+    end
+
+    it "raises UnknownObjectException if the text field doesn't exist" do
+      expect { browser.hidden(index: 1337).id }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#name" do
+    it "returns the name attribute if the text field exists" do
+      expect(browser.hidden(index: 1).name).to eq "new_user_interests"
+    end
+
+    it "raises UnknownObjectException if the text field doesn't exist" do
+      expect { browser.hidden(index: 1337).name }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#type" do
+    it "returns the type attribute if the text field exists" do
+      expect(browser.hidden(index: 1).type).to eq "hidden"
+    end
+
+    it "raises UnknownObjectException if the text field doesn't exist" do
+      expect { browser.hidden(index: 1337).type }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#value" do
+    it "returns the value attribute if the text field exists" do
+      expect(browser.hidden(index: 1).value).to eq "dolls"
+    end
+
+    it "raises UnknownObjectException if the text field doesn't exist" do
+      expect { browser.hidden(index: 1337).value }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      expect(browser.hidden(index: 1)).to respond_to(:id)
+      expect(browser.hidden(index: 1)).to respond_to(:name)
+      expect(browser.hidden(index: 1)).to respond_to(:type)
+      expect(browser.hidden(index: 1)).to respond_to(:value)
+    end
+  end
+
+end

data/spec/watirspec/elements/hiddens_spec.rb

@@ -0,0 +1,43 @@
+require "watirspec_helper"
+
+describe "Hiddens" 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.hiddens(value: "dolls").to_a).to eq [browser.hidden(value: "dolls")]
+    end
+  end
+
+  describe "#length" do
+    it "returns the number of hiddens" do
+      expect(browser.hiddens.length).to eq 2
+    end
+  end
+
+  describe "#[]" do
+    it "returns the Hidden at the given index" do
+      expect(browser.hiddens[1].id).to eq "new_user_interests_dolls"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through hiddens correctly" do
+      count = 0
+
+      browser.hiddens.each_with_index do |h, index|
+        expect(h.name).to eq browser.hidden(index: index).name
+        expect(h.id).to eq browser.hidden(index: index).id
+        expect(h.value).to eq browser.hidden(index: index).value
+
+        count += 1
+      end
+
+      expect(count).to be > 0
+    end
+  end
+
+end

data/spec/watirspec/elements/hn_spec.rb

@@ -0,0 +1,96 @@
+require "watirspec_helper"
+
+describe ["H1", "H2", "H3", "H4", "H5", "H6"] do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("non_control_elements.html"))
+  end
+
+  # Exists method
+  describe "#exist?" do
+    it "returns true if the element exists" do
+      expect(browser.h1(id: "header1")).to exist
+      expect(browser.h2(id: /header2/)).to exist
+      expect(browser.h3(text: "Header 3")).to exist
+      expect(browser.h4(text: /Header 4/)).to exist
+      expect(browser.h5(index: 0)).to exist
+      expect(browser.h6(index: 0)).to exist
+      expect(browser.h1(xpath: "//h1[@id='first_header']")).to exist
+    end
+
+    it "returns the first h1 if given no args" do
+      expect(browser.h1).to exist
+    end
+
+    it "returns true if the element exists" do
+      expect(browser.h1(id: "no_such_id")).to_not exist
+      expect(browser.h1(id: /no_such_id/)).to_not exist
+      expect(browser.h1(text: "no_such_text")).to_not exist
+      expect(browser.h1(text: /no_such_text 1/)).to_not exist
+      expect(browser.h1(index: 1337)).to_not exist
+      expect(browser.h1(xpath: "//p[@id='no_such_id']")).to_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.h1(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.h1(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.h1(index: 0).class_name).to eq 'primary'
+    end
+
+    it "returns an empty string if the element exists and the attribute doesn't" do
+      expect(browser.h2(index: 0).class_name).to eq ''
+    end
+
+    it "raises UnknownObjectException if the p doesn't exist" do
+      expect { browser.h2(id: 'no_such_id').class_name }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#id" do
+    it "returns the id attribute" do
+      expect(browser.h1(index: 0).id).to eq "first_header"
+    end
+
+    it "returns an empty string if the element exists and the attribute doesn't" do
+      expect(browser.h3(index: 0).id).to eq ''
+    end
+
+    it "raises UnknownObjectException if the p doesn't exist" do
+      expect { browser.h1(id: "no_such_id").id }.to raise_unknown_object_exception
+      expect { browser.h1(index: 1337).id }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#text" do
+    it "returns the text of the element" do
+      expect(browser.h1(index: 0).text).to eq 'Header 1'
+    end
+
+    it "returns an empty string if the element doesn't contain any text" do
+      expect(browser.h6(id: "empty_header").text).to eq ''
+    end
+
+    it "raises UnknownObjectException if the p doesn't exist" do
+      expect { browser.h1(id: 'no_such_id').text }.to raise_unknown_object_exception
+      expect { browser.h1(:xpath , "//h1[@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.h1(index: 0)).to respond_to(:class_name)
+      expect(browser.h1(index: 0)).to respond_to(:id)
+      expect(browser.h1(index: 0)).to respond_to(:text)
+    end
+  end
+
+end