capybara 0.3.9 → 0.4.0.rc

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

@@ -5,4 +5,11 @@ shared_examples_for "current_url" do
       @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/lib/capybara/spec/session/find_button_spec.rb

@@ -9,8 +9,10 @@ shared_examples_for "find_button" do
       @session.find_button('crap321').value.should == "crappy"
     end
 
-    it "should return nil if the field doesn't exist" do
-      @session.find_button('Does not exist').should be_nil
+    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

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

@@ -9,8 +9,10 @@ shared_examples_for "find_by_id" do
       @session.find_by_id('hidden_via_ancestor').tag_name.should == 'div'
     end
 
-    it "should return nil if no element with id is found" do
-      @session.find_by_id('nothing_with_this_id').should be_nil
+    it "should raise error if no element with id is found" do
+      running do
+        @session.find_by_id('nothing_with_this_id')
+      end.should raise_error(Capybara::ElementNotFound)
     end
   end
 end

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

@@ -10,13 +10,17 @@ shared_examples_for "find_field" do
       @session.find_field('Region')[:name].should == 'form[region]'
     end
 
-    it "should be nil if the field doesn't exist" do
-      @session.find_field('Does not exist').should be_nil
+    it "should raise error if the field doesn't exist" do
+      running do
+        @session.find_field('Does not exist')
+      end.should raise_error(Capybara::ElementNotFound)
     end
 
     it "should be aliased as 'field_labeled' for webrat compatibility" do
       @session.field_labeled('Dog').value.should == 'dog'
-      @session.field_labeled('Does not exist').should be_nil
+      running do
+        @session.field_labeled('Does not exist')
+      end.should raise_error(Capybara::ElementNotFound)
     end
   end
 end

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

@@ -7,11 +7,13 @@ shared_examples_for "find_link" do
 
     it "should find any field" do
       @session.find_link('foo').text.should == "ullamco"
-      @session.find_link('labore')[:href].should == "/with_simple_html"
+      @session.find_link('labore')[:href].should =~ %r(/with_simple_html$)
     end
 
-    it "should return nil if the field doesn't exist" do
-      @session.find_link('Does not exist').should be_nil
+    it "should raise error if the field doesn't exist" do
+      running do
+        @session.find_link('Does not exist')
+      end.should raise_error(Capybara::ElementNotFound)
     end
   end
 end

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

@@ -1,14 +1,45 @@
-shared_examples_for "find" do  
+shared_examples_for "find" do
   describe '#find' do
     before do
       @session.visit('/with_html')
     end
 
+    after do
+      Capybara::Selector.remove(:monkey)
+    end
+
     it "should find the first element using the given locator" do
       @session.find('//h1').text.should == 'This is a test'
       @session.find("//input[@id='test_field']")[:value].should == 'monkey'
     end
 
+    it "should be aliased as locate for backward compatibility" do
+      Capybara.should_receive(:deprecate).with("locate", "find").twice
+      @session.locate('//h1').text.should == 'This is a test'
+      @session.locate("//input[@id='test_field']")[:value].should == 'monkey'
+    end
+
+    it "should find the first element using the given locator and options" do
+      @session.find('//a', :text => 'Redirect')[:id].should == 'red'
+      @session.find(:css, 'a', :text => 'A link')[:title].should == 'twas a fine link'
+    end
+
+    describe 'the returned node' do
+      it "should act like a session object" do
+        @session.visit('/form')
+        @form = @session.find(:css, '#get-form')
+        @form.should have_field('Middle Name')
+        @form.should have_no_field('Languages')
+        @form.fill_in('Middle Name', :with => 'Monkey')
+        @form.click_button('med')
+        extract_results(@session)['middle_name'].should == 'Monkey'
+      end
+
+      it "should scope CSS selectors" do
+        @session.find(:css, '#second').should have_no_css('h1')
+      end
+    end
+
     context "with css selectors" do
       it "should find the first element using the given locator" do
         @session.find(:css, 'h1').text.should == 'This is a test'
@@ -16,6 +47,14 @@ shared_examples_for "find" do
       end
     end
 
+    context "with id selectors" do
+      it "should find the first element using the given locator" do
+        @session.find(:id, 'john_monkey').text.should == 'Monkey John'
+        @session.find(:id, 'red').text.should == 'Redirect'
+        @session.find(:red).text.should == 'Redirect'
+      end
+    end
+
     context "with xpath selectors" do
       it "should find the first element using the given locator" do
         @session.find(:xpath, '//h1').text.should == 'This is a test'
@@ -23,6 +62,24 @@ shared_examples_for "find" do
       end
     end
 
+    context "with custom selector" do
+      it "should use the custom selector" do
+        Capybara::Selector.add(:monkey) { |name| ".//*[@id='#{name}_monkey']" }
+        @session.find(:monkey, 'john').text.should == 'Monkey John'
+        @session.find(:monkey, 'paul').text.should == 'Monkey Paul'
+      end
+    end
+
+    context "with custom selector with :for option" do
+      it "should use the selector when it matches the :for option" do
+        Capybara::Selector.add(:monkey, :for => Fixnum) { |num| ".//*[contains(@id, 'monkey')][#{num}]" }
+        @session.find(:monkey, '2').text.should == 'Monkey Paul'
+        @session.find(1).text.should == 'Monkey John'
+        @session.find(2).text.should == 'Monkey Paul'
+        @session.find('//h1').text.should == 'This is a test'
+      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
@@ -32,13 +89,21 @@ shared_examples_for "find" do
       after { Capybara.default_selector = :xpath }
     end
 
-    it "should return nil when nothing was found" do
-      @session.find('//div[@id="nosuchthing"]').should be_nil
+    it "should raise ElementNotFound with specified fail message if nothing was found" do
+      running do
+        @session.find(:xpath, '//div[@id="nosuchthing"]', :message => 'arghh').should be_nil
+      end.should raise_error(Capybara::ElementNotFound, "arghh")
+    end
+
+    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
 
     it "should accept an XPath instance and respect the order of paths" do
       @session.visit('/form')
-      @xpath = Capybara::XPath.text_field('Name')
+      @xpath = XPath::HTML.fillable_field('Name')
       @session.find(@xpath).value.should == 'John Smith'
     end
 
@@ -49,8 +114,8 @@ shared_examples_for "find" do
 
       it "should find the first element using the given locator" do
         @session.within(:xpath, "//div[@id='for_bar']") do
-          @session.find('//li').text.should =~ /With Simple HTML/
-        end
+          @session.find('.//li').text.should =~ /With Simple HTML/
+        end        
       end
     end
   end

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

@@ -42,7 +42,7 @@ shared_examples_for "has_field" do
     end
 
     context 'with value' do
-      it "should be flase if a field with the given value is on the page" 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')  

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

@@ -0,0 +1,129 @@
+shared_examples_for "has_selector" do
+  describe '#has_selector?' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it "should be true if the given selector is on the page" do
+      @session.should have_selector(:xpath, "//p")
+      @session.should have_selector(:css, "p a#foo")
+      @session.should have_selector(:foo)
+      @session.should have_selector("//p[contains(.,'est')]")
+    end
+
+    it "should be false if the given selector is not on the page" do
+      @session.should_not have_selector(:xpath, "//abbr")
+      @session.should_not have_selector(:css, "p a#doesnotexist")
+      @session.should_not have_selector(:doesnotexist)
+      @session.should_not have_selector("//p[contains(.,'thisstringisnotonpage')]")
+    end
+
+    it "should use default selector" do
+      Capybara.default_selector = :css
+      @session.should_not have_selector("p a#doesnotexist")
+      @session.should have_selector("p a#foo")
+    end
+
+    it "should respect scopes" do
+      @session.within "//p[@id='first']" do
+        @session.should have_selector(".//a[@id='foo']")
+        @session.should_not have_selector(".//a[@id='red']")
+      end
+    end
+
+    context "with count" do
+      it "should be true if the content is on the page the given number of times" do
+        @session.should have_selector("//p", :count => 3)
+        @session.should have_selector("//p//a[@id='foo']", :count => 1)
+        @session.should have_selector("//p[contains(.,'est')]", :count => 1)
+      end
+
+      it "should be false if the content is on the page the given number of times" do
+        @session.should_not have_selector("//p", :count => 6)
+        @session.should_not have_selector("//p//a[@id='foo']", :count => 2)
+        @session.should_not have_selector("//p[contains(.,'est')]", :count => 5)
+      end
+
+      it "should be false if the content isn't on the page at all" do
+        @session.should_not have_selector("//abbr", :count => 2)
+        @session.should_not have_selector("//p//a[@id='doesnotexist']", :count => 1)
+      end
+    end
+
+    context "with text" do
+      it "should discard all matches where the given string is not contained" do
+        @session.should have_selector("//p//a", :text => "Redirect", :count => 1)
+        @session.should_not have_selector("//p", :text => "Doesnotexist")
+      end
+
+      it "should discard all matches where the given regexp is not matched" do
+        @session.should have_selector("//p//a", :text => /re[dab]i/i, :count => 1)
+        @session.should_not have_selector("//p//a", :text => /Red$/)
+      end
+    end
+  end
+
+  describe '#has_no_selector?' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it "should be false if the given selector is on the page" do
+      @session.should_not have_no_selector(:xpath, "//p")
+      @session.should_not have_no_selector(:css, "p a#foo")
+      @session.should_not have_no_selector(:foo)
+      @session.should_not have_no_selector("//p[contains(.,'est')]")
+    end
+
+    it "should be true if the given selector is not on the page" do
+      @session.should have_no_selector(:xpath, "//abbr")
+      @session.should have_no_selector(:css, "p a#doesnotexist")
+      @session.should have_no_selector(:doesnotexist)
+      @session.should have_no_selector("//p[contains(.,'thisstringisnotonpage')]")
+    end
+
+    it "should use default selector" do
+      Capybara.default_selector = :css
+      @session.should have_no_selector("p a#doesnotexist")
+      @session.should_not have_no_selector("p a#foo")
+    end
+
+    it "should respect scopes" do
+      @session.within "//p[@id='first']" do
+        @session.should_not have_no_selector(".//a[@id='foo']")
+        @session.should have_no_selector(".//a[@id='red']")
+      end
+    end
+
+    context "with count" do
+      it "should be false if the content is on the page the given number of times" do
+        @session.should_not have_no_selector("//p", :count => 3)
+        @session.should_not have_no_selector("//p//a[@id='foo']", :count => 1)
+        @session.should_not have_no_selector("//p[contains(.,'est')]", :count => 1)
+      end
+
+      it "should be true if the content is on the page the wrong number of times" do
+        @session.should have_no_selector("//p", :count => 6)
+        @session.should have_no_selector("//p//a[@id='foo']", :count => 2)
+        @session.should have_no_selector("//p[contains(.,'est')]", :count => 5)
+      end
+
+      it "should be true if the content isn't on the page at all" do
+        @session.should have_no_selector("//abbr", :count => 2)
+        @session.should have_no_selector("//p//a[@id='doesnotexist']", :count => 1)
+      end
+    end
+
+    context "with text" do
+      it "should discard all matches where the given string is contained" do
+        @session.should_not have_no_selector("//p//a", :text => "Redirect", :count => 1)
+        @session.should have_no_selector("//p", :text => "Doesnotexist")
+      end
+
+      it "should discard all matches where the given regexp is matched" do
+        @session.should_not have_no_selector("//p//a", :text => /re[dab]i/i, :count => 1)
+        @session.should have_no_selector("//p//a", :text => /Red$/)
+      end
+    end
+  end
+end

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

@@ -23,8 +23,8 @@ shared_examples_for "has_xpath" do
 
     it "should respect scopes" do
       @session.within "//p[@id='first']" do
-        @session.should have_xpath("//a[@id='foo']")
-        @session.should_not have_xpath("//a[@id='red']")
+        @session.should have_xpath(".//a[@id='foo']")
+        @session.should_not have_xpath(".//a[@id='red']")
       end
     end
 
@@ -84,8 +84,8 @@ shared_examples_for "has_xpath" do
 
     it "should respect scopes" do
       @session.within "//p[@id='first']" do
-        @session.should_not have_no_xpath("//a[@id='foo']")
-        @session.should have_no_xpath("//a[@id='red']")
+        @session.should_not have_no_xpath(".//a[@id='foo']")
+        @session.should have_no_xpath(".//a[@id='red']")
       end
     end
 

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

@@ -7,6 +7,26 @@ shared_examples_for "session with javascript support" do
     after do
       Capybara.default_wait_time = 0
     end
+
+    describe '#drag' do
+      it "should drag and drop an object" do
+        pending "drag/drop is currently broken under celerity/culerity" if @session.driver.is_a?(Capybara::Driver::Celerity)
+        @session.visit('/with_js')
+        @session.drag('//div[@id="drag"]', '//div[@id="drop"]')
+        @session.find('//div[contains(., "Dropped!")]').should_not be_nil
+      end
+    end
+
+    describe 'Node#drag_to' do
+      it "should drag and drop an object" do
+        pending "drag/drop is currently broken under celerity/culerity" if @session.driver.is_a?(Capybara::Driver::Celerity)
+        @session.visit('/with_js')
+        element = @session.find('//div[@id="drag"]')
+        target = @session.find('//div[@id="drop"]')
+        element.drag_to(target)
+        @session.find('//div[contains(., "Dropped!")]').should_not be_nil
+      end
+    end
     
     describe '#find' do
       it "should allow triggering of custom JS events" do
@@ -49,11 +69,11 @@ shared_examples_for "session with javascript support" do
       end
     end
 
-    describe '#locate' do
+    describe '#find' do
       it "should wait for asynchronous load" do
         @session.visit('/with_js')
         @session.click_link('Click me')
-        @session.locate("//a[contains(.,'Has been clicked')]")[:href].should == '#'
+        @session.find(:css, "a#has-been-clicked").text.should include('Has been clicked')
       end
     end
 
@@ -80,7 +100,7 @@ shared_examples_for "session with javascript support" do
         @session.visit('/with_html')
         Proc.new do
           @session.wait_until(0.1) do
-            @session.find('//div[@id="nosuchthing"]')
+            @session.all('//div[@id="nosuchthing"]').first
           end
         end.should raise_error(::Capybara::TimeoutError)
       end
@@ -109,11 +129,11 @@ shared_examples_for "session with javascript support" do
       end
     end
 
-    describe '#click' do
+    describe '#click_link_or_button' do
       it "should wait for asynchronous load" do
         @session.visit('/with_js')
         @session.click_link('Click me')
-        @session.click('Has been clicked')
+        @session.click_link_or_button('Has been clicked')
       end
     end
 

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

@@ -3,7 +3,7 @@ shared_examples_for "select" do
     before do
       @session.visit('/form')
     end
-    
+
     it "should return value of the first option" do
       @session.find_field('Title').value.should == 'Mrs'
     end
@@ -13,6 +13,10 @@ shared_examples_for "select" do
       @session.find_field('Title').value.should == 'Miss'
     end
 
+    it "should return the value attribute rather than content if present" do
+      @session.find_field('Locale').value.should == 'en'
+    end
+
     it "should select an option from a select box by id" do
       @session.select("Finish", :from => 'form_locale')
       @session.click_button('awesome')
@@ -25,6 +29,12 @@ shared_examples_for "select" do
       extract_results(@session)['locale'].should == 'fi'
     end
 
+    it "should select an option without giving a select box" do
+      @session.select("Mr")
+      @session.click_button('awesome')
+      extract_results(@session)['title'].should == 'Mr'
+    end
+
     it "should favour exact matches to option labels" do
       @session.select("Mr", :from => 'Title')
       @session.click_button('awesome')
@@ -59,7 +69,7 @@ shared_examples_for "select" do
 
     context "with an option that doesn't exist" do
       it "should raise an error" do
-        running { @session.select('Does not Exist', :from => 'form_locale') }.should raise_error(Capybara::OptionNotFound)
+        running { @session.select('Does not Exist', :from => 'form_locale') }.should raise_error(Capybara::ElementNotFound)
       end
     end
 
@@ -86,6 +96,10 @@ shared_examples_for "select" do
         @session.click_button('awesome')
         extract_results(@session)['languages'].should include('Ruby', 'Javascript')
       end
+      
+      it "should return value attribute rather than content if present" do
+        @session.find_field('Underwear').value.should include('thermal')
+      end
     end
   end
 end