caius-celerity 0.0.6.10 → 0.0.6.11

data/spec/button_spec.rb

@@ -0,0 +1,244 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Button" do
+
+  before :all do
+    @browser = Browser.new(BROWSER_OPTIONS)
+  end
+
+  before :each do
+    @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+  end
+
+  # Exists method
+  describe "#exists?" do
+    it "returns true if the button exists" do
+      @browser.button(:id, "new_user_submit").should exist
+      @browser.button(:id, /new_user_submit/).should exist
+      @browser.button(:name, "new_user_reset").should exist
+      @browser.button(:name, /new_user_reset/).should exist
+      @browser.button(:value, "Button 2").should exist
+      @browser.button(:value, /Button 2/).should exist
+      @browser.button(:src, "images/button.jpg").should exist
+      @browser.button(:src, /button.jpg/).should exist
+      @browser.button(:text, "Button 2").should exist
+      @browser.button(:text, /Button 2/).should exist
+      @browser.button(:class, "image").should exist
+      @browser.button(:class, /image/).should exist
+      @browser.button(:index, 1).should exist
+      @browser.button(:xpath, "//input[@id='new_user_submit']").should exist
+    end
+
+    it "returns true if the button exists (how = :caption)" do
+      @browser.button(:caption, "Button 2").should exist
+      @browser.button(:caption, /Button 2/).should exist
+    end
+
+    it "returns true if the button exists (default how = :value)" do
+      @browser.button("Submit").should exist
+    end
+
+    it "returns false if the button doesn't exist" do
+      @browser.button(:id, "no_such_id").should_not exist
+      @browser.button(:id, /no_such_id/).should_not exist
+      @browser.button(:name, "no_such_name").should_not exist
+      @browser.button(:name, /no_such_name/).should_not exist
+      @browser.button(:value, "no_such_value").should_not exist
+      @browser.button(:value, /no_such_value/).should_not exist
+      @browser.button(:src, "no_such_src").should_not exist
+      @browser.button(:src, /no_such_src/).should_not exist
+      @browser.button(:text, "no_such_text").should_not exist
+      @browser.button(:text, /no_such_text/).should_not exist
+      @browser.button(:class, "no_such_class").should_not exist
+      @browser.button(:class, /no_such_class/).should_not exist
+      @browser.button(:index, 1337).should_not exist
+      @browser.button(:xpath, "//input[@id='no_such_id']").should_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      lambda { @browser.button(:id, 3.14).exists? }.should raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      lambda { @browser.button(:no_such_how, 'some_value').exists? }.should raise_error(MissingWayOfFindingObjectException)
+    end
+  end
+
+  # Attribute methods
+  describe "#class_name" do
+    it "returns the class name of the button" do
+      @browser.button(:name, "new_user_image").class_name.should == "image"
+    end
+
+    it "returns an empty string if the button has no class name" do
+      @browser.button(:name, "new_user_submit").class_name.should == ""
+    end
+  end
+
+  describe "#id" do
+    it "returns the id if the button exists" do
+      @browser.button(:index, 1).id.should == 'new_user_submit'
+      @browser.button(:index, 2).id.should == 'new_user_reset'
+      @browser.button(:index, 3).id.should == 'new_user_button'
+    end
+
+    it "raises UnknownObjectException if button does not exist" do
+      lambda { @browser.button(:index, 1337).id }.should raise_error(UnknownObjectException, 'Unable to locate Button, using :index and 1337')
+    end
+  end
+
+  describe "#name" do
+    it "returns the name if button exists" do
+      @browser.button(:index, 1).name.should == 'new_user_submit'
+      @browser.button(:index, 2).name.should == 'new_user_reset'
+      @browser.button(:index, 3).name.should == 'new_user_button'
+    end
+
+    it "raises UnknownObjectException if the button does not exist" do
+      lambda { @browser.button(:name, "no_such_name").name }.should raise_error(UnknownObjectException, 'Unable to locate Button, using :name and "no_such_name"')
+    end
+  end
+
+  describe "#src" do
+    it "returns the url for the button image" do
+      @browser.button(:name, "new_user_image").src.should == "images/button.jpg"
+    end
+
+    it "raises UnknownObjectException if the button does not exist" do
+      lambda { @browser.button(:name, "no_such_name").src }.should raise_error(UnknownObjectException, 'Unable to locate Button, using :name and "no_such_name"')
+    end
+  end
+
+  describe "#style" do
+    it "returns the style attribute if the button exists" do
+      @browser.button(:id, 'delete_user_submit').style.should == "border: 4px solid red;"
+    end
+
+    it "returns an empty string if the element exists and the attribute doesn't" do
+      @browser.button(:id, 'new_user_submit').style.should == ""
+    end
+
+    it "raises UnknownObjectException if the button does not exist" do
+      lambda { @browser.button(:name, "no_such_name").style }.should raise_error(UnknownObjectException, 'Unable to locate Button, using :name and "no_such_name"')
+    end
+  end
+
+  describe "#title" do
+    it "returns the title of the button" do
+      @browser.button(:index, 1).title.should == 'Submit the form'
+    end
+
+    it "returns an empty string for button without title" do
+      @browser.button(:index, 2).title.should == ''
+    end
+  end
+
+  describe "#type" do
+    it "returns the type if button exists" do
+      @browser.button(:index, 1).type.should == 'submit'
+      @browser.button(:index, 2).type.should == 'reset'
+      @browser.button(:index, 3).type.should == 'button'
+    end
+
+    it "raises UnknownObjectException if button does not exist" do
+      lambda { @browser.button(:name, "no_such_name").type }.should raise_error(UnknownObjectException, 'Unable to locate Button, using :name and "no_such_name"')
+    end
+  end
+
+  describe "#value" do
+    it "returns the value if button exists" do
+      @browser.button(:index, 1).value.should == 'Submit'
+      @browser.button(:index, 2).value.should == 'Reset'
+      @browser.button(:index, 3).value.should == 'Button'
+    end
+
+    it "raises UnknownObjectException if button does not exist" do
+      lambda { @browser.button(:name, "no_such_name").value }.should raise_error(UnknownObjectException, 'Unable to locate Button, using :name and "no_such_name"')
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      @browser.button(:index, 1).should respond_to(:class_name)
+      @browser.button(:index, 1).should respond_to(:id)
+      @browser.button(:index, 1).should respond_to(:name)
+      @browser.button(:index, 1).should respond_to(:src)
+      @browser.button(:index, 1).should respond_to(:style)
+      @browser.button(:index, 1).should respond_to(:title)
+      @browser.button(:index, 1).should respond_to(:type)
+      @browser.button(:index, 1).should respond_to(:value)
+    end
+  end
+
+  # Access methods
+  describe "#enabled?" do
+    it "returns true if the button is enabled" do
+      @browser.button(:name, 'new_user_submit').should be_enabled
+    end
+
+    it "returns false if the button is disabled" do
+      @browser.button(:name, 'new_user_submit_disabled').should_not be_enabled
+    end
+
+    it "raises UnknownObjectException if the button doesn't exist" do
+      lambda { @browser.button(:name, "no_such_name").enabled? }.should raise_error(UnknownObjectException, 'Unable to locate Button, using :name and "no_such_name"')
+    end
+  end
+
+  describe "#disabled?" do
+    it "returns false when button is enabled" do
+      @browser.button(:name, 'new_user_submit').should_not be_disabled
+    end
+
+    it "returns true when button is disabled" do
+      @browser.button(:name, 'new_user_submit_disabled').should be_disabled
+    end
+
+    it "raises UnknownObjectException if button does not exist" do
+      lambda { @browser.button(:name, "no_such_name").disabled? }.should raise_error(UnknownObjectException, 'Unable to locate Button, using :name and "no_such_name"')
+    end
+  end
+
+  # Celerity API
+  describe "#click_and_attach" do
+    it "returns a new browser instance with the popup page" do
+      b = @browser.button(:name, 'new_popup_window').click_and_attach
+      b.should_not == @browser
+      b.title.should == "Tables"
+      @browser.title.should == "Forms with input elements"
+    end
+
+    it "returns a new browser with same log_level as original" do
+      b = @browser.button(:name, 'new_popup_window').click_and_attach
+      b.should_not == @browser
+      b.log_level.should == @browser.log_level
+    end
+  end
+
+  # Manipulation methods
+  describe "#click" do
+    it "clicks the button if it exists" do
+      @browser.goto(TEST_HOST + "/forms_with_input_elements.html")
+      @browser.button(:id, 'new_user_submit').click
+      @browser.text.should include("You posted the following content:")
+    end
+
+    it "fires events" do
+      @browser.button(:id, 'new_user_button').click
+      @browser.button(:id, 'new_user_button').value.should == 'new_value_set_by_onclick_event'
+    end
+
+    it "raises UnknownObjectException when clicking a button that doesn't exist" do
+      lambda { @browser.button(:value, "no_such_value").click }.should raise_error(UnknownObjectException, 'Unable to locate Button, using :value and "no_such_value"')
+      lambda { @browser.button(:id, "no_such_id").click }.should raise_error(UnknownObjectException, 'Unable to locate Button, using :id and "no_such_id"')
+    end
+
+    it "raises ObjectDisabledException when clicking a disabled button" do
+      lambda { @browser.button(:value, "Disabled").click }.should raise_error(ObjectDisabledException)
+    end
+  end
+
+  after :all do
+    @browser.close
+  end
+end

data/spec/buttons_spec.rb

@@ -0,0 +1,51 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Buttons" do
+
+  before :all do
+    @browser = Browser.new(BROWSER_OPTIONS)
+  end
+
+  before :each do
+    @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+  end
+
+  describe "#length" do
+    it "returns the number of buttons" do
+      @browser.buttons.length.should == 8
+    end
+  end
+
+  describe "#[]" do
+    it "returns the button at the given index" do
+      @browser.buttons[1].title.should == "Submit the form"
+    end
+  end
+
+  describe "#first" do
+    it "returns the first element in the collection" do
+      @browser.buttons.first.value.should == @browser.buttons[1].value
+    end
+  end
+
+  describe "#last" do
+    it "returns the last element in the collection" do
+      @browser.buttons.last.value.should == @browser.buttons[0].value
+    end
+  end
+
+  describe "#each" do
+    it "iterates through buttons correctly" do
+      @browser.buttons.each_with_index do |b, index|
+        b.name.should == @browser.button(:index, index+1).name
+        b.id.should == @browser.button(:index, index+1).id
+        b.value.should == @browser.button(:index, index+1).value
+      end
+    end
+  end
+
+  after :all do
+    @browser.close
+  end
+
+end

data/spec/checkbox_spec.rb

@@ -0,0 +1,302 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "CheckBox" do
+
+  before :all do
+    @browser = Browser.new(BROWSER_OPTIONS)
+  end
+
+  before :each do
+    @browser.goto(HTML_DIR + "/forms_with_input_elements.html")
+  end
+
+
+  # Exists method
+
+  describe "#exists?" do
+    it "returns true if the checkbox button exists" do
+      @browser.checkbox(:id, "new_user_interests_books").should exist
+      @browser.checkbox(:id, /new_user_interests_books/).should exist
+      @browser.checkbox(:name, "new_user_interests").should exist
+      @browser.checkbox(:name, /new_user_interests/).should exist
+      @browser.checkbox(:value, "books").should exist
+      @browser.checkbox(:value, /books/).should exist
+      # not sure what :text is supposed to represent here
+      # @browser.checkbox(:text, "books").should exist
+      # @browser.checkbox(:text, /books/).should exist
+      @browser.checkbox(:class, "fun").should exist
+      @browser.checkbox(:class, /fun/).should exist
+      @browser.checkbox(:index, 1).should exist
+      @browser.checkbox(:xpath, "//input[@id='new_user_interests_books']").should exist
+    end
+
+    it "returns true if the element exists (default how = :name)" do
+      @browser.checkbox("new_user_interests").should exist
+    end
+
+    it "returns true if the checkbox button exists (search by name and value)" do
+      @browser.checkbox(:name, "new_user_interests", 'cars').should exist
+      @browser.checkbox(:xpath, "//input[@name='new_user_interests' and @value='cars']").set
+    end
+
+    it "returns false if the checkbox button does not exist" do
+      @browser.checkbox(:id, "no_such_id").should_not exist
+      @browser.checkbox(:id, /no_such_id/).should_not exist
+      @browser.checkbox(:name, "no_such_name").should_not exist
+      @browser.checkbox(:name, /no_such_name/).should_not exist
+      @browser.checkbox(:value, "no_such_value").should_not exist
+      @browser.checkbox(:value, /no_such_value/).should_not exist
+      @browser.checkbox(:text, "no_such_text").should_not exist
+      @browser.checkbox(:text, /no_such_text/).should_not exist
+      @browser.checkbox(:class, "no_such_class").should_not exist
+      @browser.checkbox(:class, /no_such_class/).should_not exist
+      @browser.checkbox(:index, 1337).should_not exist
+      @browser.checkbox(:xpath, "//input[@id='no_such_id']").should_not exist
+    end
+
+    it "returns false if the checkbox button does not exist (search by name and value)" do
+      @browser.checkbox(:name, "new_user_interests", 'no_such_value').should_not exist
+      @browser.checkbox(:xpath, "//input[@name='new_user_interests' and @value='no_such_value']").should_not exist
+      @browser.checkbox(:name, "no_such_name", 'cars').should_not exist
+      @browser.checkbox(:xpath, "//input[@name='no_such_name' and @value='cars']").should_not exist
+    end
+
+    it "returns true for checkboxs with a string value" do
+      @browser.checkbox(:name, 'new_user_interests', 'books').should exist
+      @browser.checkbox(:name, 'new_user_interests', 'cars').should exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      lambda { @browser.checkbox(:id, 3.14).exists? }.should raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      lambda { @browser.checkbox(:no_such_how, 'some_value').exists? }.should raise_error(MissingWayOfFindingObjectException)
+    end
+  end
+
+
+  # Attribute methods
+
+  describe "#class_name" do
+    it "returns the class name if the checkbox exists and has an attribute" do
+      @browser.checkbox(:id, "new_user_interests_dancing").class_name.should == "fun"
+    end
+
+    it "returns an emptry string if the checkbox exists and the attribute doesn't" do
+      @browser.checkbox(:id, "new_user_interests_books").class_name.should == ""
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @browser.checkbox(:id, "no_such_id").class_name }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#id" do
+    it "returns the id attribute if the checkbox exists and has an attribute" do
+      @browser.checkbox(:index, 1).id.should == "new_user_interests_books"
+    end
+
+    it "returns an emptry string if the checkbox exists and the attribute doesn't" do
+      @browser.checkbox(:index, 2).id.should == ""
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @browser.checkbox(:index, 1337).id }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#name" do
+    it "returns the name attribute if the checkbox exists" do
+      @browser.checkbox(:id, 'new_user_interests_books').name.should == "new_user_interests"
+    end
+
+    it "returns an empty string if the checkbox exists and the attribute doesn't" do
+      @browser.checkbox(:id, 'new_user_interests_food').name.should == ""
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @browser.checkbox(:index, 1337).name }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#title" do
+    it "returns the title attribute if the checkbox exists" do
+      @browser.checkbox(:id, "new_user_interests_dancing").title.should == "Dancing is fun!"
+    end
+
+    it "returns an emptry string if the checkbox exists and the attribute doesn't" do
+      @browser.checkbox(:id, "new_user_interests_books").title.should == ""
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @browser.checkbox(:index, 1337).title }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#type" do
+    it "returns the type attribute if the checkbox exists" do
+      @browser.checkbox(:index, 1).type.should == "checkbox"
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @browser.checkbox(:index, 1337).type }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#value" do
+    it "returns the value attribute if the checkbox exists" do
+      @browser.checkbox(:id, 'new_user_interests_books').value.should == 'books'
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @browser.checkbox(:index, 1337).value}.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      @browser.checkbox(:index, 1).should respond_to(:class_name)
+      @browser.checkbox(:index, 1).should respond_to(:id)
+      @browser.checkbox(:index, 1).should respond_to(:name)
+      @browser.checkbox(:index, 1).should respond_to(:title)
+      @browser.checkbox(:index, 1).should respond_to(:type)
+      @browser.checkbox(:index, 1).should respond_to(:value)
+    end
+  end
+
+  # Access methods
+
+  describe "#enabled?" do
+    it "returns true if the checkbox button is enabled" do
+      @browser.checkbox(:id, "new_user_interests_books").should be_enabled
+      @browser.checkbox(:xpath, "//input[@id='new_user_interests_books']").should be_enabled
+    end
+
+    it "returns false if the checkbox button is disabled" do
+      @browser.checkbox(:id, "new_user_interests_dentistry").should_not be_enabled
+      @browser.checkbox(:xpath,"//input[@id='new_user_interests_dentistry']").should_not be_enabled
+    end
+
+    it "raises UnknownObjectException if the checkbox button doesn't exist" do
+      lambda { @browser.checkbox(:id, "no_such_id").enabled?  }.should raise_error(UnknownObjectException)
+      lambda { @browser.checkbox(:xpath, "//input[@id='no_such_id']").enabled?  }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#disabled?" do
+    it "returns true if the checkbox is disabled" do
+      @browser.checkbox(:id, 'new_user_interests_dentistry').should be_disabled
+    end
+
+    it "returns false if the checkbox is enabled" do
+      @browser.checkbox(:id, 'new_user_interests_books').should_not be_disabled
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      lambda { @browser.checkbox(:index, 1337).disabled? }.should raise_error(UnknownObjectException)
+    end
+  end
+
+
+  # Manipulation methods
+
+  describe "#clear" do
+    it "raises ObjectDisabledException if the checkbox is disabled" do
+      @browser.checkbox(:id, "new_user_interests_dentistry").should_not be_set
+      lambda { @browser.checkbox(:id, "new_user_interests_dentistry").clear }.should raise_error(ObjectDisabledException)
+      lambda { @browser.checkbox(:xpath, "//input[@id='new_user_interests_dentistry']").clear }.should raise_error(ObjectDisabledException)
+    end
+
+    it "clears the checkbox button if it is set" do
+      @browser.checkbox(:id, "new_user_interests_books").clear
+      @browser.checkbox(:id, "new_user_interests_books").should_not be_set
+    end
+
+    it "clears the checkbox button when found by :xpath" do
+      @browser.checkbox(:xpath, "//input[@id='new_user_interests_books']").clear
+      @browser.checkbox(:xpath, "//input[@id='new_user_interests_books']").should_not be_set
+    end
+
+    it "raises UnknownObjectException if the checkbox button doesn't exist" do
+      lambda { @browser.checkbox(:name, "no_such_id").clear }.should raise_error(UnknownObjectException)
+      lambda { @browser.checkbox(:xpath, "//input[@id='no_such_id']").clear  }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#set" do
+    it "sets the checkbox button" do
+      @browser.checkbox(:id, "new_user_interests_cars").set
+      @browser.checkbox(:id, "new_user_interests_cars").should be_set
+    end
+
+    it "sets the checkbox button when found by :xpath" do
+      @browser.checkbox(:xpath, "//input[@id='new_user_interests_cars']").set
+      @browser.checkbox(:xpath, "//input[@id='new_user_interests_cars']").should be_set
+    end
+
+    it "fires the onclick event" do
+      @browser.button(:id, "disabled_button").should be_disabled
+      @browser.checkbox(:id, "toggle_button_checkbox").set
+      @browser.button(:id, "disabled_button").should_not be_disabled
+      @browser.checkbox(:id, "toggle_button_checkbox").clear
+      @browser.button(:id, "disabled_button").should be_disabled
+    end
+
+    it "raises UnknownObjectException if the checkbox button doesn't exist" do
+      lambda { @browser.checkbox(:name, "no_such_name").set  }.should raise_error(UnknownObjectException)
+      lambda { @browser.checkbox(:xpath, "//input[@name='no_such_name']").set  }.should raise_error(UnknownObjectException)
+    end
+
+    it "raises ObjectDisabledException if the checkbox is disabled" do
+      lambda { @browser.checkbox(:id, "new_user_interests_dentistry").set  }.should raise_error(ObjectDisabledException)
+      lambda { @browser.checkbox(:xpath, "//input[@id='new_user_interests_dentistry']").set  }.should raise_error(ObjectDisabledException )
+    end
+  end
+
+
+  # Other
+
+  describe '#set?' do
+    it "returns true if the checkbox button is set" do
+      @browser.checkbox(:id, "new_user_interests_books").should be_set
+    end
+
+    it "returns false if the checkbox button unset" do
+      @browser.checkbox(:id, "new_user_interests_cars").should_not be_set
+    end
+
+    it "returns the state for checkboxs with string values" do
+      @browser.checkbox(:name, "new_user_interests", 'cars').should_not be_set
+      @browser.checkbox(:name, "new_user_interests", 'cars').set
+      @browser.checkbox(:name, "new_user_interests", 'cars').should be_set
+      @browser.checkbox(:name, "new_user_interests", 'cars').clear
+      @browser.checkbox(:name, "new_user_interests", 'cars').should_not be_set
+    end
+
+    it "raises UnknownObjectException if the checkbox button doesn't exist" do
+      lambda { @browser.checkbox(:id, "no_such_id").set?  }.should raise_error(UnknownObjectException)
+      lambda { @browser.checkbox(:xpath, "//input[@id='no_such_id']").set?  }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#get_state" do
+    it "returns true if the checkbox is set" do
+      @browser.checkbox(:id, "new_user_interests_books").get_state.should be_true
+    end
+
+    it "returns false if the checkbox is unset" do
+      @browser.checkbox(:id, "new_user_interests_cars").get_state.should be_false
+    end
+
+    it "raises UnknownObjectException if the checkbox doesn't exist" do
+      lambda {   @browser.checkbox(:name, "no_such_name").get_state  }.should raise_error(UnknownObjectException)
+      lambda {   @browser.checkbox(:xpath, "//input[@name='no_such_name']").get_state  }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  after :all do
+    @browser.close
+  end
+end
+