yannp-capybara 0.3.9

data/lib/capybara/spec/session/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/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,232 @@
+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 '#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
+        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 evaluate the given script and return whatever it produces" do
+        @session.visit('/with_js')
+        @session.evaluate_script("1+3").should == 4
+      end
+    end
+
+    describe "#execute_script" do
+      it "should execute the given script and return nothing" do
+        @session.visit('/with_js')
+        @session.execute_script("$('#change').text('Funky Doodle')").should be_nil
+        @session.should have_css('#change', :text => 'Funky Doodle')
+      end
+    end
+
+    describe '#find' do
+      it "should wait for asynchronous load" do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.find("//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.all('//div[@id="nosuchthing"]').first
+          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_link_or_button' do
+      it "should wait for asynchronous load" do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.click_link_or_button('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/response_code.rb

@@ -0,0 +1,19 @@
+shared_examples_for "session with status code support" do
+  describe '#status_code' do
+    it "should return response codes" do
+      @session.visit('/with_simple_html')     
+      @session.status_code.should == 200
+    end
+  end
+end
+
+shared_examples_for "session without status code support" do
+  describe "#status_code" do
+    before{ @session.visit('/with_simple_html') }
+    it "should raise an error" do
+      running {
+        @session.status_code
+      }.should raise_error(Capybara::NotSupportedByDriverError)
+    end
+  end
+end

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

@@ -0,0 +1,91 @@
+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
+
+    it "should obey from" do
+      @session.select("Miss", :from => "Other title")
+      @session.click_button('awesome')
+      results = extract_results(@session)
+      results['other_title'].should == "Miss"
+      results['title'].should_not == "Miss"
+    end
+
+    it "show match labels with preceding or trailing whitespace" do
+      @session.select("Lojban", :from => 'Locale')
+      @session.click_button('awesome')
+      extract_results(@session)['locale'].should == 'jbo'
+    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