capybara 1.1.4 → 2.0.0

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

@@ -0,0 +1,31 @@
+Capybara::SpecHelper.spec '#within_frame', :requires => [:frames] do
+  before(:each) do
+    @session.visit('/within_frames')
+  end
+
+  it "should find the div in frameOne" do
+    @session.within_frame("frameOne") do
+      @session.find("//*[@id='divInFrameOne']").text.should eql 'This is the text of divInFrameOne'
+    end
+  end
+  it "should find the div in FrameTwo" do
+    @session.within_frame("frameTwo") do
+      @session.find("//*[@id='divInFrameTwo']").text.should eql 'This is the text of divInFrameTwo'
+    end
+  end
+  it "should find the text div in the main window after finding text in frameOne" do
+    @session.within_frame("frameOne") do
+      @session.find("//*[@id='divInFrameOne']").text.should eql 'This is the text of divInFrameOne'
+    end
+    @session.find("//*[@id='divInMainWindow']").text.should eql 'This is the text for divInMainWindow'
+  end
+  it "should find the text div in the main window after finding text in frameTwo" do
+    @session.within_frame("frameTwo") do
+      @session.find("//*[@id='divInFrameTwo']").text.should eql 'This is the text of divInFrameTwo'
+    end
+    @session.find("//*[@id='divInMainWindow']").text.should eql 'This is the text for divInMainWindow'
+  end
+  it "should return the result of executing the block" do
+    @session.within_frame("frameOne") { "return value" }.should eql "return value"
+  end
+end

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

@@ -1,178 +1,165 @@
-shared_examples_for "within" do
-  describe '#within' do
-    before do
-      @session.visit('/with_scope')
-    end
+Capybara::SpecHelper.spec '#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')
+  context "with CSS selector" do
+    it "should click links in the given scope" do
+      @session.within(:css, "#for_bar li[contains('With Simple HTML')]") do
+        @session.click_link('Go')
       end
+      @session.should have_content('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')
+    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')
+    it "should accept additional options" do
+      @session.within(:css, "#for_bar li", :text => 'With Simple HTML') do
+        @session.click_link('Go')
       end
+      @session.should have_content('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')
+  context "with XPath selector" do
+    it "should click links in the given scope" do
+      @session.within(:xpath, "//div[@id='for_bar']//li[contains(.,'With Simple HTML')]") do
+        @session.click_link('Go')
       end
+      @session.should have_content('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')
+  context "with the default selector" do
+    it "should use XPath" do
+      @session.within("//div[@id='for_bar']//li[contains(.,'With Simple HTML')]") do
+        @session.click_link('Go')
       end
+      @session.should have_content('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')]")
+  context "with Node rather than selector" do
+    it "should click links in the given scope" do
+      node_of_interest = @session.find(:css, "#for_bar li[contains('With Simple HTML')]")
 
-        @session.within(node_of_interest) do 
-          @session.click_link('Go')
-        end
-        @session.body.should include('Bar')
+      @session.within(node_of_interest) do
+        @session.click_link('Go')
       end
+      @session.should have_content('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')
+  context "with the default selector set to CSS" do
+    before { Capybara.default_selector = :css }
+    it "should use CSS" do
+      @session.within("#for_bar li[contains('With Simple HTML')]") do
+        @session.click_link('Go')
       end
-      after { Capybara.default_selector = :xpath }
+      @session.should have_content('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
+  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
-        @session.body.should include('Bar')
       end
+      @session.should have_content('Another World')
+    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')
+    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.should have_content('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)
+  it "should raise an error if the scope is not found on the page" do
+    expect do
+      @session.within("//div[@id='doesnotexist']") do
       end
+    end.to 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)
+  it "should restore the scope when an error is raised" do
+    expect do
+      @session.within("//div[@id='for_bar']") do
+        expect do
+          expect do
+            @session.within(".//div[@id='doesnotexist']") do
+            end
+          end.to raise_error(Capybara::ElementNotFound)
+        end.to_not change { @session.has_xpath?(".//div[@id='another_foo']") }.from(false)
       end
-    end
+    end.to_not change { @session.has_xpath?(".//div[@id='another_foo']") }.from(true)
+  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
+  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
 
-  describe '#within_fieldset' do
-    before do
-      @session.visit('/fieldsets')
-    end
+Capybara::SpecHelper.spec '#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'
+  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'
+  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
+Capybara::SpecHelper.spec '#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'
+  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'
+  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

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

@@ -0,0 +1,38 @@
+Capybara::SpecHelper.spec '#within_window', :requires => [:windows] do
+  before(:each) do
+    @session.visit('/within_popups')
+  end
+  after(:each) do
+    @session.within_window("firstPopup") do
+      @session.evaluate_script('window.close()')
+    end
+    @session.within_window("secondPopup") do
+      @session.evaluate_script('window.close()')
+    end
+  end
+
+  it "should find the div in firstPopup" do
+    @session.within_window("firstPopup") do
+      @session.find("//*[@id='divInPopupOne']").text.should eql 'This is the text of divInPopupOne'
+    end
+  end
+  it "should find the div in secondPopup" do
+    @session.within_window("secondPopup") do
+      @session.find("//*[@id='divInPopupTwo']").text.should eql 'This is the text of divInPopupTwo'
+    end
+  end
+  it "should find the divs in both popups" do
+    @session.within_window("secondPopup") do
+      @session.find("//*[@id='divInPopupTwo']").text.should eql 'This is the text of divInPopupTwo'
+    end
+    @session.within_window("firstPopup") do
+      @session.find("//*[@id='divInPopupOne']").text.should eql 'This is the text of divInPopupOne'
+    end
+  end
+  it "should find the div in the main window after finding a div in a popup" do
+    @session.within_window("secondPopup") do
+      @session.find("//*[@id='divInPopupTwo']").text.should eql 'This is the text of divInPopupTwo'
+    end
+    @session.find("//*[@id='divInMainWindow']").text.should eql 'This is the text for divInMainWindow'
+  end
+end

data/lib/capybara/spec/spec_helper.rb

@@ -0,0 +1,84 @@
+require "rspec"
+require "capybara"
+require "capybara/rspec" # Required here instead of in rspec_spec to avoid RSpec deprecation warning
+require "capybara/spec/test_app"
+require "capybara/spec/spec_helper"
+require "nokogiri"
+
+module Capybara
+  module SpecHelper
+    class << self
+      def configure(config)
+        filter = lambda do |requires, metadata|
+          if requires and metadata[:skip]
+            requires.any? do |require|
+              metadata[:skip].include?(require)
+            end
+          else
+            false
+          end
+        end
+        config.filter_run_excluding :requires => filter
+        config.before do
+          Capybara.app = TestApp
+
+          Capybara.configure do |config|
+            config.default_selector = :xpath
+          end
+
+          Capybara.default_wait_time = 1
+        end
+      end
+
+      def spec(name, options={}, &block)
+        @specs ||= []
+        @specs << [name, options, block]
+      end
+
+      def run_specs(session, name, options={})
+        specs = @specs
+        describe Capybara::Session, name, options do
+          include Capybara::SpecHelper
+          before do
+            @session = session
+          end
+          after do
+            @session.reset_session!
+          end
+          specs.each do |name, options, block|
+            describe name, options do
+              class_eval(&block)
+            end
+          end
+        end
+      end
+    end # class << self
+
+    def silence_stream(stream)
+      old_stream = stream.dup
+      stream.reopen(RbConfig::CONFIG['host_os'] =~ /rmswin|mingw/ ? 'NUL:' : '/dev/null')
+      stream.sync = true
+      yield
+    ensure
+      stream.reopen(old_stream)
+    end
+
+    def quietly
+      silence_stream(STDOUT) do
+        silence_stream(STDERR) do
+          yield
+        end
+      end
+    end
+
+    def extract_results(session)
+      YAML.load Nokogiri::HTML(session.body).xpath("//pre[@id='results']").first.text.lstrip
+    end
+  end
+end
+
+RSpec.configure do |config|
+  Capybara::SpecHelper.configure(config)
+end
+
+Dir[File.dirname(__FILE__)+'/session/*'].each { |group| require group }

data/lib/capybara/spec/test_app.rb

@@ -3,8 +3,14 @@ require 'rack'
 require 'yaml'
 
 class TestApp < Sinatra::Base
+  class TestAppError < StandardError; end
+
   set :root, File.dirname(__FILE__)
   set :static, true
+  set :raise_errors, true
+  set :show_exceptions, false
+
+  # Also check lib/capybara/spec/views/*.erb for pages not listed here
 
   get '/' do
     'Hello world! <a href="with_html">Relative</a>'
@@ -22,8 +28,22 @@ class TestApp < Sinatra::Base
     redirect '/landed'
   end
 
+  get '/referer_base' do
+    '<a href="/get_referer">direct link</a>' +
+    '<a href="/redirect_to_get_referer">link via redirect</a>' +
+    '<form action="/get_referer" method="get"><input type="submit"></form>'
+  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}"
+    "Current host is #{request.scheme}://#{request.host}:#{request.port}"
   end
 
   get '/redirect/:times/times' do
@@ -72,7 +92,7 @@ class TestApp < Sinatra::Base
   end
 
   get '/redirect_secure' do
-    redirect "https://#{request.host}/host"
+    redirect "https://#{request.host}:#{request.port}/host"
   end
 
   get '/slow_response' do
@@ -98,6 +118,10 @@ class TestApp < Sinatra::Base
     redirect '/get_header'
   end
 
+  get '/error' do
+    raise TestAppError, "some error"
+  end
+
   get '/:view' do |view|
     erb view.to_sym
   end
@@ -107,7 +131,7 @@ class TestApp < Sinatra::Base
   end
 
   post '/upload_empty' do
-    if params[:form].nil? || params[:form][:file].nil?
+    if params[:form][:file].nil?
       'Successfully ignored empty file field.'
     else
       'Something went wrong.'
@@ -127,9 +151,11 @@ class TestApp < Sinatra::Base
 
   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 = ["#{params[:form][:multiple_documents].size}"]
+      params[:form][:multiple_documents].each do |doc|
+        buffer << "Content-type: #{doc[:type]}"
+        buffer << "File content: #{doc[:tempfile].read}"
+      end
       buffer.join(' | ')
     rescue
       'No files uploaded'

data/lib/capybara/spec/views/form.erb

@@ -32,7 +32,7 @@
     <label for="form_last_name">Last Name</label>
     <input type="text" name="form[last_name]" value="Smith" id="form_last_name"/>
   </p>
-  
+
   <p>
     <label for="form_name_explanation">Explanation of Name</label>
     <textarea name="form[name_explanation]" id="form_name_explanation"></textarea>
@@ -47,7 +47,7 @@
     <label for="form_schmooo">Schmooo</label>
     <input type="schmooo" name="form[schmooo]" value="This is Schmooo!" id="form_schmooo"/>
   </p>
-  
+
   <p>
     <label>Street<br/>
       <input type="text" maxlength="" name="form[street]" value="Sesame street 66"/>
@@ -74,7 +74,7 @@
     <label for="form_image">Image</label>
     <input type="file" name="form[image]" id="form_image"/>
   </p>
-  
+
   <p>
     <input type="hidden" name="form[token]" value="12345" id="form_token"/>
   </p>
@@ -155,7 +155,7 @@
   <p>
     <label for="form_underwear">Underwear</label>
     <select name="form[underwear][]" id="form_underwear" multiple="multiple">
-      <option selected="selected">Boxer Briefs</option>
+      <option selected="selected">Boxerbriefs</option>
       <option>Boxers</option>
       <option selected="selected">Briefs</option>
       <option selected="selected">Commando</option>
@@ -163,7 +163,7 @@
       <option selected="selected" value="thermal">Long Johns</option>
     </select>
   </p>
- 
+
   <p>
     <span>First address<span>
     <label for='address1_street'>Street</label>
@@ -185,7 +185,7 @@
     <input type="text" name="form[addresses][][street]" value="" id="address2_street">
 
     <label for='address2_city'>City</label>
-    <input type="text" name="form[addresses][][city]" value="" id="address2_city"> 
+    <input type="text" name="form[addresses][][city]" value="" id="address2_city">
 
     <label for='address2_country'>Country</label>
     <select name="form[addresses][][country]" id="address2_country">
@@ -253,6 +253,7 @@
     <button type="submit" id="click_me_123" title="Click Title button" value="click_me">Click me!</button>
     <button type="submit" name="form[no_value]">No Value!</button>
     <button id="no_type">No Type!</button>
+    <input type="button" disabled value="Disabled button"/>
   </p>
 </form>
 
@@ -274,6 +275,7 @@
   </p>
 
   <p>
+    <input type="hidden" name="form[dummy]" value="ensure params[:form] exists"/>
     <input type="submit" value="Upload Empty"/>
   <p>
 </form>
@@ -285,12 +287,12 @@
   </p>
 
   <p>
-    <label for="form_document">Document</label>
+    <label for="form_document">Single Document</label>
     <input type="file" name="form[document]" id="form_document"/>
   </p>
- 
+
   <p>
-    <input type="submit" value="Upload"/>
+    <input type="submit" value="Upload Single"/>
   <p>
 </form>
 
@@ -337,7 +339,7 @@
     <label for="html5_color">Html5 Color</label>
     <input type="color" name="form[html5_color]" value="#FFFFFF" id="html5_color"/>
   </p>
-  
+
   <p>
     <input type="submit" name="form[html5_submit]" value="html5_submit"/>
   </p>

data/lib/capybara/spec/views/host_links.erb

@@ -1,12 +1,12 @@
 <p>
   <a href="/host">Relative Host</a>
-  <a href="http://capybara2.elabs.se/host">Absolute Host</a>
+  <a href="<%= params[:absolute_host] %>/host">Absolute Host</a>
 </p>
 
 <form action="/host">
   <p><input type="submit" value="Relative Host"/></p>
 </form>
 
-<form action="http://capybara2.elabs.se/host">
+<form action="<%= params[:absolute_host] %>/host">
   <p><input type="submit" value="Absolute Host"/></p>
 </form>