caius-celerity 0.0.6.10 → 0.0.6.11

data/spec/pres_spec.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Pres" do
+
+  before :all do
+    @browser = Browser.new(BROWSER_OPTIONS)
+  end
+
+  before :each do
+    @browser.goto(HTML_DIR + "/non_control_elements.html")
+  end
+
+  describe "#length" do
+    it "returns the number of pres" do
+      @browser.pres.length.should == 7
+    end
+  end
+
+  describe "#[]" do
+    it "returns the pre at the given index" do
+      @browser.pres[2].id.should == "rspec"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through pres correctly" do
+      @browser.pres.each_with_index do |p, index|
+        p.name.should == @browser.pre(:index, index+1).name
+        p.id.should == @browser.pre(:index, index+1).id
+        p.value.should == @browser.pre(:index, index+1).value
+      end
+    end
+  end
+
+  after :all do
+    @browser.close
+  end
+
+end
+

data/spec/ps_spec.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Ps" do
+
+  before :all do
+    @browser = Browser.new(BROWSER_OPTIONS)
+  end
+
+  before :each do
+    @browser.goto(HTML_DIR + "/non_control_elements.html")
+  end
+
+  describe "#length" do
+    it "returns the number of ps" do
+      @browser.ps.length.should == 5
+    end
+  end
+
+  describe "#[]" do
+    it "returns the p at the given index" do
+      @browser.ps[1].id.should == "lead"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through ps correctly" do
+      @browser.ps.each_with_index do |p, index|
+        p.name.should == @browser.p(:index, index+1).name
+        p.id.should == @browser.p(:index, index+1).id
+        p.value.should == @browser.p(:index, index+1).value
+      end
+    end
+  end
+
+  after :all do
+    @browser.close
+  end
+
+end
+

data/spec/radio_spec.rb

@@ -0,0 +1,314 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Radio" 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 radio button exists" do
+      @browser.radio(:id, "new_user_newsletter_yes").should exist
+      @browser.radio(:id, /new_user_newsletter_yes/).should exist
+      @browser.radio(:name, "new_user_newsletter").should exist
+      @browser.radio(:name, /new_user_newsletter/).should exist
+      @browser.radio(:value, "yes").should exist
+      @browser.radio(:value, /yes/).should exist
+      # TODO: figure out what :text means for a radio button
+      # @browser.radio(:text, "yes").should exist
+      # @browser.radio(:text, /yes/).should exist
+      @browser.radio(:class, "huge").should exist
+      @browser.radio(:class, /huge/).should exist
+      @browser.radio(:index, 1).should exist
+      @browser.radio(:xpath, "//input[@id='new_user_newsletter_yes']").should exist
+    end
+
+    it "returns true if the element exists (default how = :name)" do
+      @browser.radio("new_user_newsletter").should exist
+    end
+
+    it "returns true if the radio button exists (search by name and value)" do
+      @browser.radio(:name, "new_user_newsletter", 'yes').should exist
+      @browser.radio(:xpath, "//input[@name='new_user_newsletter' and @value='yes']").set
+    end
+
+    it "returns false if the radio button does not exist" do
+      @browser.radio(:id, "no_such_id").should_not exist
+      @browser.radio(:id, /no_such_id/).should_not exist
+      @browser.radio(:name, "no_such_name").should_not exist
+      @browser.radio(:name, /no_such_name/).should_not exist
+      @browser.radio(:value, "no_such_value").should_not exist
+      @browser.radio(:value, /no_such_value/).should_not exist
+      @browser.radio(:text, "no_such_text").should_not exist
+      @browser.radio(:text, /no_such_text/).should_not exist
+      @browser.radio(:class, "no_such_class").should_not exist
+      @browser.radio(:class, /no_such_class/).should_not exist
+      @browser.radio(:index, 1337).should_not exist
+      @browser.radio(:xpath, "input[@id='no_such_id']").should_not exist
+    end
+
+    it "returns false if the radio button does not exist (search by name and value)" do
+      @browser.radio(:name, "new_user_newsletter", 'no_such_value').should_not exist
+      @browser.radio(:xpath, "//input[@name='new_user_newsletter' and @value='no_such_value']").should_not exist
+      @browser.radio(:name, "no_such_name", 'yes').should_not exist
+      @browser.radio(:xpath, "//input[@name='no_such_name' and @value='yes']").should_not exist
+    end
+
+    it "returns true for radios with a string value" do
+      @browser.radio(:name, 'new_user_newsletter', 'yes').should exist
+      @browser.radio(:name, 'new_user_newsletter', 'no').should exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      lambda { @browser.radio(:id, 3.14).exists? }.should raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      lambda { @browser.radio(: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 radio exists and has an attribute" do
+      @browser.radio(:id, "new_user_newsletter_yes").class_name.should == "huge"
+    end
+
+    it "returns an emptry string if the radio exists and the attribute doesn't" do
+      @browser.radio(:id, "new_user_newsletter_no").class_name.should == ""
+    end
+
+    it "raises UnknownObjectException if the radio doesn't exist" do
+      lambda { @browser.radio(:id, "no_such_id").class_name }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#id" do
+    it "returns the id attribute if the radio exists and has an attribute" do
+      @browser.radio(:index, 1).id.should == "new_user_newsletter_yes"
+    end
+
+    it "returns an emptry string if the radio exists and the attribute doesn't" do
+      @browser.radio(:index, 3).id.should == ""
+    end
+
+    it "raises UnknownObjectException if the radio doesn't exist" do
+      lambda { @browser.radio(:index, 1337).id }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#name" do
+    it "returns the name attribute if the radio exists" do
+      @browser.radio(:id, 'new_user_newsletter_yes').name.should == "new_user_newsletter"
+    end
+
+    it "returns an empty string if the radio exists and the attribute doesn't" do
+      @browser.radio(:id, 'new_user_newsletter_absolutely').name.should == ""
+    end
+
+    it "raises UnknownObjectException if the radio doesn't exist" do
+      lambda { @browser.radio(:index, 1337).name }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#title" do
+    it "returns the title attribute if the radio exists" do
+      @browser.radio(:id, "new_user_newsletter_no").title.should == "Traitor!"
+    end
+
+    it "returns an emptry string if the radio exists and the attribute doesn't" do
+      @browser.radio(:id, "new_user_newsletter_yes").title.should == ""
+    end
+
+    it "raises UnknownObjectException if the radio doesn't exist" do
+      lambda { @browser.radio(:index, 1337).title }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#type" do
+    it "returns the type attribute if the radio exists" do
+      @browser.radio(:index, 1).type.should == "radio"
+    end
+
+    it "raises UnknownObjectException if the radio doesn't exist" do
+      lambda { @browser.radio(:index, 1337).type }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#value" do
+    it "returns the value attribute if the radio exists" do
+      @browser.radio(:id, 'new_user_newsletter_yes').value.should == 'yes'
+    end
+
+    it "raises UnknownObjectException if the radio doesn't exist" do
+      lambda { @browser.radio(:index, 1337).value}.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      @browser.radio(:index, 1).should respond_to(:class_name)
+      @browser.radio(:index, 1).should respond_to(:id)
+      @browser.radio(:index, 1).should respond_to(:name)
+      @browser.radio(:index, 1).should respond_to(:title)
+      @browser.radio(:index, 1).should respond_to(:type)
+      @browser.radio(:index, 1).should respond_to(:value)
+    end
+  end
+
+
+
+  # Access methods
+  describe "#enabled?" do
+    it "returns true if the radio button is enabled" do
+      @browser.radio(:id, "new_user_newsletter_yes").should be_enabled
+      @browser.radio(:xpath, "//input[@id='new_user_newsletter_yes']").should be_enabled
+    end
+
+    it "returns false if the radio button is disabled" do
+      @browser.radio(:id, "new_user_newsletter_nah").should_not be_enabled
+      @browser.radio(:xpath,"//input[@id='new_user_newsletter_nah']").should_not be_enabled
+    end
+
+    it "raises UnknownObjectException if the radio button doesn't exist" do
+      lambda { @browser.radio(:id, "no_such_id").enabled?  }.should raise_error(UnknownObjectException)
+      lambda { @browser.radio(:xpath, "//input[@id='no_such_id']").enabled?  }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#disabled?" do
+    it "returns true if the radio is disabled" do
+      @browser.radio(:id, 'new_user_newsletter_nah').should be_disabled
+    end
+
+    it "returns false if the radio is enabled" do
+      @browser.radio(:id, 'new_user_newsletter_yes').should_not be_disabled
+    end
+
+    it "raises UnknownObjectException if the radio doesn't exist" do
+      lambda { @browser.radio(:index, 1337).disabled? }.should raise_error(UnknownObjectException)
+    end
+  end
+
+
+  # Manipulation methods
+  describe "#clear" do
+    it "clears the radio button if it is set" do
+      @browser.radio(:id, "new_user_newsletter_yes").clear
+      @browser.radio(:id, "new_user_newsletter_yes").should_not be_set
+    end
+
+    it "clears the radio button when found by :xpath" do
+      @browser.radio(:xpath, "//input[@id='new_user_newsletter_yes']").clear
+      @browser.radio(:xpath, "//input[@id='new_user_newsletter_yes']").should_not be_set
+    end
+
+    it "raises UnknownObjectException if the radio button doesn't exist" do
+      lambda { @browser.radio(:name, "no_such_id").clear }.should raise_error(UnknownObjectException)
+      lambda { @browser.radio(:xpath, "//input[@id='no_such_id']").clear  }.should raise_error(UnknownObjectException)
+    end
+
+    it "raises ObjectDisabledException if the radio is disabled" do
+      @browser.radio(:id, "new_user_newsletter_nah").should_not be_set
+      lambda { @browser.radio(:id, "new_user_newsletter_nah").clear }.should raise_error(ObjectDisabledException)
+      lambda { @browser.radio(:xpath, "//input[@id='new_user_newsletter_nah']").clear }.should raise_error(ObjectDisabledException)
+    end
+  end
+
+  describe "#set" do
+    it "sets the radio button" do
+      @browser.radio(:id, "new_user_newsletter_no").set
+      @browser.radio(:id, "new_user_newsletter_no").should be_set
+    end
+
+    it "sets the radio button when found by :xpath" do
+      @browser.radio(:xpath, "//input[@id='new_user_newsletter_no']").set
+      @browser.radio(:xpath, "//input[@id='new_user_newsletter_no']").should be_set
+    end
+
+    it "fires the onclick event" do
+      alerts = []
+      @browser.add_listener(:alert) { |_, msg| alerts << msg }
+
+      @browser.radio(:id, "new_user_newsletter_no").set
+      @browser.radio(:id, "new_user_newsletter_yes").set
+      alerts.should == ["clicked: new_user_newsletter_no", "clicked: new_user_newsletter_yes"]
+    end
+
+    it "fires the onchange event" do
+      alerts = []
+      @browser.add_listener(:alert) { |_, msg| alerts << msg }
+
+      @browser.radio(:value, 'certainly').set
+      alerts.should == ["changed: new_user_newsletter"]
+
+      @browser.radio(:value, 'certainly').set
+      alerts.should == ["changed: new_user_newsletter"] # no event fired here - didn't change
+
+      @browser.radio(:value, 'certainly').clear
+      alerts.should == ["changed: new_user_newsletter", "changed: new_user_newsletter"]
+    end
+
+    it "raises UnknownObjectException if the radio button doesn't exist" do
+      lambda { @browser.radio(:name, "no_such_name").set  }.should raise_error(UnknownObjectException)
+      lambda { @browser.radio(:xpath, "//input[@name='no_such_name']").set  }.should raise_error(UnknownObjectException)
+    end
+
+    it "raises ObjectDisabledException if the radio is disabled" do
+      lambda { @browser.radio(:id, "new_user_newsletter_nah").set  }.should raise_error(ObjectDisabledException)
+      lambda { @browser.radio(:xpath, "//input[@id='new_user_newsletter_nah']").set  }.should raise_error(ObjectDisabledException )
+    end
+  end
+
+
+  # Other
+  describe '#set?' do
+    it "returns true if the radio button is set" do
+      @browser.radio(:id, "new_user_newsletter_yes").should be_set
+    end
+
+    it "returns false if the radio button unset" do
+      @browser.radio(:id, "new_user_newsletter_no").should_not be_set
+    end
+
+    it "returns the state for radios with string values" do
+      @browser.radio(:name, "new_user_newsletter", 'no').should_not be_set
+      @browser.radio(:name, "new_user_newsletter", 'no').set
+      @browser.radio(:name, "new_user_newsletter", 'no').should be_set
+      @browser.radio(:name, "new_user_newsletter", 'no').clear
+      @browser.radio(:name, "new_user_newsletter", 'no').should_not be_set
+    end
+
+    it "raises UnknownObjectException if the radio button doesn't exist" do
+      lambda { @browser.radio(:id, "no_such_id").set?  }.should raise_error(UnknownObjectException)
+      lambda { @browser.radio(:xpath, "//input[@id='no_such_id']").set?  }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#get_state" do
+    it "returns true if the radio is set" do
+      @browser.radio(:id, "new_user_newsletter_yes").get_state.should be_true
+    end
+
+    it "returns false if the radio is unset" do
+      @browser.radio(:id, "new_user_newsletter_no").get_state.should be_false
+    end
+
+    it "raises UnknownObjectException if the radio doesn't exist" do
+      lambda { @browser.radio(:name, "no_such_name").get_state }.should raise_error(UnknownObjectException)
+      lambda { @browser.radio(:xpath, "//input[@name='no_such_name']").get_state }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  after :all do
+    @browser.close
+  end
+
+end
+

data/spec/radios_spec.rb

@@ -0,0 +1,42 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Radios" 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 radios" do
+      @browser.radios.length.should == 5
+    end
+  end
+
+  describe "#[]" do
+    it "returns the radio button at the given index" do
+      @browser.radios[1].id.should == "new_user_newsletter_yes"
+    end
+  end
+
+  describe "#each" do
+    it "iterates through radio buttons correctly" do
+      index = 1
+      @browser.radios.each do |r|
+        r.name.should == @browser.radio(:index, index).name
+        r.id.should ==  @browser.radio(:index, index).id
+        r.value.should == @browser.radio(:index, index).value
+        index += 1
+      end
+      @browser.radios.length.should == index - 1
+    end
+  end
+
+  after :all do
+    @browser.close
+  end
+
+end

data/spec/select_list_spec.rb

@@ -0,0 +1,320 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "SelectList" 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 select list exists" do
+      @browser.select_list(:id, 'new_user_country').should exist
+      @browser.select_list(:id, /new_user_country/).should exist
+      @browser.select_list(:name, 'new_user_country').should exist
+      @browser.select_list(:name, /new_user_country/).should exist
+      # TODO: check behaviour in Watir
+      # @browser.select_list(:value, 'Norway').should exist
+      # @browser.select_list(:value, /Norway/).should exist
+      @browser.select_list(:text, 'Norway').should exist
+      @browser.select_list(:text, /Norway/).should exist
+      @browser.select_list(:class, 'country').should exist
+      @browser.select_list(:class, /country/).should exist
+      @browser.select_list(:index, 1).should exist
+      @browser.select_list(:xpath, "//select[@id='new_user_country']").should exist
+    end
+
+    it "returns true if the element exists (default how = :name)" do
+      @browser.select_list("new_user_country").should exist
+    end
+
+    it "returns false if the select list doesn't exist" do
+      @browser.select_list(:id, 'no_such_id').should_not exist
+      @browser.select_list(:id, /no_such_id/).should_not exist
+      @browser.select_list(:name, 'no_such_name').should_not exist
+      @browser.select_list(:name, /no_such_name/).should_not exist
+      @browser.select_list(:value, 'no_such_value').should_not exist
+      @browser.select_list(:value, /no_such_value/).should_not exist
+      @browser.select_list(:text, 'no_such_text').should_not exist
+      @browser.select_list(:text, /no_such_text/).should_not exist
+      @browser.select_list(:class, 'no_such_class').should_not exist
+      @browser.select_list(:class, /no_such_class/).should_not exist
+      @browser.select_list(:index, 1337).should_not exist
+      @browser.select_list(:xpath, "//select[@id='no_such_id']").should_not exist
+    end
+
+    it "raises TypeError when 'what' argument is invalid" do
+      lambda { @browser.select_list(:id, 3.14).exists? }.should raise_error(TypeError)
+    end
+
+    it "raises MissingWayOfFindingObjectException when 'how' argument is invalid" do
+      lambda { @browser.select_list(: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 select list" do
+      @browser.select_list(:name, 'new_user_country').class_name.should == 'country'
+    end
+
+    it "raises UnknownObjectException if the select list doesn't exist" do
+      lambda { @browser.select_list(:name, 'no_such_name').class_name }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#id" do
+    it "returns the id of the element" do
+      @browser.select_list(:index, 1).id.should == "new_user_country"
+    end
+
+    it "raises UnknownObjectException if the select list doesn't exist" do
+      lambda { @browser.select_list(:index, 1337).id }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#name" do
+    it "returns the name of the element" do
+      @browser.select_list(:index, 1).name.should == "new_user_country"
+    end
+
+    it "raises UnknownObjectException if the select list doesn't exist" do
+      lambda { @browser.select_list(:index, 1337).name }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#type" do
+    it "returns the type of the element" do
+      @browser.select_list(:index, 1).type.should == "select-one"
+      @browser.select_list(:index, 2).type.should == "select-multiple"
+    end
+
+    it "raises UnknownObjectException if the select list doesn't exist" do
+      lambda { @browser.select_list(:index, 1337).type }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#value" do
+    it "returns the value of the selected option" do
+      @browser.select_list(:index, 1).value.should == "2"
+      @browser.select_list(:index, 1).select(/Sweden/)
+      @browser.select_list(:index, 1).value.should == "3"
+    end
+
+    it "raises UnknownObjectException if the select list doesn't exist" do
+      lambda { @browser.select_list(:index, 1337).value }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#respond_to?" do
+    it "returns true for all attribute methods" do
+      @browser.select_list(:index, 1).should respond_to(:class_name)
+      @browser.select_list(:index, 1).should respond_to(:id)
+      @browser.select_list(:index, 1).should respond_to(:name)
+      @browser.select_list(:index, 1).should respond_to(:type)
+      @browser.select_list(:index, 1).should respond_to(:value)
+    end
+  end
+
+
+  # Access methods
+  describe "#enabled?" do
+    it "returns true if the select list is enabled" do
+      @browser.select_list(:name, 'new_user_country').should be_enabled
+    end
+
+    it "returns false if the select list is disabled" do
+      @browser.select_list(:name, 'new_user_role').should_not be_enabled
+    end
+
+    it "raises UnknownObjectException if the select_list doesn't exist" do
+      lambda { @browser.select_list(:name, 'no_such_name').enabled? }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#disabled?" do
+    it "returns true if the select list is disabled" do
+      @browser.select_list(:index, 3).should be_disabled
+    end
+
+    it "returns false if the select list is enabled" do
+      @browser.select_list(:index, 1).should_not be_disabled
+    end
+
+    it "shoulds raise UnknownObjectException when the select list does not exist" do
+      lambda { @browser.select_list(:index, 1337).disabled? }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  # Other
+  describe "#option" do
+    it "returns an instance of Option" do
+      option = @browser.select_list(:name, "new_user_country").option(:text, "Denmark")
+      option.should be_instance_of(Option)
+      option.value.should == "1"
+    end
+  end
+
+  describe "#options" do
+    it "shoulds raise UnknownObjectException if the select list doesn't exist" do
+      lambda { @browser.select_list(:name, 'no_such_name').options }.should raise_error(UnknownObjectException)
+    end
+
+    it "returns all the options as an Array" do
+      @browser.select_list(:name, "new_user_country").options.should == ["Denmark" ,"Norway" , "Sweden" , "United Kingdom", "USA", "Germany"]
+    end
+  end
+
+  describe "#selected_options" do
+    it "shoulds raise UnknownObjectException if the select list doesn't exist" do
+      lambda { @browser.select_list(:name, 'no_such_name').selected_options }.should raise_error(UnknownObjectException)
+    end
+
+    it "gets the currently selected item(s)" do
+      @browser.select_list(:name, "new_user_country").selected_options.should == ["Norway"]
+      @browser.select_list(:name, "new_user_languages").selected_options.should == ["English", "Norwegian"]
+    end
+  end
+
+  describe "#clear" do
+    it "clears the selection when possible" do
+      @browser.select_list(:name, "new_user_languages").clear
+      @browser.select_list(:name, "new_user_languages").selected_options.should be_empty
+    end
+
+    it "does not clear selections when not possible" do
+      @browser.select_list(:name , "new_user_country").clear
+      @browser.select_list(:name, "new_user_country").selected_options.should == ["Norway"]
+    end
+
+    it "raises UnknownObjectException if the select list doesn't exist" do
+      lambda { @browser.select_list(:name, 'no_such_name').clear_selection }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#includes?" do
+    it "returns true if the given option exists" do
+      @browser.select_list(:name, 'new_user_country').includes?('Denmark').should be_true
+    end
+
+    it "returns false if the given option doesn't exist" do
+      @browser.select_list(:name, 'new_user_country').includes?('Ireland').should be_false
+    end
+  end
+
+  describe "#selected?" do
+    it "returns true if the given option is selected" do
+      @browser.select_list(:name, 'new_user_country').select('Denmark')
+      @browser.select_list(:name, 'new_user_country').selected?('Denmark').should be_true
+    end
+
+    it "returns false if the given option is not selected" do
+      @browser.select_list(:name, 'new_user_country').selected?('Sweden').should be_false
+    end
+
+    it "raises UnknonwObjectException if the option doesn't exist" do
+      lambda { @browser.select_list(:name, 'new_user_country').selected?('missing_option') }.should raise_error(UnknownObjectException)
+    end
+  end
+
+  describe "#select" do
+    it "selects the given item when given a String" do
+      @browser.select_list(:name, "new_user_country").select("Denmark")
+      @browser.select_list(:name, "new_user_country").selected_options.should == ["Denmark"]
+    end
+
+    it "selects options by label" do
+      @browser.select_list(:name, "new_user_country").select("Germany")
+      @browser.select_list(:name, "new_user_country").selected_options.should == ["Germany"]
+    end
+
+    it "selects the given item when given a Regexp" do
+      @browser.select_list(:name, "new_user_country").select(/Denmark/)
+      @browser.select_list(:name, "new_user_country").selected_options.should == ["Denmark"]
+    end
+
+    it "selects the given item when given an Xpath" do
+      @browser.select_list(:xpath, "//select[@name='new_user_country']").select("Denmark")
+      @browser.select_list(:xpath, "//select[@name='new_user_country']").selected_options.should == ["Denmark"]
+    end
+
+    it "selects multiple items using :name and a String" do
+      @browser.select_list(:name, "new_user_languages").clear_selection
+      @browser.select_list(:name, "new_user_languages").select("Danish")
+      @browser.select_list(:name, "new_user_languages").select("Swedish")
+      @browser.select_list(:name, "new_user_languages").selected_options.should == ["Danish", "Swedish"]
+    end
+
+    it "selects multiple items using :name and a Regexp" do
+      @browser.select_list(:name, "new_user_languages").clear_selection
+      @browser.select_list(:name, "new_user_languages").select(/ish/)
+      @browser.select_list(:name, "new_user_languages").selected_options.should == ["Danish", "English", "Swedish"]
+    end
+
+    it "selects multiple items using :xpath" do
+      @browser.select_list(:xpath, "//select[@name='new_user_languages']").clear_selection
+      @browser.select_list(:xpath, "//select[@name='new_user_languages']").select(/ish/)
+      @browser.select_list(:xpath, "//select[@name='new_user_languages']").selected_options.should == ["Danish", "English", "Swedish"]
+    end
+
+    it "selects empty options" do
+      @browser.select_list(:id, "delete_user_username").select("")
+      @browser.select_list(:id, "delete_user_username").selected_options.should == [""]
+    end
+
+    it "returns the value selected" do
+      @browser.select_list(:name, "new_user_languages").select("Danish").should == "Danish"
+    end
+
+    it "returns the first matching value if there are multiple matches" do
+      @browser.select_list(:name, "new_user_languages").select(/ish/).should == "Danish"
+    end
+
+    it "fires onchange event when selecting an item" do
+      alerts = []
+      @browser.add_listener(:alert) { |_, msg| alerts << msg }
+      @browser.select_list(:id, "new_user_languages").select("Danish")
+      alerts.should == ['changed language']
+    end
+
+    it "doesn't fire onchange event when selecting an already selected item" do
+      alerts = []
+      @browser.add_listener(:alert) { |_, msg| alerts << msg }
+
+      @browser.select_list(:id, "new_user_languages").clear_selection # removes the two pre-selected options
+      @browser.select_list(:id, "new_user_languages").select("English")
+      alerts.size.should == 3
+
+      @browser.select_list(:id, "new_user_languages").select("English")
+      alerts.size.should == 3
+    end
+
+    it "raises NoValueFoundException if the option doesn't exist" do
+      lambda { @browser.select_list(:name, "new_user_country").select("missing_option") }.should raise_error(NoValueFoundException)
+      lambda { @browser.select_list(:name, "new_user_country").select(/missing_option/) }.should raise_error(NoValueFoundException)
+    end
+  end
+
+  describe "#select_value" do
+    it "selects the given item" do
+      @browser.select_list(:name, "new_user_languages").clear_selection
+      @browser.select_list(:name, "new_user_languages").select("Swedish")
+      @browser.select_list(:name, "new_user_languages").selected_options.should == ["Swedish"]
+    end
+
+    it "raises NoValueFoundException if the option doesn't exist" do
+      lambda { @browser.select_list(:name, "new_user_languages").select_value("no_such_option") }.should raise_error(NoValueFoundException)
+      lambda { @browser.select_list(:name, "new_user_languages").select_value(/no_such_option/) }.should raise_error(NoValueFoundException)
+    end
+  end
+
+  after :all do
+    @browser.close
+  end
+
+end