watir 6.0.0.beta5 → 6.0.0

data/spec/watirspec/drag_and_drop_spec.rb

@@ -0,0 +1,49 @@
+require "watirspec_helper"
+
+describe "Element" do
+  bug "Actions Endpoint Not Yet Implemented", :firefox do
+    context "drag and drop" do
+      before { browser.goto WatirSpec.url_for("drag_and_drop.html") }
+
+      let(:draggable) { browser.div id: "draggable" }
+      let(:droppable) { browser.div id: "droppable" }
+
+      not_compliant_on :safari do
+        it "can drag and drop an element onto another" do
+          expect(droppable.text).to eq 'Drop here'
+          draggable.drag_and_drop_on droppable
+          expect(droppable.text).to eq 'Dropped!'
+        end
+
+        bug "http://code.google.com/p/selenium/issues/detail?id=3075", :ff_legacy do
+          it "can drag and drop an element onto another when draggable is out of viewport" do
+            reposition "draggable"
+            perform_drag_and_drop_on_droppable
+          end
+
+          it "can drag and drop an element onto another when droppable is out of viewport" do
+            reposition "droppable"
+            perform_drag_and_drop_on_droppable
+          end
+        end
+
+        it "can drag an element by the given offset" do
+          expect(droppable.text).to eq 'Drop here'
+          draggable.drag_and_drop_by 200, 50
+          expect(droppable.text).to eq 'Dropped!'
+        end
+
+        def reposition(what)
+          browser.button(id: "reposition#{what.capitalize}").click
+        end
+
+        def perform_drag_and_drop_on_droppable
+          expect(droppable.text).to eq "Drop here"
+          draggable.drag_and_drop_on droppable
+          expect(droppable.text).to eq 'Dropped!'
+        end
+      end
+
+    end
+  end
+end

data/spec/watirspec/element_hidden_spec.rb

@@ -0,0 +1,65 @@
+require 'watirspec_helper'
+
+describe Watir::Locators::Element::Locator do
+
+  describe "Visible Elements" do
+    before do
+      browser.goto(WatirSpec.url_for("wait.html"))
+    end
+
+    context "when true" do
+      it "finds single element" do
+        element =  browser.body.element(visible: true)
+        expect(element.id).to eq 'foo'
+      end
+
+      it "handles tag_name and index" do
+        element =  browser.div(visible: true, index: 1)
+        expect(element.id).to eq 'buttons'
+      end
+
+      it "handles :tag_name and a single regexp attribute" do
+        element = browser.div(visible: true, id: /ons/)
+        expect(element.id).to eq 'buttons'
+      end
+
+      it "handles :xpath" do
+        element = browser.element(visible: true, xpath: './/div[@id="foo"]')
+        expect(element.id).to eq 'foo'
+      end
+
+      it "handles :css" do
+        element = browser.element(visible: true, css: 'div#foo')
+        expect(element.id).to eq 'foo'
+      end
+    end
+
+    context "when false" do
+      it "finds single element" do
+        element =  browser.body.element(visible: false)
+        expect(element.id).to eq 'bar'
+      end
+
+      it "handles tag_name and index" do
+        element =  browser.div(visible: false, index: 1)
+        expect(element.id).to eq 'also_hidden'
+      end
+
+      it "handles :tag_name and a single regexp attribute" do
+        element = browser.div(visible: false, id: /_/)
+        expect(element.id).to eq 'also_hidden'
+      end
+
+      it "handles :xpath" do
+        element = browser.element(visible: false, xpath: './/div[@id="bar"]')
+        expect(element.id).to eq 'bar'
+      end
+
+      it "handles :css" do
+        element = browser.element(visible: false, css: 'div#bar')
+        expect(element.id).to eq 'bar'
+      end
+    end
+  end
+end
+

data/spec/watirspec/elements/area_spec.rb

@@ -0,0 +1,76 @@
+require "watirspec_helper"
+
+describe "Area" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("images.html"))
+  end
+
+  # Exists method
+  describe "#exist?" do
+    it "returns true if the area exists" do
+      expect(browser.area(id: "NCE")).to exist
+      expect(browser.area(id: /NCE/)).to exist
+      expect(browser.area(title: "Tables")).to exist
+      expect(browser.area(title: /Tables/)).to exist
+
+      not_compliant_on :internet_explorer do
+        expect(browser.area(href: "tables.html")).to exist
+      end
+
+      expect(browser.area(href: /tables/)).to exist
+
+      expect(browser.area(index: 0)).to exist
+      expect(browser.area(xpath: "//area[@id='NCE']")).to exist
+    end
+
+    it "returns the first area if given no args" do
+      expect(browser.area).to exist
+    end
+
+    it "returns false if the area doesn't exist" do
+      expect(browser.area(id: "no_such_id")).to_not exist
+      expect(browser.area(id: /no_such_id/)).to_not exist
+      expect(browser.area(title: "no_such_title")).to_not exist
+      expect(browser.area(title: /no_such_title/)).to_not exist
+
+      expect(browser.area(href: "no-tables.html")).to_not exist
+      expect(browser.area(href: /no-tables/)).to_not exist
+
+      expect(browser.area(index: 1337)).to_not exist
+      expect(browser.area(xpath: "//area[@id='no_such_id']")).to_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.area(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.area(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.area(index: 0).id).to eq "NCE"
+    end
+
+    it "returns an empty string if the element exists and the attribute doesn't" do
+      expect(browser.area(index: 2).id).to eq ''
+    end
+
+    it "raises UnknownObjectException if the area doesn't exist" do
+      expect { browser.area(id: "no_such_id").id }.to raise_unknown_object_exception
+      expect { browser.area(index: 1337).id }.to raise_unknown_object_exception
+    end
+
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      expect(browser.area(index: 0)).to respond_to(:id)
+    end
+  end
+
+end

data/spec/watirspec/elements/areas_spec.rb

@@ -0,0 +1,42 @@
+require "watirspec_helper"
+
+describe "Areas" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("images.html"))
+  end
+
+  describe "with selectors" do
+    it "returns the matching elements" do
+      expect(browser.areas(alt: "Tables").to_a).to eq [browser.area(alt: "Tables")]
+    end
+  end
+
+  describe "#length" do
+    it "returns the number of areas" do
+      expect(browser.areas.length).to eq 3
+    end
+  end
+
+  describe "#[]" do
+    it "returns the area at the given index" do
+      expect(browser.areas[0].id).to eq("NCE")
+    end
+  end
+
+  describe "#each" do
+    it "iterates through areas correctly" do
+      count = 0
+
+      browser.areas.each_with_index do |a, index|
+        expect(a.id).to eq browser.area(index: index).id
+        expect(a.title).to eq browser.area(index: index).title
+
+        count += 1
+      end
+
+      expect(count).to be > 0
+    end
+  end
+
+end

data/spec/watirspec/elements/button_spec.rb

@@ -0,0 +1,270 @@
+require "watirspec_helper"
+
+describe "Button" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("forms_with_input_elements.html"))
+  end
+
+  # Exists method
+  describe "#exists?" do
+    it "returns true if the button exists (tag = :input)" do
+      expect(browser.button(id: "new_user_submit")).to exist
+      expect(browser.button(id: /new_user_submit/)).to exist
+      expect(browser.button(name: "new_user_reset")).to exist
+      expect(browser.button(name: /new_user_reset/)).to exist
+      expect(browser.button(value: "Button")).to exist
+      expect(browser.button(value: /Button/)).to exist
+      not_compliant_on :internet_explorer do
+        expect(browser.button(src: "images/button.png")).to exist
+      end
+      expect(browser.button(src: /button\.png/)).to exist
+      expect(browser.button(text: "Button 2")).to exist
+      expect(browser.button(text: /Button 2/)).to exist
+      expect(browser.button(class: "image")).to exist
+      expect(browser.button(class: /image/)).to exist
+      expect(browser.button(index: 0)).to exist
+      expect(browser.button(xpath: "//input[@id='new_user_submit']")).to exist
+      expect(browser.button(alt: "Create a new user")).to exist
+      expect(browser.button(alt: /Create a/)).to exist
+    end
+
+    it "returns true if the button exists (tag = :button)" do
+      expect(browser.button(name: "new_user_button_2")).to exist
+      expect(browser.button(name: /new_user_button_2/)).to exist
+      expect(browser.button(value: "button_2")).to exist
+      expect(browser.button(value: /button_2/)).to exist
+      expect(browser.button(text: 'Button 2')).to exist
+      expect(browser.button(text: /Button 2/)).to exist
+      expect(browser.button(value: 'Button 2')).to exist
+      expect(browser.button(value: /Button 2/)).to exist
+    end
+
+    it "returns true if the button exists (how = :caption)" do
+      expect(browser.button(caption: "Button 2")).to exist
+      expect(browser.button(caption: /Button 2/)).to exist
+    end
+
+    it "returns the first button if given no args" do
+      expect(browser.button).to exist
+    end
+
+    it "returns true for element with upper case type" do
+      expect(browser.button(id: "new_user_button_preview")).to exist
+    end
+
+    it "returns false if the button doesn't exist" do
+      expect(browser.button(id: "no_such_id")).to_not exist
+      expect(browser.button(id: /no_such_id/)).to_not exist
+      expect(browser.button(name: "no_such_name")).to_not exist
+      expect(browser.button(name: /no_such_name/)).to_not exist
+      expect(browser.button(value: "no_such_value")).to_not exist
+      expect(browser.button(value: /no_such_value/)).to_not exist
+      expect(browser.button(src: "no_such_src")).to_not exist
+      expect(browser.button(src: /no_such_src/)).to_not exist
+      expect(browser.button(text: "no_such_text")).to_not exist
+      expect(browser.button(text: /no_such_text/)).to_not exist
+      expect(browser.button(class: "no_such_class")).to_not exist
+      expect(browser.button(class: /no_such_class/)).to_not exist
+      expect(browser.button(index: 1337)).to_not exist
+      expect(browser.button(xpath: "//input[@id='no_such_id']")).to_not exist
+    end
+
+    it "checks the tag name and type attribute when locating by xpath" do
+      expect(browser.button(xpath: "//input[@type='text']")).to_not exist
+      expect(browser.button(xpath: "//input[@type='button']")).to exist
+    end
+
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.button(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.button(no_such_how: 'some_value').exists? }.to raise_error(Watir::Exception::MissingWayOfFindingObjectException)
+    end
+  end
+
+  # Attribute methods
+  describe "#class_name" do
+    it "returns the class name of the button" do
+      expect(browser.button(name: "new_user_image").class_name).to eq "image"
+    end
+
+    it "returns an empty string if the button has no class name" do
+      expect(browser.button(name: "new_user_submit").class_name).to eq ""
+    end
+  end
+
+  describe "#id" do
+    it "returns the id if the button exists" do
+      expect(browser.button(index: 0).id).to eq 'new_user_submit'
+      expect(browser.button(index: 1).id).to eq 'new_user_reset'
+      expect(browser.button(index: 2).id).to eq 'new_user_button'
+    end
+
+    it "raises UnknownObjectException if button does not exist" do
+      expect { browser.button(index: 1337).id }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#name" do
+    it "returns the name if button exists" do
+      expect(browser.button(index: 0).name).to eq 'new_user_submit'
+      expect(browser.button(index: 1).name).to eq 'new_user_reset'
+      expect(browser.button(index: 2).name).to eq 'new_user_button'
+    end
+
+    it "raises UnknownObjectException if the button does not exist" do
+      expect { browser.button(name: "no_such_name").name }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#src" do
+    it "returns the src attribute for the button image" do
+      # varies between browsers
+      expect(browser.button(name: "new_user_image").src).to include("images/button.png")
+    end
+
+    it "raises UnknownObjectException if the button does not exist" do
+      expect { browser.button(name: "no_such_name").src }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#style" do
+    not_compliant_on :internet_explorer, :safari do
+      it "returns the style attribute if the button exists" do
+        expect(browser.button(id: 'delete_user_submit').style).to eq "border: 4px solid red;"
+      end
+    end
+
+    deviates_on :safari do
+      it "returns the style attribute if the button exists" do
+        expect(browser.button(id: 'delete_user_submit').style).to eq "border: 4px solid red;"
+      end
+    end
+
+    it "returns an empty string if the element exists and the attribute doesn't exist" do
+      expect(browser.button(id: 'new_user_submit').style).to eq ""
+    end
+
+    it "raises UnknownObjectException if the button does not exist" do
+      expect { browser.button(name: "no_such_name").style }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#title" do
+    it "returns the title of the button" do
+      expect(browser.button(index: 0).title).to eq 'Submit the form'
+    end
+
+    it "returns an empty string for button without title" do
+      expect(browser.button(index: 1).title).to eq ''
+    end
+  end
+
+  describe "#type" do
+    it "returns the type if button exists" do
+      expect(browser.button(index: 0).type).to eq 'submit'
+      expect(browser.button(index: 1).type).to eq 'reset'
+      expect(browser.button(index: 2).type).to eq 'button'
+    end
+
+    it "raises UnknownObjectException if button does not exist" do
+      expect { browser.button(name: "no_such_name").type }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#value" do
+    it "returns the value if button exists" do
+      expect(browser.button(index: 0).value).to eq 'Submit'
+      expect(browser.button(index: 1).value).to eq 'Reset'
+      expect(browser.button(index: 2).value).to eq 'Button'
+    end
+
+    it "raises UnknownObjectException if button does not exist" do
+      expect { browser.button(name: "no_such_name").value }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#text" do
+    it "returns the text of the button" do
+      expect(browser.button(index: 0).text).to eq 'Submit'
+      expect(browser.button(index: 1).text).to eq 'Reset'
+      expect(browser.button(index: 2).text).to eq 'Button'
+      expect(browser.button(index: 3).text).to eq 'Preview'
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      expect { browser.button(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.button(index: 0)).to respond_to(:class_name)
+      expect(browser.button(index: 0)).to respond_to(:id)
+      expect(browser.button(index: 0)).to respond_to(:name)
+      expect(browser.button(index: 0)).to respond_to(:src)
+      expect(browser.button(index: 0)).to respond_to(:style)
+      expect(browser.button(index: 0)).to respond_to(:title)
+      expect(browser.button(index: 0)).to respond_to(:type)
+      expect(browser.button(index: 0)).to respond_to(:value)
+    end
+  end
+
+  # Access methods
+  describe "#enabled?" do
+    it "returns true if the button is enabled" do
+      expect(browser.button(name: 'new_user_submit')).to be_enabled
+    end
+
+    it "returns false if the button is disabled" do
+      expect(browser.button(name: 'new_user_submit_disabled')).to_not be_enabled
+    end
+
+    it "raises UnknownObjectException if the button doesn't exist" do
+      expect { browser.button(name: "no_such_name").enabled? }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#disabled?" do
+    it "returns false when button is enabled" do
+      expect(browser.button(name: 'new_user_submit')).to_not be_disabled
+    end
+
+    it "returns true when button is disabled" do
+      expect(browser.button(name: 'new_user_submit_disabled')).to be_disabled
+    end
+
+    it "raises UnknownObjectException if button does not exist" do
+      expect { browser.button(name: "no_such_name").disabled? }.to raise_unknown_object_exception
+    end
+  end
+
+  # Manipulation methods
+  describe "#click" do
+    it "clicks the button if it exists" do
+      browser.goto(WatirSpec.url_for("forms_with_input_elements.html"))
+      browser.button(id: 'delete_user_submit').click
+      Watir::Wait.until { !browser.url.include? 'forms_with_input_elements.html'}
+      expect(browser.text).to include("Semantic table")
+    end
+
+    it "fires events" do
+      browser.button(id: 'new_user_button').click
+      expect(browser.button(id: 'new_user_button').value).to eq 'new_value_set_by_onclick_event'
+    end
+
+    it "raises UnknownObjectException when clicking a button that doesn't exist" do
+      expect { browser.button(value: "no_such_value").click }.to raise_unknown_object_exception
+      expect { browser.button(id: "no_such_id").click }.to raise_unknown_object_exception
+    end
+
+    it "raises ObjectDisabledException when clicking a disabled button" do
+      expect { browser.button(value: "Disabled").click }.to raise_object_disabled_exception
+    end
+  end
+
+
+end