bbc-capybara 1.1.2

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,119 @@
+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 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')
+      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 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')
+      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
+        msg = "no select box with id, name, or label 'does not exist' found"
+        running do
+          @session.select('foo', :from => 'does not exist')
+        end.should raise_error(Capybara::ElementNotFound, msg)
+      end
+    end
+
+    context "with an option that doesn't exist" do
+      it "should raise an error" do
+        msg = "no option with text 'Does not Exist' in the select box"
+        running do
+          @session.select('Does not Exist', :from => 'form_locale')
+        end.should raise_error(Capybara::ElementNotFound, msg)
+      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
+      
+      it "should remain selected if already selected" do
+        @session.select("Ruby",       :from => 'Language')
+        @session.select("Javascript", :from => 'Language')
+        @session.select("Ruby",       :from => 'Language')
+        @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

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

@@ -0,0 +1,24 @@
+shared_examples_for "text" do
+  describe '#text' do
+    it "should print the text of the page" do
+      @session.visit('/with_simple_html')
+      @session.text.should == 'Bar'
+    end
+
+    context "with css as default selector" do
+      before { Capybara.default_selector = :css }
+      it "should print the text of the page" do
+        @session.visit('/with_simple_html')
+        @session.text.should == 'Bar'
+      end
+      after { Capybara.default_selector = :xpath }
+    end
+
+    it "should strip whitespace" do
+      @session.visit('/with_html')
+      n = @session.find(:css, '#second')
+      @session.find(:css, '#second').text.should =~ \
+        /\ADuis aute .* text with whitespace .* est laborum\.\z/
+    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,67 @@
+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 without a select box" do
+        @session.unselect('Commando')
+        @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
+        msg = "no select box with id, name, or label 'does not exist' found"
+        running do
+          @session.unselect('foo', :from => 'does not exist')
+        end.should raise_error(Capybara::ElementNotFound, msg)
+      end
+    end
+
+    context "with an option that doesn't exist" do
+      it "should raise an error" do
+        msg = "no option with text 'Does not Exist' in the select box"
+        running do
+          @session.unselect('Does not Exist', :from => 'form_underwear')
+        end.should raise_error(Capybara::ElementNotFound, msg)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,178 @@
+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
+
+      it "should assert content in the given scope" do
+        @session.within(:css, "#for_foo") do
+          @session.should_not have_content('First Name')
+        end
+        @session.should have_content('First Name')
+      end
+
+      it "should accept additional options" do
+        @session.within(:css, "ul li", :text => '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 Node rather than selector" do
+      it "should click links in the given scope" do
+        node_of_interest = @session.find(:css, "ul li[contains('With Simple HTML')]")
+
+        @session.within(node_of_interest) 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 do
+          @session.within("//div[@id='doesnotexist']") do
+          end
+        end.should raise_error(Capybara::ElementNotFound)
+      end
+
+      it "should restore the scope when an error is raised" do
+        running do
+          @session.within("//div[@id='for_bar']") do
+            running do
+              running do
+                @session.within(".//div[@id='doesnotexist']") do
+                end
+              end.should raise_error(Capybara::ElementNotFound)
+            end.should_not change { @session.has_xpath?(".//div[@id='another_foo']") }.from(false)
+          end
+        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

data/lib/capybara/spec/test_app.rb

@@ -0,0 +1,156 @@
+require 'sinatra/base'
+require 'rack'
+require 'yaml'
+
+class TestApp < Sinatra::Base
+  set :root, File.dirname(__FILE__)
+  set :static, true
+
+  # Also check lib/capybara/spec/views/*.erb for pages not listed here
+
+  get '/' do
+    'Hello world! <a href="with_html">Relative</a>'
+  end
+
+  get '/foo' do
+    'Another World'
+  end
+
+  get '/redirect' do
+    redirect '/redirect_again'
+  end
+
+  get '/redirect_again' do
+    redirect '/landed'
+  end
+
+  get '/referer_base' do
+    '<a href="/get_referer">direct link</a>; <a href="/redirect_to_get_referer">link via redirect</a>'
+  end
+
+  get '/redirect_to_get_referer' do
+    redirect '/get_referer'
+  end
+
+  get '/get_referer' do
+    request.referer.nil? ? "No referer" : "Got referer: #{request.referer}"
+  end
+
+  get '/host' do
+    "Current host is #{request.scheme}://#{request.host}:#{request.port}"
+  end
+
+  get '/redirect/:times/times' do
+    times = params[:times].to_i
+    if times.zero?
+      "redirection complete"
+    else
+      redirect "/redirect/#{times - 1}/times"
+    end
+  end
+
+  get '/landed' do
+    "You landed"
+  end
+
+  get '/with-quotes' do
+    %q{"No," he said, "you can't do that."}
+  end
+
+  get '/form/get' do
+    '<pre id="results">' + params[:form].to_yaml + '</pre>'
+  end
+
+  post '/relative' do
+    '<pre id="results">' + params[:form].to_yaml + '</pre>'
+  end
+
+  get '/favicon.ico' do
+    nil
+  end
+
+  post '/redirect' do
+    redirect '/redirect_again'
+  end
+
+  delete "/delete" do
+    "The requested object was deleted"
+  end
+
+  get "/delete" do
+    "Not deleted"
+  end
+
+  get '/redirect_back' do
+    redirect back
+  end
+
+  get '/redirect_secure' do
+    redirect "https://#{request.host}:#{request.port}/host"
+  end
+
+  get '/slow_response' do
+    sleep 2
+    'Finally!'
+  end
+
+  get '/set_cookie' do
+    cookie_value = 'test_cookie'
+    response.set_cookie('capybara', cookie_value)
+    "Cookie set to #{cookie_value}"
+  end
+
+  get '/get_cookie' do
+    request.cookies['capybara']
+  end
+
+  get '/get_header' do
+    env['HTTP_FOO']
+  end
+
+  get '/get_header_via_redirect' do
+    redirect '/get_header'
+  end
+
+  get '/:view' do |view|
+    erb view.to_sym
+  end
+
+  post '/form' do
+    '<pre id="results">' + params[:form].to_yaml + '</pre>'
+  end
+
+  post '/upload_empty' do
+    if params[:form][:file].nil?
+      'Successfully ignored empty file field.'
+    else
+      'Something went wrong.'
+    end
+  end
+
+  post '/upload' do
+    begin
+      buffer = []
+      buffer << "Content-type: #{params[:form][:document][:type]}"
+      buffer << "File content: #{params[:form][:document][:tempfile].read}"
+      buffer.join(' | ')
+    rescue
+      'No file uploaded'
+    end
+  end
+
+  post '/upload_multiple' do
+    begin
+      buffer = []
+      buffer << "Content-type: #{params[:form][:multiple_documents][0][:type]}"
+      buffer << "File content: #{params[:form][:multiple_documents][0][:tempfile].read}"
+      buffer.join(' | ')
+    rescue
+      'No files uploaded'
+    end
+  end
+end
+
+if __FILE__ == $0
+  Rack::Handler::WEBrick.run TestApp, :Port => 8070
+end