capybara 1.1.4 → 2.0.0

data/lib/capybara/spec/session/click_button_spec.rb

@@ -1,277 +1,226 @@
-shared_examples_for "click_button" do
-  describe '#click_button' do
-    before do
-      @session.visit('/form')
-    end
+Capybara::SpecHelper.spec '#click_button' do
+  before do
+    @session.visit('/form')
+  end
 
-    context "with multiple values with the same name" do
-      it "should use the latest given value" do
-        @session.check('Terms of Use')
-        @session.click_button('awesome')
-        extract_results(@session)['terms_of_use'].should == '1'
-      end
+  it "should wait for asynchronous load", :requires => [:js] do
+    @session.visit('/with_js')
+    @session.click_link('Click me')
+    @session.click_button('New Here')
+  end
+
+  it "casts to string" do
+    @session.click_button(:'Relative Action')
+    @session.current_path.should == '/relative'
+    extract_results(@session)['relative'].should == 'Relative Action'
+  end
+
+  context "with multiple values with the same name" do
+    it "should use the latest given value" do
+      @session.check('Terms of Use')
+      @session.click_button('awesome')
+      extract_results(@session)['terms_of_use'].should == '1'
     end
+  end
 
-    context "with a form that has a relative url as an action" do
-      it "should post to the correct url" do
-        @session.click_button('Relative Action')
-        @session.current_path.should == '/relative'
-        extract_results(@session)['relative'].should == 'Relative Action'
-      end
+  context "with a form that has a relative url as an action" do
+    it "should post to the correct url" do
+      @session.click_button('Relative Action')
+      @session.current_path.should == '/relative'
+      extract_results(@session)['relative'].should == 'Relative Action'
     end
+  end
 
-    context "with a form that has no action specified" do
-      it "should post to the correct url" do
-        @session.click_button('No Action')
-        @session.current_path.should == '/form'
-        extract_results(@session)['no_action'].should == 'No Action'
-      end
+  context "with a form that has no action specified" do
+    it "should post to the correct url" do
+      @session.click_button('No Action')
+      @session.current_path.should == '/form'
+      extract_results(@session)['no_action'].should == 'No Action'
     end
-    
-    context "with value given on a submit button" do
-      context "on a form with HTML5 fields" do
-        before do
-          @session.click_button('html5_submit')
-          @results = extract_results(@session)
-        end
-
-        it "should serialise and submit search fields" do
-          @results['html5_search'].should == 'what are you looking for'
-        end
-
-        it "should serialise and submit email fields" do
-          @results['html5_email'].should == 'person@email.com'
-        end
-
-        it "should serialise and submit url fields" do
-          @results['html5_url'].should == 'http://www.example.com'
-        end
-
-        it "should serialise and submit tel fields" do
-          @results['html5_tel'].should == '911'
-        end
-
-        it "should serialise and submit color fields" do
-          @results['html5_color'].should == '#FFFFFF'
-        end
+  end
+
+  context "with value given on a submit button" do
+    context "on a form with HTML5 fields" do
+      before do
+        @session.click_button('html5_submit')
+        @results = extract_results(@session)
       end
 
-      context "on an HTML4 form" do
-        before do
-          @session.click_button('awesome')
-          @results = extract_results(@session)
-        end
-
-        it "should serialize and submit text fields" do
-          @results['first_name'].should == 'John'
-        end
-
-        it "should escape fields when submitting" do
-          @results['phone'].should == '+1 555 7021'
-        end
-
-        it "should serialize and submit password fields" do
-          @results['password'].should == 'seeekrit'
-        end
-
-        it "should serialize and submit hidden fields" do
-          @results['token'].should == '12345'
-        end
-
-        it "should not serialize fields from other forms" do
-          @results['middle_name'].should be_nil
-        end
-
-        it "should submit the button that was clicked, but not other buttons" do
-          @results['awesome'].should == 'awesome'
-          @results['crappy'].should be_nil
-        end
-
-        it "should serialize radio buttons" do
-          @results['gender'].should == 'female'
-        end
-
-        it "should serialize check boxes" do
-          @results['pets'].should include('dog', 'hamster')
-          @results['pets'].should_not include('cat')
-        end
-
-        it "should serialize text areas" do
-          @results['description'].should == 'Descriptive text goes here'
-        end
-
-        it "should serialize select tag with values" do
-          @results['locale'].should == 'en'
-        end
-
-        it "should serialize select tag without values" do
-          @results['region'].should == 'Norway'
-        end
-
-        it "should serialize first option for select tag with no selection" do
-          @results['city'].should == 'London'
-        end
-
-        it "should not serialize a select tag without options" do
-          @results['tendency'].should be_nil
-        end
-
-        it "should not submit disabled fields" do
-          @results['disabled_text_field'].should be_nil
-          @results['disabled_textarea'].should be_nil
-          @results['disabled_checkbox'].should be_nil
-          @results['disabled_radio'].should be_nil
-          @results['disabled_select'].should be_nil
-          @results['disabled_file'].should be_nil
-        end
+      it "should serialise and submit search fields" do
+        @results['html5_search'].should == 'what are you looking for'
       end
-    end
 
-    context "with id given on a submit button" do
-      it "should submit the associated form" do
-        @session.click_button('awe123')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should serialise and submit email fields" do
+        @results['html5_email'].should == 'person@email.com'
       end
 
-      it "should work with partial matches" do
-        @session.click_button('Go')
-        @session.body.should include('You landed')
+      it "should serialise and submit url fields" do
+        @results['html5_url'].should == 'http://www.example.com'
       end
-    end
-    
-    context "with title given on a submit button" do
-      it "should submit the associated form" do
-        @session.click_button('What an Awesome Button')
-        extract_results(@session)['first_name'].should == 'John'
+
+      it "should serialise and submit tel fields" do
+        @results['html5_tel'].should == '911'
       end
 
-      it "should work with partial matches" do
-        @session.click_button('What an Awesome')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should serialise and submit color fields" do
+        @results['html5_color'].should == '#FFFFFF'
       end
     end
 
-    context "with alt given on an image button" do
-      it "should submit the associated form" do
-        @session.click_button('oh hai thar')
-        extract_results(@session)['first_name'].should == 'John'
+    context "on an HTML4 form" do
+      before do
+        @session.click_button('awesome')
+        @results = extract_results(@session)
       end
 
-      it "should work with partial matches" do
-        @session.click_button('hai')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should serialize and submit text fields" do
+        @results['first_name'].should == 'John'
       end
-    end
 
-    context "with value given on an image button" do
-      it "should submit the associated form" do
-        @session.click_button('okay')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should escape fields when submitting" do
+        @results['phone'].should == '+1 555 7021'
       end
 
-      it "should work with partial matches" do
-        @session.click_button('kay')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should serialize and submit password fields" do
+        @results['password'].should == 'seeekrit'
       end
-    end
 
-    context "with id given on an image button" do
-      it "should submit the associated form" do
-        @session.click_button('okay556')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should serialize and submit hidden fields" do
+        @results['token'].should == '12345'
       end
-    end
 
-    context "with title given on an image button" do
-      it "should submit the associated form" do
-        @session.click_button('Okay 556 Image')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should not serialize fields from other forms" do
+        @results['middle_name'].should be_nil
       end
 
-      it "should work with partial matches" do
-        @session.click_button('Okay 556')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should submit the button that was clicked, but not other buttons" do
+        @results['awesome'].should == 'awesome'
+        @results['crappy'].should be_nil
       end
-    end
 
-    context "with text given on a button defined by <button> tag" do
-      it "should submit the associated form" do
-        @session.click_button('Click me')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should serialize radio buttons" do
+        @results['gender'].should == 'female'
       end
 
-      it "should work with partial matches" do
-        @session.click_button('Click')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should serialize check boxes" do
+        @results['pets'].should include('dog', 'hamster')
+        @results['pets'].should_not include('cat')
       end
 
-      it "should prefer exact matches over partial matches" do
-        @session.click_button('Just an input')
-        extract_results(@session)['button'].should == 'button_second'
+      it "should serialize text areas" do
+        @results['description'].should == 'Descriptive text goes here'
       end
-    end
 
-   context "with id given on a button defined by <button> tag" do
-      it "should submit the associated form" do
-        @session.click_button('click_me_123')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should serialize select tag with values" do
+        @results['locale'].should == 'en'
       end
 
-      it "should serialize and send GET forms" do
-        @session.visit('/form')
-        @session.click_button('med')
-        @results = extract_results(@session)
-        @results['middle_name'].should == 'Darren'
-        @results['foo'].should be_nil
+      it "should serialize select tag without values" do
+        @results['region'].should == 'Norway'
       end
-    end
 
-   context "with value given on a button defined by <button> tag" do
-      it "should submit the associated form" do
-        @session.click_button('click_me')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should serialize first option for select tag with no selection" do
+        @results['city'].should == 'London'
       end
 
-      it "should work with partial matches" do
-        @session.click_button('ck_me')
-        extract_results(@session)['first_name'].should == 'John'
+      it "should not serialize a select tag without options" do
+        @results['tendency'].should be_nil
       end
 
-      it "should prefer exact matches over partial matches" do
-        @session.click_button('Just a button')
-        extract_results(@session)['button'].should == 'Just a button'
+      it "should not submit disabled fields" do
+        @results['disabled_text_field'].should be_nil
+        @results['disabled_textarea'].should be_nil
+        @results['disabled_checkbox'].should be_nil
+        @results['disabled_radio'].should be_nil
+        @results['disabled_select'].should be_nil
+        @results['disabled_file'].should be_nil
       end
     end
+  end
 
-    context "with title given on a button defined by <button> tag" do
-      it "should submit the associated form" do
-        @session.click_button('Click Title button')
-        extract_results(@session)['first_name'].should == 'John'
-      end
+  context "with id given on a submit button" do
+    it "should submit the associated form" do
+      @session.click_button('awe123')
+      extract_results(@session)['first_name'].should == 'John'
+    end
 
-      it "should work with partial matches" do
-        @session.click_button('Click Title')
-        extract_results(@session)['first_name'].should == 'John'
-      end
+    it "should work with partial matches" do
+      @session.click_button('Go')
+      @session.should have_content('You landed')
     end
-    context "with a locator that doesn't exist" do
-      it "should raise an error" do
-        running do
-          @session.click_button('does not exist')
-        end.should raise_error(Capybara::ElementNotFound)
-      end
+  end
+
+  context "with title given on a submit button" do
+    it "should submit the associated form" do
+      @session.click_button('What an Awesome Button')
+      extract_results(@session)['first_name'].should == 'John'
     end
 
-    it "should serialize and send valueless buttons that were clicked" do
-      @session.click_button('No Value!')
-      @results = extract_results(@session)
-      @results['no_value'].should_not be_nil
+    it "should work with partial matches" do
+      @session.click_button('What an Awesome')
+      extract_results(@session)['first_name'].should == 'John'
     end
-    
-    it "should not send image buttons that were not clicked" do
-      @session.click_button('Click me!')
-      @results = extract_results(@session)
-      @results['okay'].should be_nil
+  end
+
+  context "with alt given on an image button" do
+    it "should submit the associated form" do
+      @session.click_button('oh hai thar')
+      extract_results(@session)['first_name'].should == 'John'
+    end
+
+    it "should work with partial matches" do
+      @session.click_button('hai')
+      extract_results(@session)['first_name'].should == 'John'
+    end
+  end
+
+  context "with value given on an image button" do
+    it "should submit the associated form" do
+      @session.click_button('okay')
+      extract_results(@session)['first_name'].should == 'John'
+    end
+
+    it "should work with partial matches" do
+      @session.click_button('kay')
+      extract_results(@session)['first_name'].should == 'John'
+    end
+  end
+
+  context "with id given on an image button" do
+    it "should submit the associated form" do
+      @session.click_button('okay556')
+      extract_results(@session)['first_name'].should == 'John'
+    end
+  end
+
+  context "with title given on an image button" do
+    it "should submit the associated form" do
+      @session.click_button('Okay 556 Image')
+      extract_results(@session)['first_name'].should == 'John'
+    end
+
+    it "should work with partial matches" do
+      @session.click_button('Okay 556')
+      extract_results(@session)['first_name'].should == 'John'
+    end
+  end
+
+  context "with text given on a button defined by <button> tag" do
+    it "should submit the associated form" do
+      @session.click_button('Click me')
+      extract_results(@session)['first_name'].should == 'John'
+    end
+
+    it "should work with partial matches" do
+      @session.click_button('Click')
+      extract_results(@session)['first_name'].should == 'John'
+    end
+  end
+
+ context "with id given on a button defined by <button> tag" do
+    it "should submit the associated form" do
+      @session.click_button('click_me_123')
+      extract_results(@session)['first_name'].should == 'John'
     end
 
     it "should serialize and send GET forms" do
@@ -281,24 +230,106 @@ shared_examples_for "click_button" do
       @results['middle_name'].should == 'Darren'
       @results['foo'].should be_nil
     end
+  end
 
-    it "should follow redirects" do
-      @session.click_button('Go FAR')
-      @session.current_url.should match(%r{/landed$})
-      @session.body.should include('You landed')
+ context "with value given on a button defined by <button> tag" do
+    it "should submit the associated form" do
+      @session.click_button('click_me')
+      extract_results(@session)['first_name'].should == 'John'
     end
 
-    it "should post pack to the same URL when no action given" do
-      @session.visit('/postback')
-      @session.click_button('With no action')
-      @session.body.should include('Postback')
+    it "should work with partial matches" do
+      @session.click_button('ck_me')
+      extract_results(@session)['first_name'].should == 'John'
+    end
+  end
+
+  context "with title given on a button defined by <button> tag" do
+    it "should submit the associated form" do
+      @session.click_button('Click Title button')
+      extract_results(@session)['first_name'].should == 'John'
     end
 
-    it "should post pack to the same URL when blank action given" do
-      @session.visit('/postback')
-      @session.click_button('With blank action')
-      @session.body.should include('Postback')
+    it "should work with partial matches" do
+      @session.click_button('Click Title')
+      extract_results(@session)['first_name'].should == 'John'
     end
   end
+  context "with a locator that doesn't exist" do
+    it "should raise an error" do
+      msg = "Unable to find button \"does not exist\""
+      expect do
+        @session.click_button('does not exist')
+      end.to raise_error(Capybara::ElementNotFound, msg)
+    end
+  end
+
+  it "should serialize and send valueless buttons that were clicked" do
+    @session.click_button('No Value!')
+    @results = extract_results(@session)
+    @results['no_value'].should_not be_nil
+  end
+
+  it "should not send image buttons that were not clicked" do
+    @session.click_button('Click me!')
+    @results = extract_results(@session)
+    @results['okay'].should be_nil
+  end
+
+  it "should serialize and send GET forms" do
+    @session.visit('/form')
+    @session.click_button('med')
+    @results = extract_results(@session)
+    @results['middle_name'].should == 'Darren'
+    @results['foo'].should be_nil
+  end
+
+  it "should follow redirects" do
+    @session.click_button('Go FAR')
+    @session.current_url.should match(%r{/landed$})
+    @session.should have_content('You landed')
+  end
+
+  it "should post pack to the same URL when no action given" do
+    @session.visit('/postback')
+    @session.click_button('With no action')
+    @session.should have_content('Postback')
+  end
+
+  it "should post pack to the same URL when blank action given" do
+    @session.visit('/postback')
+    @session.click_button('With blank action')
+    @session.should have_content('Postback')
+  end
+
+  it "ignores disabled buttons" do
+    expect do
+      @session.click_button('Disabled button')
+    end.to raise_error(Capybara::ElementNotFound)
+  end
+
+  it "should encode complex field names, like array[][value]" do
+    @session.visit('/form')
+    @session.fill_in('address1_city', :with =>'Paris')
+    @session.fill_in('address1_street', :with =>'CDG')
+    @session.fill_in('address1_street', :with =>'CDG')
+    @session.select("France", :from => 'address1_country')
 
+    @session.fill_in('address2_city', :with => 'Mikolaiv')
+    @session.fill_in('address2_street', :with => 'PGS')
+    @session.select("Ukraine", :from => 'address2_country')
+
+    @session.click_button "awesome"
+
+    addresses=extract_results(@session)["addresses"]
+    addresses.should have(2).addresses
+
+    addresses[0]["street"].should   == 'CDG'
+    addresses[0]["city"].should     == 'Paris'
+    addresses[0]["country"].should  == 'France'
+
+    addresses[1]["street"].should   == 'PGS'
+    addresses[1]["city"].should     == 'Mikolaiv'
+    addresses[1]["country"].should  == 'Ukraine'
+  end
 end

data/lib/capybara/spec/session/click_link_or_button_spec.rb

@@ -1,36 +1,47 @@
-shared_examples_for "click_link_or_button" do
-  describe '#click' do
-    it "should click on a link" do
-      @session.visit('/with_html')
-      @session.click_link_or_button('labore')
-      @session.body.should include('Bar')
-    end
+Capybara::SpecHelper.spec '#click_link_or_button' do
+  it "should click on a link" do
+    @session.visit('/with_html')
+    @session.click_link_or_button('labore')
+    @session.should have_content('Bar')
+  end
 
-    it "should click on a button" do
-      @session.visit('/form')
-      @session.click_link_or_button('awe123')
-      extract_results(@session)['first_name'].should == 'John'
-    end
+  it "should click on a button" do
+    @session.visit('/form')
+    @session.click_link_or_button('awe123')
+    extract_results(@session)['first_name'].should == 'John'
+  end
 
-    it "should click on a button with no type attribute" do
-      @session.visit('/form')
-      @session.click_link_or_button('no_type')
-      extract_results(@session)['first_name'].should == 'John'
-    end
+  it "should click on a button with no type attribute" do
+    @session.visit('/form')
+    @session.click_link_or_button('no_type')
+    extract_results(@session)['first_name'].should == 'John'
+  end
 
-    it "should be aliased as click_on" do
-      @session.visit('/form')
-      @session.click_on('awe123')
-      extract_results(@session)['first_name'].should == 'John'
-    end
+  it "should be aliased as click_on" do
+    @session.visit('/form')
+    @session.click_on('awe123')
+    extract_results(@session)['first_name'].should == 'John'
+  end
+
+  it "should wait for asynchronous load", :requires => [:js] do
+    @session.visit('/with_js')
+    @session.click_link('Click me')
+    @session.click_link_or_button('Has been clicked')
+  end
 
-    context "with a locator that doesn't exist" do
-      it "should raise an error" do
-        @session.visit('/with_html')
-        running do
-          @session.click_link_or_button('does not exist')
-        end.should raise_error(Capybara::ElementNotFound)
-      end
+  it "casts to string" do
+    @session.visit('/form')
+    @session.click_link_or_button(:'awe123')
+    extract_results(@session)['first_name'].should == 'John'
+  end
+
+  context "with a locator that doesn't exist" do
+    it "should raise an error" do
+      @session.visit('/with_html')
+      msg = "Unable to find link or button \"does not exist\""
+      expect do
+        @session.click_link_or_button('does not exist')
+      end.to raise_error(Capybara::ElementNotFound, msg)
     end
   end
 end