capybara 0.4.1.2 → 1.0.0.beta1

data/lib/capybara/spec/public/test.js

@@ -25,9 +25,14 @@ $(function() {
     }, 500);
   });
   $('#with_focus_event').focus(function() {
-    $('body').append('<p id="focus_event_triggered">Focus Event triggered</p>')
+    $('body').append('<p id="focus_event_triggered">Focus Event triggered</p>');
   });
   $('#checkbox_with_event').click(function() {
-    $('body').append('<p id="checkbox_event_triggered">Checkbox event triggered</p>')
+    $('body').append('<p id="checkbox_event_triggered">Checkbox event triggered</p>');
+  });
+  $('#fire_ajax_request').click(function() {
+    $.ajax({url: "/slow_response", context: document.body, success: function() {
+      $('body').append('<p id="ajax_request_done">Ajax request done</p>');
+    }});
   });
 });

data/lib/capybara/spec/session.rb

@@ -9,13 +9,7 @@ shared_examples_for "session" do
   end
 
   after do
-    @session.reset!
-  end
-
-  describe '#app' do
-    it "should remember the application" do
-      @session.app.should == TestApp
-    end
+    @session.reset_session!
   end
 
   describe '#visit' do
@@ -34,6 +28,16 @@ shared_examples_for "session" do
     end
   end
 
+  describe '#html' do
+    it "should return the unmodified page body" do
+      # html and body should be aliased, but we can't just check for
+      # method(:html) == method(:body) because these shared examples get run
+      # against the DSL, which uses forwarding methods.  So we test behavior.
+      @session.visit('/')
+      @session.body.should include('Hello world!')
+    end
+  end
+
   describe '#source' do
     it "should return the unmodified page source" do
       @session.visit('/')
@@ -41,6 +45,44 @@ shared_examples_for "session" do
     end
   end
 
+  describe '#reset_session!' do
+    it "removes cookies" do
+      @session.visit('/set_cookie')
+      @session.visit('/get_cookie')
+      @session.body.should include('test_cookie')
+
+      @session.reset_session!
+      @session.visit('/get_cookie')
+      @session.body.should_not include('test_cookie')
+    end
+
+    it "resets current host" do
+      @session.visit('http://capybara-testapp.heroku.com')
+      @session.current_host.should == 'http://capybara-testapp.heroku.com'
+
+      @session.reset_session!
+      @session.current_host.should be_nil
+    end
+
+    it "resets current path" do
+      @session.visit('/with_html')
+      @session.current_path.should == '/with_html'
+
+      @session.reset_session!
+      @session.current_path.should be_nil
+    end
+
+    it "resets page body" do
+      @session.visit('/with_html')
+      @session.body.should include('This is a test')
+      @session.find('.//h1').text.should include('This is a test')
+
+      @session.reset_session!
+      @session.body.should_not include('This is a test')
+      @session.should have_no_selector('.//h1')
+    end
+  end
+
   it_should_behave_like "all"
   it_should_behave_like "first"
   it_should_behave_like "attach_file"
@@ -66,10 +108,12 @@ shared_examples_for "session" do
   it_should_behave_like "has_select"
   it_should_behave_like "has_table"
   it_should_behave_like "select"
+  it_should_behave_like "text"
   it_should_behave_like "uncheck"
   it_should_behave_like "unselect"
   it_should_behave_like "within"
   it_should_behave_like "current_url"
+  it_should_behave_like "current_host"
 
   it "should encode complex field names, like array[][value]" do
     @session.visit('/form')

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

@@ -2,6 +2,8 @@ shared_examples_for "attach_file" do
 
   describe "#attach_file" do
     before do
+      @test_file_path = File.expand_path('../fixtures/test_file.txt', File.dirname(__FILE__))
+      @test_jpg_file_path = File.expand_path('../fixtures/capybara.jpg', File.dirname(__FILE__))
       @session.visit('/form')
     end
 
@@ -20,11 +22,6 @@ shared_examples_for "attach_file" do
     end
 
     context "with multipart form" do
-      before do
-        @test_file_path = File.expand_path('../fixtures/test_file.txt', File.dirname(__FILE__))
-        @test_jpg_file_path = File.expand_path('../fixtures/capybara.jpg', File.dirname(__FILE__))
-      end
-
       it "should set a file path by id" do
         @session.attach_file "form_document", @test_file_path
         @session.click_button('Upload')
@@ -63,7 +60,13 @@ shared_examples_for "attach_file" do
 
     context "with a locator that doesn't exist" do
       it "should raise an error" do
-        running { @session.attach_file('does not exist', 'foo.txt') }.should raise_error(Capybara::ElementNotFound)
+        running { @session.attach_file('does not exist', @test_file_path) }.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+
+    context "with a path that doesn't exist" do
+      it "should raise an error" do
+        running { @session.attach_file('Image', '/no_such_file.png') }.should raise_error(Capybara::FileNotFound)
       end
     end
   end

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

@@ -123,6 +123,18 @@ shared_examples_for "click_button" do
       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')
@@ -154,6 +166,18 @@ shared_examples_for "click_button" do
       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')
@@ -203,6 +227,17 @@ shared_examples_for "click_button" do
       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

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

@@ -0,0 +1,62 @@
+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
+  end
+end

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

@@ -70,6 +70,12 @@ shared_examples_for "fill_in" do
       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')

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

@@ -79,6 +79,28 @@ shared_examples_for "find" do
       end
     end
 
+    context "with custom selector with failure_message option" do
+      it "should raise an error with the failure message if the element is not found" do
+        Capybara.add_selector(:monkey) do
+          xpath { |num| ".//*[contains(@id, 'monkey')][#{num}]" }
+          failure_message { |node, selector| node.all(".//*[contains(@id, 'monkey')]").map { |node| node.text }.sort.join(', ') }
+        end
+        running do
+          @session.find(:monkey, '14').text.should == 'Monkey Paul'
+        end.should raise_error(Capybara::ElementNotFound, "Monkey John, Monkey Paul")
+      end
+
+      it "should pass the selector as the second argument" do
+        Capybara.add_selector(:monkey) do
+          xpath { |num| ".//*[contains(@id, 'monkey')][#{num}]" }
+          failure_message { |node, selector| selector.name.to_s + ': ' + selector.locator + ' - ' + node.all(".//*[contains(@id, 'monkey')]").map { |node| node.text }.sort.join(', ') }
+        end
+        running do
+          @session.find(:monkey, '14').text.should == 'Monkey Paul'
+        end.should raise_error(Capybara::ElementNotFound, "monkey: 14 - Monkey John, Monkey Paul")
+      end
+    end
+
     context "with css as default selector" do
       before { Capybara.default_selector = :css }
       it "should find the first element using the given locator" do
@@ -97,7 +119,7 @@ shared_examples_for "find" do
     it "should raise ElementNotFound with a useful default message if nothing was found" do
       running do
         @session.find(:xpath, '//div[@id="nosuchthing"]').should be_nil
-      end.should raise_error(Capybara::ElementNotFound, "Unable to find '//div[@id=\"nosuchthing\"]'")
+      end.should raise_error(Capybara::ElementNotFound, "Unable to find xpath \"//div[@id=\\\"nosuchthing\\\"]\"")
     end
 
     it "should accept an XPath instance and respect the order of paths" do

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

@@ -44,19 +44,52 @@ shared_examples_for "first" do
 
     context "with visible filter" do
       after { Capybara.ignore_hidden_elements = false }
-      it "should only find visible nodes" do
-        @session.first(:css, "a.visibility").should_not be_visible
-        @session.first(:css, "a.visibility", :visible => true).should be_visible
+      it "should only find visible nodes if true given" do
+        @session.first(:css, "a#invisible").should_not be_nil
+        @session.first(:css, "a#invisible", :visible => true).should be_nil
         Capybara.ignore_hidden_elements = true
-        @session.first(:css, "a.visibility").should be_visible
+        @session.first(:css, "a#invisible").should be_nil
       end
 
-      it "should only find invisible nodes" do
+      it "should include invisible nodes if false given" do
         Capybara.ignore_hidden_elements = true
-        @session.first(:css, "a.visibility", :visible => false).should_not be_visible
+        @session.first(:css, "a#invisible", :visible => false).should_not be_nil
+        @session.first(:css, "a#invisible").should be_nil
       end
     end
 
+    context "with prefer visible elements" do
+      it "should find invisible elements if no visible element exists" do
+        @session.first(:css, 'a#invisible')[:id].should == 'invisible'
+      end
+
+      it "should prefer visible elements over invisible elements" do
+        @session.first(:css, 'a.visibility')[:id].should == 'visible'
+      end
+
+      it "should return the first invisible element if no visible elements exist" do
+        @session.first(:css, 'a.hidden')[:id].should == 'first_invisble'
+      end
+
+      it "find visible links normally" do
+        @session.first(:css, 'a#visible')[:id].should == 'visible'
+      end
+    end
+
+    context "without prefer visible elements" do
+      before { Capybara.prefer_visible_elements = false }
+
+      it "should find invisible elements if no visible element exists" do
+        @session.first(:css, 'a#invisible')[:id].should == 'invisible'
+      end
+
+      it "should not prefer visible elements over invisible elements" do
+        @session.first(:css, 'a.visibility')[:id].should == 'invisible'
+      end
+
+      after { Capybara.prefer_visible_elements = true }
+    end
+
     context "within a scope" do
       before do
         @session.visit('/with_scope')

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

@@ -54,6 +54,11 @@ shared_examples_for "has_css" do
         @session.should_not have_css("abbr", :count => 2)
         @session.should_not have_css("p a.doesnotexist", :count => 1)
       end
+
+      it "should coerce count to an integer" do
+        @session.should have_css("p", :count => "3")
+        @session.should have_css("p a#foo", :count => "1")
+      end
     end
 
     context "with maximum" do
@@ -72,6 +77,11 @@ shared_examples_for "has_css" do
         @session.should_not have_css("abbr", :maximum => 2)
         @session.should_not have_css("p a.doesnotexist", :maximum => 1)
       end
+
+      it "should coerce maximum to an integer" do
+        @session.should have_css("h2.head", :maximum => "5") # edge case
+        @session.should have_css("h2", :maximum => "10")
+      end
     end
 
     context "with minimum" do
@@ -90,6 +100,11 @@ shared_examples_for "has_css" do
         @session.should_not have_css("abbr", :minimum => 2)
         @session.should_not have_css("p a.doesnotexist", :minimum => 7)
       end
+
+      it "should coerce minimum to an integer" do
+        @session.should have_css("h2.head", :minimum => "5") # edge case
+        @session.should have_css("h2", :minimum => "3")
+      end
     end
 
     context "with text" do
@@ -160,6 +175,11 @@ shared_examples_for "has_css" do
         @session.should have_no_css("abbr", :count => 2)
         @session.should have_no_css("p a.doesnotexist", :count => 1)
       end
+
+      it "should coerce count to an integer" do
+        @session.should_not have_no_css("p", :count => "3")
+        @session.should_not have_no_css("p a#foo", :count => "1")
+      end
     end
 
     context "with maximum" do
@@ -178,6 +198,11 @@ shared_examples_for "has_css" do
         @session.should have_no_css("abbr", :maximum => 5)
         @session.should have_no_css("p a.doesnotexist", :maximum => 10)
       end
+
+      it "should coerce maximum to an integer" do
+        @session.should_not have_no_css("h2.head", :maximum => "5") # edge case
+        @session.should_not have_no_css("h2", :maximum => "10")
+      end
     end
 
     context "with minimum" do
@@ -196,6 +221,11 @@ shared_examples_for "has_css" do
         @session.should have_no_css("abbr", :minimum => 5)
         @session.should have_no_css("p a.doesnotexist", :minimum => 10)
       end
+
+      it "should coerce minimum to an integer" do
+        @session.should_not have_no_css("h2.head", :minimum => "4") # edge case
+        @session.should_not have_no_css("h2", :minimum => "3")
+      end
     end
 
     context "with text" do

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

@@ -1,4 +1,4 @@
-shared_examples_for "has_field" do  
+shared_examples_for "has_field" do
   describe '#has_field' do
     before { @session.visit('/form') }
 
@@ -14,15 +14,15 @@ shared_examples_for "has_field" do
 
     context 'with value' do
       it "should be true if a field with the given value is on the page" do
-        @session.should have_field('First Name', :with => 'John')  
-        @session.should have_field('Phone', :with => '+1 555 7021')  
-        @session.should have_field('Street', :with => 'Sesame street 66')  
+        @session.should have_field('First Name', :with => 'John')
+        @session.should have_field('Phone', :with => '+1 555 7021')
+        @session.should have_field('Street', :with => 'Sesame street 66')
         @session.should have_field('Description', :with => 'Descriptive text goes here')
       end
 
       it "should be false if the given field is not on the page" do
-        @session.should_not have_field('First Name', :with => 'Peter')  
-        @session.should_not have_field('Wrong Name', :with => 'John')  
+        @session.should_not have_field('First Name', :with => 'Peter')
+        @session.should_not have_field('Wrong Name', :with => 'John')
         @session.should_not have_field('Description', :with => 'Monkey')
       end
 
@@ -53,15 +53,15 @@ shared_examples_for "has_field" do
 
     context 'with value' do
       it "should be false if a field with the given value is on the page" do
-        @session.should_not have_no_field('First Name', :with => 'John')  
-        @session.should_not have_no_field('Phone', :with => '+1 555 7021')  
-        @session.should_not have_no_field('Street', :with => 'Sesame street 66')  
+        @session.should_not have_no_field('First Name', :with => 'John')
+        @session.should_not have_no_field('Phone', :with => '+1 555 7021')
+        @session.should_not have_no_field('Street', :with => 'Sesame street 66')
         @session.should_not have_no_field('Description', :with => 'Descriptive text goes here')
       end
 
       it "should be true if the given field is not on the page" do
-        @session.should have_no_field('First Name', :with => 'Peter')  
-        @session.should have_no_field('Wrong Name', :with => 'John')  
+        @session.should have_no_field('First Name', :with => 'Peter')
+        @session.should have_no_field('Wrong Name', :with => 'John')
         @session.should have_no_field('Description', :with => 'Monkey')
       end
 
@@ -115,6 +115,24 @@ shared_examples_for "has_field" do
     end
   end
 
+  describe '#has_no_checked_field?' do
+    before { @session.visit('/form') }
+
+    it "should be false if a checked field is on the page" do
+      @session.should_not have_no_checked_field('gender_female')
+      @session.should_not have_no_checked_field('Hamster')
+    end
+
+    it "should be true if an unchecked field is on the page" do
+      @session.should have_no_checked_field('form_pets_cat')
+      @session.should have_no_checked_field('Male')
+    end
+
+    it "should be true if no field is on the page" do
+      @session.should have_no_checked_field('Does Not Exist')
+    end
+  end
+
   describe '#has_unchecked_field?' do
     before { @session.visit('/form') }
 
@@ -152,5 +170,23 @@ shared_examples_for "has_field" do
       @session.should have_unchecked_field('gender_female')
     end
   end
+
+  describe '#has_no_unchecked_field?' do
+    before { @session.visit('/form') }
+
+    it "should be true if a checked field is on the page" do
+      @session.should have_no_unchecked_field('gender_female')
+      @session.should have_no_unchecked_field('Hamster')
+    end
+
+    it "should be false if an unchecked field is on the page" do
+      @session.should_not have_no_unchecked_field('form_pets_cat')
+      @session.should_not have_no_unchecked_field('Male')
+    end
+
+    it "should be true if no field is on the page" do
+      @session.should have_no_unchecked_field('Does Not Exist')
+    end
+  end
 end