capybara 0.3.0 → 0.3.5

data/spec/dsl/has_field_spec.rb

@@ -0,0 +1,96 @@
+shared_examples_for "has_field" do  
+  describe '#has_field' do
+    before { @session.visit('/form') }
+
+    it "should be true if the field is on the page" do
+      @session.should have_field('Dog')
+      @session.should have_field('form_description')
+      @session.should have_field('Region')
+    end
+
+    it "should be false if the field is not on the page" do
+      @session.should_not have_field('Monkey')
+    end
+
+    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('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('Description', :with => 'Monkey')
+      end
+    end
+  end
+
+  describe '#has_no_field' do
+    before { @session.visit('/form') }
+
+    it "should be false if the field is on the page" do
+      @session.should_not have_no_field('Dog')
+      @session.should_not have_no_field('form_description')
+      @session.should_not have_no_field('Region')
+    end
+
+    it "should be true if the field is not on the page" do
+      @session.should have_no_field('Monkey')
+    end
+
+    context 'with value' do
+      it "should be flase 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('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('Description', :with => 'Monkey')
+      end
+    end
+  end
+
+  describe '#has_checked_field?' do
+    before { @session.visit('/form') }
+
+    it "should be true if a checked field is on the page" do
+      @session.should have_checked_field('gender_female')
+      @session.should have_checked_field('Hamster')
+    end
+
+    it "should be false if an unchecked field is on the page" do
+      @session.should_not have_checked_field('form_pets_cat')
+      @session.should_not have_checked_field('Male')
+    end
+
+    it "should be false if no field is on the page" do
+      @session.should_not have_checked_field('Does Not Exist')
+    end
+  end
+
+  describe '#has_unchecked_field?' do
+    before { @session.visit('/form') }
+
+    it "should be false if a checked field is on the page" do
+      @session.should_not have_unchecked_field('gender_female')
+      @session.should_not have_unchecked_field('Hamster')
+    end
+
+    it "should be true if an unchecked field is on the page" do
+      @session.should have_unchecked_field('form_pets_cat')
+      @session.should have_unchecked_field('Male')
+    end
+
+    it "should be false if no field is on the page" do
+      @session.should_not have_unchecked_field('Does Not Exist')
+    end
+  end
+end
+

data/spec/dsl/has_link_spec.rb

@@ -0,0 +1,33 @@
+shared_examples_for "has_link" do
+
+  describe '#has_link?' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it "should be true if the given link is on the page" do
+      @session.should have_link('foo')
+      @session.should have_link('awesome title')
+    end
+
+    it "should be false if the given link is not on the page" do
+      @session.should_not have_link('monkey')
+    end
+  end
+
+  describe '#has_no_link?' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it "should be false if the given link is on the page" do
+      @session.should_not have_no_link('foo')
+      @session.should_not have_no_link('awesome title')
+    end
+
+    it "should be true if the given link is not on the page" do
+      @session.should have_no_link('monkey')
+    end
+  end
+end
+

data/spec/dsl/has_xpath_spec.rb

@@ -1,115 +1,123 @@
-module HasXpathSpec
-  shared_examples_for "has_xpath" do  
-    describe '#has_xpath?' do
-      before do
-        @session.visit('/with_html')
-      end
+shared_examples_for "has_xpath" do  
+  describe '#has_xpath?' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it "should be true if the given selector is on the page" do
+      @session.should have_xpath("//p")
+      @session.should have_xpath("//p//a[@id='foo']")
+      @session.should have_xpath("//p[contains(.,'est')]")
+    end
+
+    it "should be false if the given selector is not on the page" do
+      @session.should_not have_xpath("//abbr")
+      @session.should_not have_xpath("//p//a[@id='doesnotexist']")
+      @session.should_not have_xpath("//p[contains(.,'thisstringisnotonpage')]")
+    end
 
-      it "should be true if the given selector is on the page" do
-        @session.should have_xpath("//p")
-        @session.should have_xpath("//p//a[@id='foo']")
-        @session.should have_xpath("//p[contains(.,'est')]")
+    it "should use xpath even if default selector is CSS" do
+      Capybara.default_selector = :css
+      @session.should_not have_xpath("//p//a[@id='doesnotexist']")
+    end
+
+    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']")
       end
+    end
 
-      it "should be false if the given selector is not on the page" do
-        @session.should_not have_xpath("//abbr")
-        @session.should_not have_xpath("//p//a[@id='doesnotexist']")
-        @session.should_not have_xpath("//p[contains(.,'thisstringisnotonpage')]")
+    context "with count" do
+      it "should be true if the content is on the page the given number of times" do
+        @session.should have_xpath("//p", :count => 3)
+        @session.should have_xpath("//p//a[@id='foo']", :count => 1)
+        @session.should have_xpath("//p[contains(.,'est')]", :count => 1)
       end
 
-      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']")
-        end
+      it "should be false if the content is on the page the given number of times" do
+        @session.should_not have_xpath("//p", :count => 6)
+        @session.should_not have_xpath("//p//a[@id='foo']", :count => 2)
+        @session.should_not have_xpath("//p[contains(.,'est')]", :count => 5)
       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_xpath("//p", :count => 3)
-          @session.should have_xpath("//p//a[@id='foo']", :count => 1)
-          @session.should have_xpath("//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_xpath("//p", :count => 6)
-          @session.should_not have_xpath("//p//a[@id='foo']", :count => 2)
-          @session.should_not have_xpath("//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_xpath("//abbr", :count => 2)
-          @session.should_not have_xpath("//p//a[@id='doesnotexist']", :count => 1)
-        end
+      it "should be false if the content isn't on the page at all" do
+        @session.should_not have_xpath("//abbr", :count => 2)
+        @session.should_not have_xpath("//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_xpath("//p//a", :text => "Redirect", :count => 1)
-          @session.should_not have_xpath("//p", :text => "Doesnotexist")
-        end
+    context "with text" do
+      it "should discard all matches where the given string is not contained" do
+        @session.should have_xpath("//p//a", :text => "Redirect", :count => 1)
+        @session.should_not have_xpath("//p", :text => "Doesnotexist")
+      end
 
-        it "should discard all matches where the given regexp is not matched" do
-          @session.should have_xpath("//p//a", :text => /re[dab]i/i, :count => 1)
-          @session.should_not have_xpath("//p//a", :text => /Red$/)
-        end
+      it "should discard all matches where the given regexp is not matched" do
+        @session.should have_xpath("//p//a", :text => /re[dab]i/i, :count => 1)
+        @session.should_not have_xpath("//p//a", :text => /Red$/)
       end
     end
+  end
 
-    describe '#has_no_xpath?' do
-      before do
-        @session.visit('/with_html')
-      end
+  describe '#has_no_xpath?' 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_xpath("//p")
+      @session.should_not have_no_xpath("//p//a[@id='foo']")
+      @session.should_not have_no_xpath("//p[contains(.,'est')]")
+    end
+
+    it "should be true if the given selector is not on the page" do
+      @session.should have_no_xpath("//abbr")
+      @session.should have_no_xpath("//p//a[@id='doesnotexist']")
+      @session.should have_no_xpath("//p[contains(.,'thisstringisnotonpage')]")
+    end
 
-      it "should be false if the given selector is on the page" do
-        @session.should_not have_no_xpath("//p")
-        @session.should_not have_no_xpath("//p//a[@id='foo']")
-        @session.should_not have_no_xpath("//p[contains(.,'est')]")
+    it "should use xpath even if default selector is CSS" do
+      Capybara.default_selector = :css
+      @session.should have_no_xpath("//p//a[@id='doesnotexist']")
+    end
+
+    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']")
       end
+    end
 
-      it "should be true if the given selector is not on the page" do
-        @session.should have_no_xpath("//abbr")
-        @session.should have_no_xpath("//p//a[@id='doesnotexist']")
-        @session.should have_no_xpath("//p[contains(.,'thisstringisnotonpage')]")
+    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_xpath("//p", :count => 3)
+        @session.should_not have_no_xpath("//p//a[@id='foo']", :count => 1)
+        @session.should_not have_no_xpath("//p[contains(.,'est')]", :count => 1)
       end
 
-      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']")
-        end
+      it "should be true if the content is on the page the wrong number of times" do
+        @session.should have_no_xpath("//p", :count => 6)
+        @session.should have_no_xpath("//p//a[@id='foo']", :count => 2)
+        @session.should have_no_xpath("//p[contains(.,'est')]", :count => 5)
       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_xpath("//p", :count => 3)
-          @session.should_not have_no_xpath("//p//a[@id='foo']", :count => 1)
-          @session.should_not have_no_xpath("//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_xpath("//p", :count => 6)
-          @session.should have_no_xpath("//p//a[@id='foo']", :count => 2)
-          @session.should have_no_xpath("//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_xpath("//abbr", :count => 2)
-          @session.should have_no_xpath("//p//a[@id='doesnotexist']", :count => 1)
-        end
+      it "should be true if the content isn't on the page at all" do
+        @session.should have_no_xpath("//abbr", :count => 2)
+        @session.should have_no_xpath("//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_xpath("//p//a", :text => "Redirect", :count => 1)
-          @session.should have_no_xpath("//p", :text => "Doesnotexist")
-        end
+    context "with text" do
+      it "should discard all matches where the given string is contained" do
+        @session.should_not have_no_xpath("//p//a", :text => "Redirect", :count => 1)
+        @session.should have_no_xpath("//p", :text => "Doesnotexist")
+      end
 
-        it "should discard all matches where the given regexp is matched" do
-          @session.should_not have_no_xpath("//p//a", :text => /re[dab]i/i, :count => 1)
-          @session.should have_no_xpath("//p//a", :text => /Red$/)
-        end
+      it "should discard all matches where the given regexp is matched" do
+        @session.should_not have_no_xpath("//p//a", :text => /re[dab]i/i, :count => 1)
+        @session.should have_no_xpath("//p//a", :text => /Red$/)
       end
     end
   end
-end  
+end

data/spec/dsl/locate_spec.rb

@@ -1,38 +1,59 @@
-module LocateSpec
-  shared_examples_for "locate" do
-    describe '#locate' do
-      before do
-        @session.visit('/with_html')
-      end
+shared_examples_for "locate" do
+  describe '#locate' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it "should find the first element using the given locator" do
+      @session.locate('//h1').text.should == 'This is a test'
+      @session.locate("//input[@id='test_field']")[:value].should == 'monkey'
+    end
 
+    context "with css selectors" do
       it "should find the first element using the given locator" do
-        @session.locate('//h1').text.should == 'This is a test'
-        @session.locate("//input[@id='test_field']")[:value].should == 'monkey'
+        @session.locate(:css, 'h1').text.should == 'This is a test'
+        @session.locate(:css, "input[id='test_field']")[:value].should == 'monkey'
       end
+    end
 
-      it "should raise ElementNotFound with specified fail message if nothing was found" do
-        running do
-          @session.locate('//div[@id="nosuchthing"]', 'arghh').should be_nil
-        end.should raise_error(Capybara::ElementNotFound, "arghh")
+    context "with xpath selectors" do
+      it "should find the first element using the given locator" do
+        @session.locate(:xpath, '//h1').text.should == 'This is a test'
+        @session.locate(:xpath, "//input[@id='test_field']")[:value].should == 'monkey'
       end
+    end
 
-      it "should accept an XPath instance and respect the order of paths" do
-        @session.visit('/form')
-        @xpath = Capybara::XPath.text_field('Name')
-        @session.locate(@xpath).value.should == 'John Smith'
+    context "with css as default selector" do
+      before { Capybara.default_selector = :css }
+      it "should find the first element using the given locator" do
+        @session.locate('h1').text.should == 'This is a test'
+        @session.locate("input[id='test_field']")[:value].should == 'monkey'
       end
+      after { Capybara.default_selector = :xpath }
+    end
+
+    it "should raise ElementNotFound with specified fail message if nothing was found" do
+      running do
+        @session.locate(:xpath, '//div[@id="nosuchthing"]', 'arghh').should be_nil
+      end.should raise_error(Capybara::ElementNotFound, "arghh")
+    end
+
+    it "should accept an XPath instance and respect the order of paths" do
+      @session.visit('/form')
+      @xpath = Capybara::XPath.text_field('Name')
+      @session.locate(@xpath).value.should == 'John Smith'
+    end
 
-      context "within a scope" do
-        before do
-          @session.visit('/with_scope')
-        end
+    context "within a scope" do
+      before do
+        @session.visit('/with_scope')
+      end
 
-        it "should find the first element using the given locator" do
-          @session.within(:xpath, "//div[@id='for_bar']") do
-            @session.locate('//li').text.should =~ /With Simple HTML/
-          end        
-        end
+      it "should find the first element using the given locator" do
+        @session.within(:xpath, "//div[@id='for_bar']") do
+          @session.locate('//li').text.should =~ /With Simple HTML/
+        end        
       end
     end
   end
-end  
+end

data/spec/dsl/select_spec.rb

@@ -1,27 +1,71 @@
-module SelectSpec
-  shared_examples_for "select" do
-    describe "#select" do
-      before do
-        @session.visit('/form')
+shared_examples_for "select" do
+  describe "#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
+
+    it "should return value of the selected option" do
+      @session.select("Miss", :from => 'Title')
+      @session.find_field('Title').value.should == 'Miss'
+    end
+
+    it "should select an option from a select box by id" do
+      @session.select("Finish", :from => 'form_locale')
+      @session.click_button('awesome')
+      extract_results(@session)['locale'].should == 'fi'
+    end
+
+    it "should select an option from a select box by label" do
+      @session.select("Finish", :from => 'Locale')
+      @session.click_button('awesome')
+      extract_results(@session)['locale'].should == 'fi'
+    end
+
+    it "should favour exact matches to option labels" do
+      @session.select("Mr", :from => 'Title')
+      @session.click_button('awesome')
+      extract_results(@session)['title'].should == 'Mr'
+    end
+
+    context "with a locator that doesn't exist" do
+      it "should raise an error" do
+        running { @session.select('foo', :from => 'does not exist') }.should raise_error(Capybara::ElementNotFound)
       end
+    end
 
-      it "should select an option from a select box by id" do
-        @session.select("Finish", :from => 'form_locale')
-        @session.click_button('awesome')
-        extract_results(@session)['locale'].should == 'fi'
+    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)
       end
+    end
 
-      it "should select an option from a select box by label" do
-        @session.select("Finish", :from => 'Locale')
+    context "with multiple select" do
+      it "should return an empty value" do
+        @session.find_field('Language').value.should == []
+      end
+
+      it "should return value of the selected options" do
+        @session.select("Ruby",       :from => 'Language')
+        @session.select("Javascript", :from => 'Language')
+        @session.find_field('Language').value.should include('Ruby', 'Javascript')
+      end
+
+      it "should select one option" do
+        @session.select("Ruby", :from => 'Language')
         @session.click_button('awesome')
-        extract_results(@session)['locale'].should == 'fi'
+        extract_results(@session)['languages'].should == ['Ruby']
       end
 
-      context "with a locator that doesn't exist" do
-        it "should raise an error" do
-          running { @session.select('foo', :from => 'does not exist') }.should raise_error(Capybara::ElementNotFound)
-        end
+      it "should select multiple options" do
+        @session.select("Ruby",       :from => 'Language')
+        @session.select("Javascript", :from => 'Language')
+        @session.click_button('awesome')
+        extract_results(@session)['languages'].should include('Ruby', 'Javascript')
       end
     end
   end
-end  
+end