pr0d1r2-capybara 0.3.7

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

@@ -0,0 +1,19 @@
+shared_examples_for "session with headers support" do
+  describe '#response_headers' do
+    it "should return response headers" do
+      @session.visit('/with_simple_html')     
+      @session.response_headers['Content-Type'].should == 'text/html'
+    end
+  end
+end
+
+shared_examples_for "session without headers support" do
+  describe "#response_headers" do
+    before{ @session.visit('/with_simple_html') }
+    it "should raise an error" do
+      running {
+        @session.response_headers
+      }.should raise_error(Capybara::NotSupportedByDriverError)
+    end
+  end
+end

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

@@ -0,0 +1,204 @@
+shared_examples_for "session with javascript support" do
+  describe 'all JS specs' do
+    before do
+      Capybara.default_wait_time = 1
+    end
+
+    after do
+      Capybara.default_wait_time = 0
+    end
+    
+    describe '#find' do
+      it "should allow triggering of custom JS events" do
+        pending "cannot figure out how to do this with selenium" if @session.mode == :selenium
+        @session.visit('/with_js')
+        @session.find(:css, '#with_focus_event').trigger(:focus)
+        @session.should have_css('#focus_event_triggered')
+      end
+    end
+
+    describe '#body' do
+      it "should return the current state of the page" do
+        @session.visit('/with_js')
+        @session.body.should include('I changed it')
+        @session.body.should_not include('This is text')
+      end
+    end
+
+    describe '#source' do
+      it "should return the original, unmodified source of the page" do
+        pending "cannot figure out how to do this with selenium" if @session.mode == :selenium
+        @session.visit('/with_js')
+        @session.source.should include('This is text')
+        @session.source.should_not include('I changed it')
+      end
+    end
+
+    describe "#evaluate_script" do
+      it "should return the evaluated script" do
+        @session.visit('/with_js')
+        @session.evaluate_script("1+3").should == 4
+      end
+    end
+
+    describe '#locate' 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 == '#'
+      end
+    end
+
+    describe '#wait_until' do
+      before do
+        @default_timeout = Capybara.default_wait_time
+      end
+
+      after do
+        Capybara.default_wait_time = @default_wait_time
+      end
+
+      it "should wait for block to return true" do
+        @session.visit('/with_js')
+        @session.select('My Waiting Option', :from => 'waiter')
+        @session.evaluate_script('activeRequests == 1').should be_true
+        @session.wait_until do
+          @session.evaluate_script('activeRequests == 0')
+        end
+        @session.evaluate_script('activeRequests == 0').should be_true
+      end
+
+      it "should raise Capybara::TimeoutError if block doesn't return true within timeout" do
+        @session.visit('/with_html')
+        Proc.new do
+          @session.wait_until(0.1) do
+            @session.find('//div[@id="nosuchthing"]')
+          end
+        end.should raise_error(::Capybara::TimeoutError)
+      end
+
+      it "should accept custom timeout in seconds" do
+        start = Time.now
+        Capybara.default_wait_time = 5
+        begin
+          @session.wait_until(0.1) { false }
+        rescue Capybara::TimeoutError; end
+        (Time.now - start).should be_close(0.1, 0.1)
+      end
+
+      it "should default to Capybara.default_wait_time before timeout" do
+        @session.driver # init the driver to exclude init timing from test
+        start = Time.now
+        Capybara.default_wait_time = 0.2
+        begin
+          @session.wait_until { false }
+        rescue Capybara::TimeoutError; end
+        if @session.driver.has_shortcircuit_timeout?
+          (Time.now - start).should be_close(0, 0.1)
+        else
+          (Time.now - start).should be_close(0.2, 0.1)
+        end
+      end
+    end
+
+    describe '#click' do
+      it "should wait for asynchronous load" do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.click('Has been clicked')
+      end
+    end
+
+    describe '#click_link' do
+      it "should wait for asynchronous load" do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.click_link('Has been clicked')
+      end
+    end
+
+    describe '#click_button' do
+      it "should wait for asynchronous load" do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.click_button('New Here')
+      end
+    end
+
+    describe '#fill_in' do
+      it "should wait for asynchronous load" do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.fill_in('new_field', :with => 'Testing...')
+      end
+    end
+
+    describe '#check' do
+      it "should trigger associated events" do
+        @session.visit('/with_js')
+        @session.check('checkbox_with_event')
+        @session.should have_css('#checkbox_event_triggered');
+      end
+    end
+
+    describe '#has_xpath?' do
+      it "should wait for content to appear" do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.should have_xpath("//input[@type='submit' and @value='New Here']")
+      end
+    end
+
+    describe '#has_no_xpath?' do
+      it "should wait for content to disappear" do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.should have_no_xpath("//p[@id='change']")
+      end
+    end
+
+    describe '#has_css?' do
+      it "should wait for content to appear" do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.should have_css("input[type='submit'][value='New Here']")
+      end
+    end
+
+    describe '#has_no_xpath?' do
+      it "should wait for content to disappear" do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.should have_no_css("p#change")
+      end
+    end
+
+    describe '#has_content?' do
+      it "should wait for content to appear" do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.should have_content("Has been clicked")
+      end
+    end
+
+    describe '#has_no_content?' do
+      it "should wait for content to disappear" do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.should have_no_content("I changed it")
+      end
+    end
+
+  end
+end
+
+shared_examples_for "session without javascript support" do
+  describe "#evaluate_script" do
+    before{ @session.visit('/with_simple_html') }
+    it "should raise an error" do
+      running {
+        @session.evaluate_script('3 + 3')
+      }.should raise_error(Capybara::NotSupportedByDriverError)
+    end
+  end
+end

data/lib/capybara/spec/session/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/lib/capybara/spec/session/select_spec.rb

@@ -0,0 +1,77 @@
+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
+
+    it "should escape quotes" do
+      @session.select("John's made-up language", :from => 'Locale')
+      @session.click_button('awesome')
+      extract_results(@session)['locale'].should == 'jo'
+    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/lib/capybara/spec/session/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/lib/capybara/spec/session/unselect_spec.rb

@@ -0,0 +1,54 @@
+shared_examples_for "unselect" do
+  describe "#unselect" do
+    before do
+      @session.visit('/form')
+    end
+
+    context "with multiple select" do
+      it "should unselect an option from a select box by id" do
+        @session.unselect('Commando', :from => 'form_underwear')
+        @session.click_button('awesome')
+        extract_results(@session)['underwear'].should include('Briefs', 'Boxer Briefs')
+        extract_results(@session)['underwear'].should_not include('Commando')
+      end
+
+      it "should unselect an option from a select box by label" do
+        @session.unselect('Commando', :from => 'Underwear')
+        @session.click_button('awesome')
+        extract_results(@session)['underwear'].should include('Briefs', 'Boxer Briefs')
+        extract_results(@session)['underwear'].should_not include('Commando')
+      end
+
+      it "should favour exact matches to option labels" do
+        @session.unselect("Briefs", :from => 'Underwear')
+        @session.click_button('awesome')
+        extract_results(@session)['underwear'].should include('Commando', 'Boxer Briefs')
+        extract_results(@session)['underwear'].should_not include('Briefs')
+      end
+
+      it "should escape quotes" do
+        @session.unselect("Frenchman's Pantalons", :from => 'Underwear')
+        @session.click_button('awesome')
+        extract_results(@session)['underwear'].should_not include("Frenchman's Pantalons")
+      end
+    end
+
+    context "with single select" do
+      it "should raise an error" do
+        running { @session.unselect("English", :from => 'form_locale') }.should raise_error(Capybara::UnselectNotAllowed)
+      end
+    end
+
+    context "with a locator that doesn't exist" do
+      it "should raise an error" do
+        running { @session.unselect('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.unselect('Does not Exist', :from => 'form_underwear') }.should raise_error(Capybara::OptionNotFound)
+      end
+    end
+  end
+end

data/lib/capybara/spec/session/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