bjeanes-capybara 0.3.1

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

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

data/spec/dsl/locate_spec.rb

@@ -0,0 +1,59 @@
+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(:css, 'h1').text.should == 'This is a test'
+        @session.locate(:css, "input[id='test_field']")[:value].should == 'monkey'
+      end
+    end
+
+    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
+
+    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
+
+      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

data/spec/dsl/select_spec.rb

@@ -0,0 +1,71 @@
+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
+
+    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
+
+    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)['languages'].should == ['Ruby']
+      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

data/spec/dsl/uncheck_spec.rb

@@ -0,0 +1,21 @@
+shared_examples_for "uncheck" do  
+  describe "#uncheck" do
+    before do
+      @session.visit('/form')
+    end
+
+    it "should uncheck a checkbox by id" do
+      @session.uncheck("form_pets_hamster")
+      @session.click_button('awesome')
+      extract_results(@session)['pets'].should include('dog')
+      extract_results(@session)['pets'].should_not include('hamster')
+    end
+
+    it "should uncheck a checkbox by label" do
+      @session.uncheck("Hamster")
+      @session.click_button('awesome')
+      extract_results(@session)['pets'].should include('dog')
+      extract_results(@session)['pets'].should_not include('hamster')
+    end
+  end
+end

data/spec/dsl/within_spec.rb

@@ -0,0 +1,153 @@
+shared_examples_for "within" do  
+  describe '#within' do
+    before do
+      @session.visit('/with_scope')
+    end
+
+    context "with CSS selector" do
+      it "should click links in the given scope" do
+        @session.within(:css, "ul li[contains('With Simple HTML')]") do
+          @session.click_link('Go')
+        end
+        @session.body.should include('Bar')
+      end
+    end
+
+    context "with XPath selector" do
+      it "should click links in the given scope" do
+        @session.within(:xpath, "//li[contains(.,'With Simple HTML')]") do
+          @session.click_link('Go')
+        end
+        @session.body.should include('Bar')
+      end
+    end
+
+    context "with the default selector" do
+      it "should use XPath" do
+        @session.within("//li[contains(., 'With Simple HTML')]") do
+          @session.click_link('Go')
+        end
+        @session.body.should include('Bar')
+      end
+    end
+
+    context "with the default selector set to CSS" do
+      before { Capybara.default_selector = :css } 
+      it "should use CSS" do
+        @session.within("ul li[contains('With Simple HTML')]") do
+          @session.click_link('Go')
+        end
+        @session.body.should include('Bar')
+      end
+      after { Capybara.default_selector = :xpath } 
+    end
+
+    context "with click_link" do
+      it "should click links in the given scope" do
+        @session.within("//li[contains(.,'With Simple HTML')]") do
+          @session.click_link('Go')
+        end
+        @session.body.should include('Bar')
+      end
+
+      context "with nested scopes" do
+        it "should respect the inner scope" do
+          @session.within("//div[@id='for_bar']") do
+            @session.within("//li[contains(.,'Bar')]") do
+              @session.click_link('Go')
+            end
+          end
+          @session.body.should include('Another World')
+        end
+
+        it "should respect the outer scope" do
+          @session.within("//div[@id='another_foo']") do
+            @session.within("//li[contains(.,'With Simple HTML')]") do
+              @session.click_link('Go')
+            end
+          end
+          @session.body.should include('Hello world')
+        end
+      end
+
+      it "should raise an error if the scope is not found on the page" do
+        running {
+          @session.within("//div[@id='doesnotexist']") do
+          end
+        }.should raise_error(Capybara::ElementNotFound)
+      end
+
+      it "should restore the scope when an error is raised" do
+        running {
+          @session.within("//div[@id='for_bar']") do
+            running {
+              running {
+                @session.within("//div[@id='doesnotexist']") do
+                end
+              }.should raise_error(Capybara::ElementNotFound)
+            }.should_not change { @session.has_xpath?("//div[@id='another_foo']") }.from(false)
+          end
+        }.should_not change { @session.has_xpath?("//div[@id='another_foo']") }.from(true)
+      end
+    end
+
+    context "with forms" do
+      it "should fill in a field and click a button" do
+        @session.within("//li[contains(.,'Bar')]") do
+          @session.click_button('Go')
+        end
+        extract_results(@session)['first_name'].should == 'Peter'
+        @session.visit('/with_scope')
+        @session.within("//li[contains(.,'Bar')]") do
+          @session.fill_in('First Name', :with => 'Dagobert')
+          @session.click_button('Go')
+        end
+        extract_results(@session)['first_name'].should == 'Dagobert'
+      end
+    end
+  end
+
+  describe '#within_fieldset' do
+    before do
+      @session.visit('/fieldsets')
+    end
+
+    it "should restrict scope to a fieldset given by id" do
+      @session.within_fieldset("villain_fieldset") do
+        @session.fill_in("Name", :with => 'Goldfinger')
+        @session.click_button("Create")
+      end
+      extract_results(@session)['villain_name'].should == 'Goldfinger'
+    end
+
+    it "should restrict scope to a fieldset given by legend" do
+      @session.within_fieldset("Villain") do
+        @session.fill_in("Name", :with => 'Goldfinger')
+        @session.click_button("Create")
+      end
+      extract_results(@session)['villain_name'].should == 'Goldfinger'
+    end
+  end
+
+  describe '#within_table' do
+    before do
+      @session.visit('/tables')
+    end
+
+    it "should restrict scope to a fieldset given by id" do
+      @session.within_table("girl_table") do
+        @session.fill_in("Name", :with => 'Christmas')
+        @session.click_button("Create")
+      end
+      extract_results(@session)['girl_name'].should == 'Christmas'
+    end
+
+    it "should restrict scope to a fieldset given by legend" do
+      @session.within_table("Villain") do
+        @session.fill_in("Name", :with => 'Quantum')
+        @session.click_button("Create")
+      end
+      extract_results(@session)['villain_name'].should == 'Quantum'
+    end
+  end
+end