watir 6.0.0.beta5 → 6.0.0

data/spec/watirspec/elements/buttons_spec.rb

@@ -0,0 +1,55 @@
+require "watirspec_helper"
+
+describe "Buttons" 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.buttons(name: "new_user_button").to_a).to eq [browser.button(name: "new_user_button")]
+    end
+  end
+
+  describe "#length" do
+    it "returns the number of buttons" do
+      expect(browser.buttons.length).to eq 9
+    end
+  end
+
+  describe "#[]" do
+    it "returns the button at the given index" do
+      expect(browser.buttons[0].title).to eq "Submit the form"
+    end
+  end
+
+  describe "#first" do
+    it "returns the first element in the collection" do
+      expect(browser.buttons.first.value).to eq browser.buttons[0].value
+    end
+  end
+
+  describe "#last" do
+    it "returns the last element in the collection" do
+      expect(browser.buttons.last.value).to eq browser.buttons[-1].value
+    end
+  end
+
+  describe "#each" do
+    it "iterates through buttons correctly" do
+      count = 0
+
+      browser.buttons.each_with_index do |b, index|
+        expect(b.name).to eq browser.button(index: index).name
+        expect(b.id).to eq browser.button(index: index).id
+        expect(b.value).to eq browser.button(index: index).value
+
+        count += 1
+      end
+
+      expect(count).to be > 0
+    end
+  end
+
+end

data/spec/watirspec/elements/checkbox_spec.rb

@@ -0,0 +1,279 @@
+require "watirspec_helper"
+
+describe "CheckBox" 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 checkbox button exists" do
+      expect(browser.checkbox(id: "new_user_interests_books")).to exist
+      expect(browser.checkbox(id: /new_user_interests_books/)).to exist
+      expect(browser.checkbox(name: "new_user_interests")).to exist
+      expect(browser.checkbox(name: /new_user_interests/)).to exist
+      expect(browser.checkbox(value: "books")).to exist
+      expect(browser.checkbox(value: /books/)).to exist
+      # not sure what :text is supposed to represent here
+      # browser.checkbox(text: "books").to exist
+      # browser.checkbox(text: /books/).to exist
+      expect(browser.checkbox(class: "fun")).to exist
+      expect(browser.checkbox(class: /fun/)).to exist
+      expect(browser.checkbox(index: 0)).to exist
+      expect(browser.checkbox(xpath: "//input[@id='new_user_interests_books']")).to exist
+    end
+
+    it "returns true if the checkbox button exists (search by name and value)" do
+      expect(browser.checkbox(name: "new_user_interests", value: 'cars')).to exist
+      browser.checkbox(xpath: "//input[@name='new_user_interests' and @value='cars']").set
+    end
+
+    it "returns the first checkbox if given no args" do
+      expect(browser.checkbox).to exist
+    end
+
+    it "returns false if the checkbox button does not exist" do
+      expect(browser.checkbox(id: "no_such_id")).to_not exist
+      expect(browser.checkbox(id: /no_such_id/)).to_not exist
+      expect(browser.checkbox(name: "no_such_name")).to_not exist
+      expect(browser.checkbox(name: /no_such_name/)).to_not exist
+      expect(browser.checkbox(value: "no_such_value")).to_not exist
+      expect(browser.checkbox(value: /no_such_value/)).to_not exist
+      expect(browser.checkbox(text: "no_such_text")).to_not exist
+      expect(browser.checkbox(text: /no_such_text/)).to_not exist
+      expect(browser.checkbox(class: "no_such_class")).to_not exist
+      expect(browser.checkbox(class: /no_such_class/)).to_not exist
+      expect(browser.checkbox(index: 1337)).to_not exist
+      expect(browser.checkbox(xpath: "//input[@id='no_such_id']")).to_not exist
+    end
+
+    it "returns false if the checkbox button does not exist (search by name and value)" do
+      expect(browser.checkbox(name: "new_user_interests", value: 'no_such_value')).to_not exist
+      expect(browser.checkbox(xpath: "//input[@name='new_user_interests' and @value='no_such_value']")).to_not exist
+      expect(browser.checkbox(name: "no_such_name", value: 'cars')).to_not exist
+      expect(browser.checkbox(xpath: "//input[@name='no_such_name' and @value='cars']")).to_not exist
+    end
+
+    it "returns true for checkboxes with a string value" do
+      expect(browser.checkbox(name: 'new_user_interests', value: 'books')).to exist
+      expect(browser.checkbox(name: 'new_user_interests', value: 'cars')).to exist
+    end
+
+    it "returns true for checkbox with upper case type" do
+      expect(browser.checkbox(id: "new_user_interests_draw")).to exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.checkbox(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.checkbox(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 if the checkbox exists and has an attribute" do
+      expect(browser.checkbox(id: "new_user_interests_dancing").class_name).to eq "fun"
+    end
+
+    it "returns an empty string if the checkbox exists and the attribute doesn't" do
+      expect(browser.checkbox(id: "new_user_interests_books").class_name).to eq ""
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(id: "no_such_id").class_name }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#id" do
+    it "returns the id attribute if the checkbox exists and has an attribute" do
+      expect(browser.checkbox(index: 0).id).to eq "new_user_interests_books"
+    end
+
+    it "returns an empty string if the checkbox exists and the attribute doesn't" do
+      expect(browser.checkbox(index: 1).id).to eq ""
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(index: 1337).id }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#name" do
+    it "returns the name attribute if the checkbox exists" do
+      expect(browser.checkbox(id: 'new_user_interests_books').name).to eq "new_user_interests"
+    end
+
+    it "returns an empty string if the checkbox exists and the attribute doesn't" do
+      expect(browser.checkbox(id: 'new_user_interests_food').name).to eq ""
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(index: 1337).name }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#title" do
+    it "returns the title attribute if the checkbox exists" do
+      expect(browser.checkbox(id: "new_user_interests_dancing").title).to eq "Dancing is fun!"
+    end
+
+    it "returns an empty string if the checkbox exists and the attribute doesn't" do
+      expect(browser.checkbox(id: "new_user_interests_books").title).to eq ""
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(index: 1337).title }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#type" do
+    it "returns the type attribute if the checkbox exists" do
+      expect(browser.checkbox(index: 0).type).to eq "checkbox"
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(index: 1337).type }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#value" do
+    it "returns the value attribute if the checkbox exists" do
+      expect(browser.checkbox(id: 'new_user_interests_books').value).to eq 'books'
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(index: 1337).value}.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      expect(browser.checkbox(index: 0)).to respond_to(:class_name)
+      expect(browser.checkbox(index: 0)).to respond_to(:id)
+      expect(browser.checkbox(index: 0)).to respond_to(:name)
+      expect(browser.checkbox(index: 0)).to respond_to(:title)
+      expect(browser.checkbox(index: 0)).to respond_to(:type)
+      expect(browser.checkbox(index: 0)).to respond_to(:value)
+    end
+  end
+
+  # Access methods
+
+  describe "#enabled?" do
+    it "returns true if the checkbox button is enabled" do
+      expect(browser.checkbox(id: "new_user_interests_books")).to be_enabled
+      expect(browser.checkbox(xpath: "//input[@id='new_user_interests_books']")).to be_enabled
+    end
+
+    it "returns false if the checkbox button is disabled" do
+      expect(browser.checkbox(id: "new_user_interests_dentistry")).to_not be_enabled
+      expect(browser.checkbox(:xpath,"//input[@id='new_user_interests_dentistry']")).to_not be_enabled
+    end
+
+    it "raises UnknownObjectException if the checkbox button doesn't exist" do
+      expect { browser.checkbox(id: "no_such_id").enabled?  }.to raise_unknown_object_exception
+      expect { browser.checkbox(xpath: "//input[@id='no_such_id']").enabled?  }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#disabled?" do
+    it "returns true if the checkbox is disabled" do
+      expect(browser.checkbox(id: 'new_user_interests_dentistry')).to be_disabled
+    end
+
+    it "returns false if the checkbox is enabled" do
+      expect(browser.checkbox(id: 'new_user_interests_books')).to_not be_disabled
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      expect { browser.checkbox(index: 1337).disabled? }.to raise_unknown_object_exception
+    end
+  end
+
+  # Manipulation methods
+
+  describe "#clear" do
+    it "raises ObjectDisabledException if the checkbox is disabled" do
+      expect(browser.checkbox(id: "new_user_interests_dentistry")).to_not be_set
+      expect { browser.checkbox(id: "new_user_interests_dentistry").clear }.to raise_object_disabled_exception
+      expect { browser.checkbox(xpath: "//input[@id='new_user_interests_dentistry']").clear }.to raise_object_disabled_exception
+    end
+
+    it "clears the checkbox button if it is set" do
+      browser.checkbox(id: "new_user_interests_books").clear
+      expect(browser.checkbox(id: "new_user_interests_books")).to_not be_set
+    end
+
+    it "clears the checkbox button when found by :xpath" do
+      browser.checkbox(xpath: "//input[@id='new_user_interests_books']").clear
+      expect(browser.checkbox(xpath: "//input[@id='new_user_interests_books']")).to_not be_set
+    end
+
+    it "raises UnknownObjectException if the checkbox button doesn't exist" do
+      expect { browser.checkbox(name: "no_such_id").clear }.to raise_unknown_object_exception
+      expect { browser.checkbox(xpath: "//input[@id='no_such_id']").clear  }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#set" do
+    it "sets the checkbox button" do
+      browser.checkbox(id: "new_user_interests_cars").set
+      expect(browser.checkbox(id: "new_user_interests_cars")).to be_set
+    end
+
+    it "sets the checkbox button when found by :xpath" do
+      browser.checkbox(xpath: "//input[@id='new_user_interests_cars']").set
+      expect(browser.checkbox(xpath: "//input[@id='new_user_interests_cars']")).to be_set
+    end
+
+    it "fires the onclick event" do
+      expect(browser.button(id: "disabled_button")).to be_disabled
+      browser.checkbox(id: "toggle_button_checkbox").set
+      expect(browser.button(id: "disabled_button")).to_not be_disabled
+      browser.checkbox(id: "toggle_button_checkbox").clear
+      expect(browser.button(id: "disabled_button")).to be_disabled
+    end
+
+    it "raises UnknownObjectException if the checkbox button doesn't exist" do
+      expect { browser.checkbox(name: "no_such_name").set  }.to raise_unknown_object_exception
+      expect { browser.checkbox(xpath: "//input[@name='no_such_name']").set  }.to raise_unknown_object_exception
+    end
+
+    it "raises ObjectDisabledException if the checkbox is disabled" do
+      expect { browser.checkbox(id: "new_user_interests_dentistry").set  }.to raise_object_disabled_exception
+      expect { browser.checkbox(xpath: "//input[@id='new_user_interests_dentistry']").set  }.to raise_object_disabled_exception
+    end
+  end
+
+  # Other
+
+  describe '#set?' do
+    it "returns true if the checkbox button is set" do
+      expect(browser.checkbox(id: "new_user_interests_books")).to be_set
+    end
+
+    it "returns false if the checkbox button unset" do
+      expect(browser.checkbox(id: "new_user_interests_cars")).to_not be_set
+    end
+
+    it "returns the state for checkboxes with string values" do
+      expect(browser.checkbox(name: "new_user_interests", value: 'cars')).to_not be_set
+      browser.checkbox(name: "new_user_interests", value: 'cars').set
+      expect(browser.checkbox(name: "new_user_interests", value: 'cars')).to be_set
+      browser.checkbox(name: "new_user_interests", value: 'cars').clear
+      expect(browser.checkbox(name: "new_user_interests", value: 'cars')).to_not be_set
+    end
+
+    it "raises UnknownObjectException if the checkbox button doesn't exist" do
+      expect { browser.checkbox(id: "no_such_id").set?  }.to raise_unknown_object_exception
+      expect { browser.checkbox(xpath: "//input[@id='no_such_id']").set?  }.to raise_unknown_object_exception
+    end
+  end
+
+end

data/spec/watirspec/elements/checkboxes_spec.rb

@@ -0,0 +1,44 @@
+require "watirspec_helper"
+
+describe "CheckBoxes" 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.checkboxes(value: "books").to_a).to eq [browser.checkbox(value: "books")]
+    end
+  end
+
+  describe "#length" do
+    it "returns the number of checkboxes" do
+      expect(browser.checkboxes.length).to eq 8
+    end
+  end
+
+  describe "#[]" do
+    it "returns the checkbox at the given index" do
+      expect(browser.checkboxes[0].id).to eq "new_user_interests_books"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through checkboxes correctly" do
+      count = 0
+
+      browser.checkboxes.each_with_index do |c, index|
+        expect(c).to be_instance_of(Watir::CheckBox)
+        expect(c.name).to eq browser.checkbox(index: index).name
+        expect(c.id).to eq browser.checkbox(index: index).id
+        expect(c.value).to eq browser.checkbox(index: index).value
+
+        count += 1
+      end
+
+      expect(count).to be > 0
+    end
+  end
+
+end

data/spec/watirspec/elements/collections_spec.rb

@@ -0,0 +1,16 @@
+require "watirspec_helper"
+
+describe "Collections" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("collections.html"))
+  end
+
+  it "returns inner elements of parent element having different html tag" do
+    expect(browser.span(id: "a_span").divs.size).to eq 2
+  end
+
+  it "returns inner elements of parent element having same html tag" do
+    expect(browser.span(id: "a_span").spans.size).to eq 2
+  end
+end

data/spec/watirspec/elements/dd_spec.rb

@@ -0,0 +1,126 @@
+require "watirspec_helper"
+
+describe "Dd" do
+
+  before :each do
+    browser.goto(WatirSpec.url_for("definition_lists.html"))
+  end
+
+  # Exists method
+  describe "#exists?" do
+    it "returns true if the element exists" do
+      expect(browser.dd(id: "someone")).to exist
+      expect(browser.dd(class: "name")).to exist
+      expect(browser.dd(xpath: "//dd[@id='someone']")).to exist
+      expect(browser.dd(index: 0)).to exist
+    end
+
+    it "returns the first dd if given no args" do
+      expect(browser.dd).to exist
+    end
+
+    it "returns false if the element does not exist" do
+      expect(browser.dd(id: "no_such_id")).to_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      expect { browser.dd(id: 3.14).exists? }.to raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      expect { browser.dd(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.dd(id: "someone").class_name).to eq "name"
+    end
+
+    it "returns an empty string if the element exists but the attribute doesn't" do
+      expect(browser.dd(id: "city").class_name).to eq ""
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      expect { browser.dd(id: "no_such_id").class_name }.to raise_unknown_object_exception
+      expect { browser.dd(title: "no_such_title").class_name }.to raise_unknown_object_exception
+      expect { browser.dd(index: 1337).class_name }.to raise_unknown_object_exception
+      expect { browser.dd(xpath: "//dd[@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.dd(class: 'name').id).to eq "someone"
+    end
+
+    it "returns an empty string if the element exists, but the attribute doesn't" do
+      expect(browser.dd(class: 'address').id).to eq ""
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      expect {browser.dd(id: "no_such_id").id }.to raise_unknown_object_exception
+      expect {browser.dd(title: "no_such_id").id }.to raise_unknown_object_exception
+      expect {browser.dd(index: 1337).id }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#title" do
+    it "returns the title of the element" do
+      expect(browser.dd(class: "name").title).to eq "someone"
+    end
+  end
+
+  describe "#text" do
+    it "returns the text of the element" do
+      expect(browser.dd(id: "someone").text).to eq "John Doe"
+    end
+
+    it "returns an empty string if the element exists but contains no text" do
+      expect(browser.dd(class: 'noop').text).to eq ""
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      expect { browser.dd(id: "no_such_id").text }.to raise_unknown_object_exception
+      expect { browser.dd(title: "no_such_title").text }.to raise_unknown_object_exception
+      expect { browser.dd(index: 1337).text }.to raise_unknown_object_exception
+      expect { browser.dd(xpath: "//dd[@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.dd(index: 0)).to respond_to(:id)
+      expect(browser.dd(index: 0)).to respond_to(:class_name)
+      expect(browser.dd(index: 0)).to respond_to(:style)
+      expect(browser.dd(index: 0)).to respond_to(:text)
+      expect(browser.dd(index: 0)).to respond_to(:title)
+    end
+  end
+
+  # Manipulation methods
+  describe "#click" do
+    it "fires events when clicked" do
+      expect(browser.dd(title: 'education').text).to_not eq 'changed'
+      browser.dd(title: 'education').click
+      expect(browser.dd(title: 'education').text).to eq 'changed'
+    end
+
+    it "raises UnknownObjectException if the element does not exist" do
+      expect { browser.dd(id: "no_such_id").click }.to raise_unknown_object_exception
+      expect { browser.dd(title: "no_such_title").click }.to raise_unknown_object_exception
+      expect { browser.dd(index: 1337).click }.to raise_unknown_object_exception
+      expect { browser.dd(xpath: "//dd[@id='no_such_id']").click }.to raise_unknown_object_exception
+    end
+  end
+
+  describe "#html" do
+    it "returns the HTML of the element" do
+      html = browser.dd(id: 'someone').html
+      expect(html).to match(/John Doe/m)
+      expect(html).to_not include('</body>')
+    end
+  end
+
+end