watir 6.0.0.beta5 → 6.0.0

data/spec/watirspec/elements/elements_spec.rb

@@ -0,0 +1,15 @@
+require "watirspec_helper"
+
+describe "Elements" do
+  before :each do
+    browser.goto(WatirSpec.url_for("forms_with_input_elements.html"))
+  end
+
+  describe "#[]" do
+    context "when elements do not exist" do
+      it "returns not existing element" do
+        expect(browser.elements(id: "non-existing")[0]).not_to exist
+      end
+    end
+  end
+end

data/spec/watirspec/elements/em_spec.rb

@@ -0,0 +1,100 @@
+require "watirspec_helper"
+
+describe "Em" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("non_control_elements.html"))
+  end
+
+  # Exists method
+  describe "#exists?" do
+    it "returns true if the element exists" do
+      expect(browser.em(id: "important-id")).to exist
+      expect(browser.em(class: "important-class")).to exist
+      expect(browser.em(xpath: "//em[@id='important-id']")).to exist
+      expect(browser.em(index: 0)).to exist
+    end
+
+    it "returns the first em if given no args" do
+      expect(browser.em).to exist
+    end
+
+    it "returns false if the element does not exist" do
+      expect(browser.em(id: "no_such_id")).to_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.em(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.em(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 if the element exists" do
+      expect(browser.em(id: "important-id").class_name).to eq "important-class"
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      expect { browser.em(id: "no_such_id").class_name }.to raise_unknown_object_exception
+      expect { browser.em(title: "no_such_title").class_name }.to raise_unknown_object_exception
+      expect { browser.em(index: 1337).class_name }.to raise_unknown_object_exception
+      expect { browser.em(xpath: "//em[@id='no_such_id']").class_name }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#id" do
+    it "returns the id attribute if the element exists" do
+      expect(browser.em(class: 'important-class').id).to eq "important-id"
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      expect {browser.em(id: "no_such_id").id }.to raise_unknown_object_exception
+      expect {browser.em(title: "no_such_id").id }.to raise_unknown_object_exception
+      expect {browser.em(index: 1337).id }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#title" do
+    it "returns the title of the element" do
+      expect(browser.em(class: "important-class").title).to eq "ergo cogito"
+    end
+  end
+
+  describe "#text" do
+    it "returns the text of the element" do
+      expect(browser.em(id: "important-id").text).to eq "ergo cogito"
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      expect { browser.em(id: "no_such_id").text }.to raise_unknown_object_exception
+      expect { browser.em(title: "no_such_title").text }.to raise_unknown_object_exception
+      expect { browser.em(index: 1337).text }.to raise_unknown_object_exception
+      expect { browser.em(xpath: "//em[@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.em(index: 0)).to respond_to(:id)
+      expect(browser.em(index: 0)).to respond_to(:class_name)
+      expect(browser.em(index: 0)).to respond_to(:style)
+      expect(browser.em(index: 0)).to respond_to(:text)
+      expect(browser.em(index: 0)).to respond_to(:title)
+    end
+  end
+
+  # Manipulation methods
+  describe "#click" do
+    it "raises UnknownObjectException if the element does not exist" do
+      expect { browser.em(id: "no_such_id").click }.to raise_unknown_object_exception
+      expect { browser.em(title: "no_such_title").click }.to raise_unknown_object_exception
+      expect { browser.em(index: 1337).click }.to raise_unknown_object_exception
+      expect { browser.em(xpath: "//em[@id='no_such_id']").click }.to raise_unknown_object_exception
+    end
+  end
+
+end

data/spec/watirspec/elements/ems_spec.rb

@@ -0,0 +1,43 @@
+require "watirspec_helper"
+
+describe "Ems" 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.ems(class: "important-class").to_a).to eq [browser.em(class: "important-class")]
+    end
+  end
+
+  describe "#length" do
+    it "returns the number of ems" do
+      expect(browser.ems.length).to eq 1
+    end
+  end
+
+  describe "#[]" do
+    it "returns the em at the given index" do
+      expect(browser.ems[0].id).to eq "important-id"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through ems correctly" do
+      count = 0
+
+      browser.ems.each_with_index do |e, index|
+        expect(e.text).to eq browser.em(index: index).text
+        expect(e.id).to eq browser.em(index: index).id
+        expect(e.class_name).to eq browser.em(index: index).class_name
+
+        count += 1
+      end
+
+      expect(count).to be > 0
+    end
+  end
+
+end

data/spec/watirspec/elements/filefield_spec.rb

@@ -0,0 +1,181 @@
+require "watirspec_helper"
+
+describe "FileField" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("forms_with_input_elements.html"))
+  end
+
+  describe "#exist?" do
+    it "returns true if the file field exists" do
+      expect(browser.file_field(id: 'new_user_portrait')).to exist
+      expect(browser.file_field(id: /new_user_portrait/)).to exist
+      expect(browser.file_field(name: 'new_user_portrait')).to exist
+      expect(browser.file_field(name: /new_user_portrait/)).to exist
+      expect(browser.file_field(class: 'portrait')).to exist
+      expect(browser.file_field(class: /portrait/)).to exist
+      expect(browser.file_field(index: 0)).to exist
+      expect(browser.file_field(xpath: "//input[@id='new_user_portrait']")).to exist
+    end
+
+    it "returns the first file field if given no args" do
+      expect(browser.file_field).to exist
+    end
+
+    it "returns true for element with upper case type" do
+      expect(browser.file_field(id: "new_user_resume")).to exist
+    end
+
+    it "returns false if the file field doesn't exist" do
+      expect(browser.file_field(id: 'no_such_id')).to_not exist
+      expect(browser.file_field(id: /no_such_id/)).to_not exist
+      expect(browser.file_field(name: 'no_such_name')).to_not exist
+      expect(browser.file_field(name: /no_such_name/)).to_not exist
+      expect(browser.file_field(class: 'no_such_class')).to_not exist
+      expect(browser.file_field(class: /no_such_class/)).to_not exist
+      expect(browser.file_field(index: 1337)).to_not exist
+      expect(browser.file_field(xpath: "//input[@id='no_such_id']")).to_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.file_field(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.file_field(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 if the text field exists" do
+      expect(browser.file_field(index: 0).class_name).to eq "portrait"
+    end
+
+    it "raises UnknownObjectException if the text field doesn't exist" do
+      expect { browser.file_field(index: 1337).class_name }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#id" do
+    it "returns the id attribute if the text field exists" do
+      expect(browser.file_field(index: 0).id).to eq "new_user_portrait"
+    end
+
+    it "raises UnknownObjectException if the text field doesn't exist" do
+      expect { browser.file_field(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.file_field(index: 0).name).to eq "new_user_portrait"
+    end
+
+    it "raises UnknownObjectException if the text field doesn't exist" do
+      expect { browser.file_field(index: 1337).name }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#title" do
+    it "returns the title attribute if the text field exists" do
+      expect(browser.file_field(id: "new_user_portrait").title).to eq "Smile!"
+    end
+  end
+
+  describe "#type" do
+    it "returns the type attribute if the text field exists" do
+      expect(browser.file_field(index: 0).type).to eq "file"
+    end
+
+    it "raises UnknownObjectException if the text field doesn't exist" do
+      expect { browser.file_field(index: 1337).type }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      expect(browser.file_field(index: 0)).to respond_to(:class_name)
+      expect(browser.file_field(index: 0)).to respond_to(:id)
+      expect(browser.file_field(index: 0)).to respond_to(:name)
+      expect(browser.file_field(index: 0)).to respond_to(:title)
+      expect(browser.file_field(index: 0)).to respond_to(:type)
+      expect(browser.file_field(index: 0)).to respond_to(:value)
+    end
+  end
+
+  # Manipulation methods
+
+  describe "#set" do
+    not_compliant_on :safari do
+      bug "https://bugzilla.mozilla.org/show_bug.cgi?id=1260233", :firefox do
+        bug "https://github.com/detro/ghostdriver/issues/183", :phantomjs do
+          it "is able to set a file path in the field and click the upload button and fire the onchange event" do
+            browser.goto WatirSpec.url_for("forms_with_input_elements.html")
+
+            path = File.expand_path(__FILE__)
+            element = browser.file_field(name: "new_user_portrait")
+
+            element.set path
+
+            expect(element.value).to include(File.basename(path)) # only some browser will return the full path
+            expect(messages.first).to include(File.basename(path))
+
+            browser.button(name: "new_user_submit").click
+          end
+        end
+
+        it "raises an error if the file does not exist" do
+          expect {
+            browser.file_field.set(File.join(Dir.tmpdir, 'unlikely-to-exist'))
+          }.to raise_error(Errno::ENOENT)
+        end
+      end
+    end
+  end
+
+
+  bug "https://github.com/detro/ghostdriver/issues/183", :phantomjs do
+    not_compliant_on :safari do
+        describe "#value=" do
+          bug "https://bugzilla.mozilla.org/show_bug.cgi?id=1260233", :firefox do
+            it "is able to set a file path in the field and click the upload button and fire the onchange event" do
+            browser.goto WatirSpec.url_for("forms_with_input_elements.html")
+
+            path = File.expand_path(__FILE__)
+            element = browser.file_field(name: "new_user_portrait")
+
+            element.value = path
+            expect(element.value).to include(File.basename(path)) # only some browser will return the full path
+          end
+
+          not_compliant_on :internet_explorer do
+            bug "Raises File not found error - File Bug Report", :firefox do
+              it "does not raise an error if the file does not exist" do
+                path = File.join(Dir.tmpdir, 'unlikely-to-exist')
+                browser.file_field.value = path
+
+                expected = path
+                expected.gsub!("/", "\\") if Selenium::WebDriver::Platform.windows?
+
+                expect(browser.file_field.value).to include(File.basename(expected)) # only some browser will return the full path
+              end
+            end
+
+            not_compliant_on %i(chrome windows) do
+              bug "Raises File not found error - File Bug Report", :firefox do
+                it "does not alter its argument" do
+                  value = '/foo/bar'
+                  browser.file_field.value = value
+                  expect(value).to eq '/foo/bar'
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+
+end

data/spec/watirspec/elements/filefields_spec.rb

@@ -0,0 +1,43 @@
+require "watirspec_helper"
+
+describe "FileFields" 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.file_fields(class: "portrait").to_a).to eq [browser.file_field(class: "portrait")]
+    end
+  end
+
+  describe "#length" do
+    it "returns the correct number of file fields" do
+      expect(browser.file_fields.length).to eq 3
+    end
+  end
+
+  describe "#[]" do
+    it "returns the file field at the given index" do
+      expect(browser.file_fields[0].id).to eq "new_user_portrait"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through file fields correctly" do
+      count = 0
+
+      browser.file_fields.each_with_index do |f, index|
+        expect(f.name).to eq browser.file_field(index: index).name
+        expect(f.id).to eq browser.file_field(index: index).id
+        expect(f.value).to eq browser.file_field(index: index).value
+
+        count += 1
+      end
+
+      expect(count).to be > 0
+    end
+  end
+
+end

data/spec/watirspec/elements/font_spec.rb

@@ -0,0 +1,29 @@
+require "watirspec_helper"
+
+describe "Font" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("font.html"))
+  end
+
+  it "finds the font element" do
+    expect(browser.font(index: 0)).to exist
+  end
+
+  it "knows about the color attribute" do
+    expect(browser.font(index: 0).color).to eq "#ff00ff"
+  end
+
+  it "knows about the face attribute" do
+    expect(browser.font(index: 0).face).to eq "Helvetica"
+  end
+
+  it "knows about the size attribute" do
+    expect(browser.font(index: 0).size).to eq "12"
+  end
+
+  it "finds all font elements" do
+    expect(browser.fonts.size).to eq 1
+  end
+
+end

data/spec/watirspec/elements/form_spec.rb

@@ -0,0 +1,70 @@
+require "watirspec_helper"
+
+describe "Form" do
+
+  before :each do
+   browser.goto(WatirSpec.url_for("forms_with_input_elements.html"))
+  end
+
+  describe "#exists?" do
+    it "returns true if the form exists" do
+      expect(browser.form(id: 'new_user')).to exist
+      expect(browser.form(id: /new_user/)).to exist
+
+      expect(browser.form(class: 'user')).to exist
+      expect(browser.form(class: /user/)).to exist
+
+      expect(browser.form(method: 'post')).to exist
+      expect(browser.form(method: /post/)).to exist
+      expect(browser.form(action: /to_me/)).to exist
+      expect(browser.form(index: 0)).to exist
+      expect(browser.form(xpath: "//form[@id='new_user']")).to exist
+    end
+
+    it "returns the first form if given no args" do
+      expect(browser.form).to exist
+    end
+
+    it "returns false if the form doesn't exist" do
+      expect(browser.form(id: 'no_such_id')).to_not exist
+      expect(browser.form(id: /no_such_id/)).to_not exist
+
+      expect(browser.form(class: 'no_such_class')).to_not exist
+      expect(browser.form(class: /no_such_class/)).to_not exist
+
+      expect(browser.form(method: 'no_such_method')).to_not exist
+      expect(browser.form(method: /no_such_method/)).to_not exist
+      expect(browser.form(action: 'no_such_action')).to_not exist
+      expect(browser.form(action: /no_such_action/)).to_not exist
+      expect(browser.form(index: 1337)).to_not exist
+      expect(browser.form(xpath: "//form[@id='no_such_id']")).to_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.form(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.form(no_such_how: 'some_value').exists? }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+    end
+  end
+
+  bug "https://bugzilla.mozilla.org/show_bug.cgi?id=1290985", :firefox do
+    describe "#submit" do
+      it "submits the form" do
+        browser.form(id: "delete_user").submit
+        Watir::Wait.until { !browser.url.include? 'forms_with_input_elements.html' }
+        expect(browser.text).to include("Semantic table")
+      end
+
+      it "triggers onsubmit event and takes its result into account" do
+        form = browser.form(name: "user_new")
+        form.submit
+        expect(form).to exist
+        expect(messages.size).to eq 1
+        expect(messages[0]).to eq "submit"
+      end
+    end
+  end
+
+end