capybara_minitest_spec 0.1.0

data/test_app/session/click_button_spec.rb

@@ -0,0 +1,304 @@
+shared_examples_for "click_button" do
+  describe '#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
+    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
+    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 "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
+      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'
+      end
+
+      it "should work with partial matches" do
+        @session.click_button('Go')
+        @session.body.should include('You landed')
+      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 work with partial matches" do
+        @session.click_button('What an Awesome')
+        extract_results(@session)['first_name'].should == 'John'
+      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'
+      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
+
+      it "should prefer exact matches over partial matches" do
+        @session.click_button('Just an input')
+        extract_results(@session)['button'].should == 'button_second'
+      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
+        @session.visit('/form')
+        @session.click_button('med')
+        @results = extract_results(@session)
+        @results['middle_name'].should == 'Darren'
+        @results['foo'].should be_nil
+      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'
+      end
+
+      it "should work with partial matches" do
+        @session.click_button('ck_me')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+
+      it "should prefer exact matches over partial matches" do
+        @session.click_button('Just a button')
+        extract_results(@session)['button'].should == 'Just a button'
+      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 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
+        running do
+          @session.click_button('does not exist')
+        end.should raise_error(Capybara::ElementNotFound)
+      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.body.should include('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.body.should include('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.body.should include('Postback')
+    end
+  end
+
+end

data/test_app/session/click_link_or_button_spec.rb

@@ -0,0 +1,36 @@
+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
+
+    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 be aliased as click_on" do
+      @session.visit('/form')
+      @session.click_on('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')
+        running do
+          @session.click_link_or_button('does not exist')
+        end.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+  end
+end

data/test_app/session/click_link_spec.rb

@@ -0,0 +1,119 @@
+shared_examples_for "click_link" do
+  describe '#click_link' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    context "with id given" do
+      it "should take user to the linked page" do
+        @session.click_link('foo')
+        @session.body.should include('Another World')
+      end
+    end
+
+    context "with text given" do
+      it "should take user to the linked page" do
+        @session.click_link('labore')
+        @session.body.should include('Bar')
+      end
+
+      it "should accept partial matches" do
+        @session.click_link('abo')
+        @session.body.should include('Bar')
+      end
+
+      it "should prefer exact matches over partial matches" do
+        @session.click_link('A link')
+        @session.body.should include('Bar')
+      end
+    end
+
+    context "with title given" do
+      it "should take user to the linked page" do
+        @session.click_link('awesome title')
+        @session.body.should include('Bar')
+      end
+
+      it "should accept partial matches" do
+        @session.click_link('some tit')
+        @session.body.should include('Bar')
+      end
+
+      it "should prefer exact matches over partial matches" do
+        @session.click_link('a fine link')
+        @session.body.should include('Bar')
+      end
+    end
+
+    context "with alternative text given to a contained image" do
+      it "should take user to the linked page" do
+        @session.click_link('awesome image')
+        @session.body.should include('Bar')
+      end
+
+      it "should take user to the linked page" do
+        @session.click_link('some imag')
+        @session.body.should include('Bar')
+      end
+
+      it "should prefer exact matches over partial matches" do
+        @session.click_link('fine image')
+        @session.body.should include('Bar')
+      end
+    end
+
+    context "with a locator that doesn't exist" do
+      it "should raise an error" do
+        running do
+          @session.click_link('does not exist')
+        end.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+
+    it "should follow relative links" do
+      @session.visit('/')
+      @session.click_link('Relative')
+      @session.body.should include('This is a test')
+    end
+
+    it "should follow redirects" do
+      @session.click_link('Redirect')
+      @session.body.should include('You landed')
+    end
+
+    it "should follow redirects" do
+      @session.click_link('BackToMyself')
+      @session.body.should include('This is a test')
+    end
+
+    it "should add query string to current URL with naked query string" do
+      @session.click_link('Naked Query String')
+      @session.body.should include('Query String sent')
+    end
+
+    it "should do nothing on anchor links" do
+      @session.fill_in("test_field", :with => 'blah')
+      @session.click_link('Anchor')
+      @session.find_field("test_field").value.should == 'blah'
+      @session.click_link('Blank Anchor')
+      @session.find_field("test_field").value.should == 'blah'
+    end
+
+    it "should do nothing on URL+anchor links for the same page" do
+      @session.fill_in("test_field", :with => 'blah')
+      @session.click_link('Anchor on same page')
+      @session.find_field("test_field").value.should == 'blah'
+    end
+
+    it "should follow link on URL+anchor links for a different page" do
+      @session.click_link('Anchor on different page')
+      @session.body.should include('Bar')
+    end
+
+    it "raise an error with links with no href" do
+      running do
+        @session.click_link('No Href')
+      end.should raise_error(Capybara::ElementNotFound)
+    end
+  end
+end

data/test_app/session/current_host_spec.rb

@@ -0,0 +1,68 @@
+shared_examples_for "current_host" do
+  after do
+    Capybara.app_host = nil
+  end
+
+  describe '#current_host' do
+    it "is affected by visiting a page directly" do
+      @session.visit('http://capybara-testapp.heroku.com/host')
+      @session.body.should include('Current host is http://capybara-testapp.heroku.com')
+      @session.current_host.should == 'http://capybara-testapp.heroku.com'
+    end
+
+    it "returns to the app host when visiting a relative url" do
+      Capybara.app_host = "http://capybara1.elabs.se"
+      @session.visit('http://capybara-testapp.heroku.com/host')
+      @session.body.should include('Current host is http://capybara-testapp.heroku.com')
+      @session.current_host.should == 'http://capybara-testapp.heroku.com'
+      @session.visit('/host')
+      @session.body.should include('Current host is http://capybara1.elabs.se')
+      @session.current_host.should == 'http://capybara1.elabs.se'
+    end
+
+    it "is affected by setting Capybara.app_host" do
+      Capybara.app_host = "http://capybara-testapp.heroku.com"
+      @session.visit('/host')
+      @session.body.should include('Current host is http://capybara-testapp.heroku.com')
+      @session.current_host.should == 'http://capybara-testapp.heroku.com'
+      Capybara.app_host = "http://capybara1.elabs.se"
+      @session.visit('/host')
+      @session.body.should include('Current host is http://capybara1.elabs.se')
+      @session.current_host.should == 'http://capybara1.elabs.se'
+    end
+
+    it "is unaffected by following a relative link" do
+      @session.visit('http://capybara-testapp.heroku.com/host_links')
+      @session.click_link('Relative Host')
+      @session.body.should include('Current host is http://capybara-testapp.heroku.com')
+      @session.current_host.should == 'http://capybara-testapp.heroku.com'
+    end
+
+    it "is affected by following an absolute link" do
+      @session.visit('http://capybara-testapp.heroku.com/host_links')
+      @session.click_link('Absolute Host')
+      @session.body.should include('Current host is http://capybara2.elabs.se')
+      @session.current_host.should == 'http://capybara2.elabs.se'
+    end
+
+    it "is unaffected by posting through a relative form" do
+      @session.visit('http://capybara-testapp.heroku.com/host_links')
+      @session.click_button('Relative Host')
+      @session.body.should include('Current host is http://capybara-testapp.heroku.com')
+      @session.current_host.should == 'http://capybara-testapp.heroku.com'
+    end
+
+    it "is affected by posting through an absolute form" do
+      @session.visit('http://capybara-testapp.heroku.com/host_links')
+      @session.click_button('Absolute Host')
+      @session.body.should include('Current host is http://capybara2.elabs.se')
+      @session.current_host.should == 'http://capybara2.elabs.se'
+    end
+
+    it "is affected by following a redirect" do
+      @session.visit('http://capybara-testapp.heroku.com/redirect_secure')
+      @session.body.should include('Current host is https://capybara-testapp.heroku.com')
+      @session.current_host.should == 'https://capybara-testapp.heroku.com'
+    end
+  end
+end

data/test_app/session/current_url_spec.rb

@@ -0,0 +1,15 @@
+shared_examples_for "current_url" do  
+  describe '#current_url' do
+    it "should return the current url" do
+      @session.visit('/form')
+      @session.current_url.should =~ %r(http://[^/]+/form)
+    end
+  end
+
+  describe '#current_path' do
+    it 'should show the correct location' do
+      @session.visit('/foo')
+      @session.current_path.should == '/foo'
+    end
+  end
+end

data/test_app/session/fill_in_spec.rb

@@ -0,0 +1,125 @@
+shared_examples_for "fill_in" do
+  describe "#fill_in" do
+    before do
+      @session.visit('/form')
+    end
+
+    it "should fill in a text field by id" do
+      @session.fill_in('form_first_name', :with => 'Harry')
+      @session.click_button('awesome')
+      extract_results(@session)['first_name'].should == 'Harry'
+    end
+
+    it "should fill in a text field by name" do
+      @session.fill_in('form[last_name]', :with => 'Green')
+      @session.click_button('awesome')
+      extract_results(@session)['last_name'].should == 'Green'
+    end
+
+    it "should fill in a text field by label without for" do
+      @session.fill_in('Street', :with => 'Avenue Q')
+      @session.click_button('awesome')
+      extract_results(@session)['street'].should == 'Avenue Q'
+    end
+
+    it "should fill in a url field by label without for" do
+      @session.fill_in('Html5 Url', :with => 'http://www.avenueq.com')
+      @session.click_button('html5_submit')
+      extract_results(@session)['html5_url'].should == 'http://www.avenueq.com'
+    end
+
+    it "should favour exact label matches over partial matches" do
+      @session.fill_in('Name', :with => 'Harry Jones')
+      @session.click_button('awesome')
+      extract_results(@session)['name'].should == 'Harry Jones'
+    end
+
+    it "should fill in a textarea by id" do
+      @session.fill_in('form_description', :with => 'Texty text')
+      @session.click_button('awesome')
+      extract_results(@session)['description'].should == 'Texty text'
+    end
+
+    it "should fill in a textarea by label" do
+      @session.fill_in('Description', :with => 'Texty text')
+      @session.click_button('awesome')
+      extract_results(@session)['description'].should == 'Texty text'
+    end
+
+    it "should fill in a textarea by name" do
+      @session.fill_in('form[description]', :with => 'Texty text')
+      @session.click_button('awesome')
+      extract_results(@session)['description'].should == 'Texty text'
+    end
+
+    it "should fill in a password field by id" do
+      @session.fill_in('form_password', :with => 'supasikrit')
+      @session.click_button('awesome')
+      extract_results(@session)['password'].should == 'supasikrit'
+    end
+
+    it "should fill in a field with a custom type" do
+      @session.fill_in('Schmooo', :with => 'Schmooo is the game')
+      @session.click_button('awesome')
+      extract_results(@session)['schmooo'].should == 'Schmooo is the game'
+    end
+
+    it "should fill in a field without a type" do
+      @session.fill_in('Phone', :with => '+1 555 7022')
+      @session.click_button('awesome')
+      extract_results(@session)['phone'].should == '+1 555 7022'
+    end
+
+    it "should fill in a text field respecting its maxlength attribute" do
+      @session.fill_in('Zipcode', :with => '52071350')
+      @session.click_button('awesome')
+      extract_results(@session)['zipcode'].should == '52071'
+    end
+
+    it "should fill in a password field by name" do
+      @session.fill_in('form[password]', :with => 'supasikrit')
+      @session.click_button('awesome')
+      extract_results(@session)['password'].should == 'supasikrit'
+    end
+
+    it "should fill in a password field by label" do
+      @session.fill_in('Password', :with => 'supasikrit')
+      @session.click_button('awesome')
+      extract_results(@session)['password'].should == 'supasikrit'
+    end
+
+    it "should fill in a password field by name" do
+      @session.fill_in('form[password]', :with => 'supasikrit')
+      @session.click_button('awesome')
+      extract_results(@session)['password'].should == 'supasikrit'
+    end
+    
+    it "should prefer exact matches over partial matches" do
+      @session.fill_in('Name', :with => 'Ford Prefect')
+      @session.click_button('awesome')
+      extract_results(@session)['name'].should == 'Ford Prefect'
+    end
+    
+    it "should throw an exception if a hash containing 'with' is not provided" do
+      lambda{@session.fill_in 'Name', 'ignu'}.should raise_error
+    end
+    
+    context "with ignore_hidden_fields" do
+      before { Capybara.ignore_hidden_elements = true }
+      after  { Capybara.ignore_hidden_elements = false }
+      it "should not find a hidden field" do
+        running do
+          @session.fill_in('Super Secret', :with => '777')
+        end.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+
+    context "with a locator that doesn't exist" do
+      it "should raise an error" do
+        running do
+          @session.fill_in('does not exist', :with => 'Blah blah')
+        end.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+  end
+end

data/test_app/session/find_button_spec.rb

@@ -0,0 +1,18 @@
+shared_examples_for "find_button" do  
+  describe '#find_button' do
+    before do
+      @session.visit('/form')
+    end
+
+    it "should find any field" do
+      @session.find_button('med')[:id].should == "mediocre"
+      @session.find_button('crap321').value.should == "crappy"
+    end
+
+    it "should raise error if the field doesn't exist" do
+      running do
+        @session.find_button('Does not exist')
+      end.should raise_error(Capybara::ElementNotFound)
+    end
+  end
+end