capybara 1.1.4 → 2.0.0

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

@@ -0,0 +1,42 @@
+Capybara::SpecHelper.spec '#reset_session!' do
+  it "removes cookies" do
+    @session.visit('/set_cookie')
+    @session.visit('/get_cookie')
+    @session.should have_content('test_cookie')
+
+    @session.reset_session!
+    @session.visit('/get_cookie')
+    @session.body.should_not include('test_cookie')
+  end
+
+  it "resets current url, host, path" do
+    @session.visit '/foo'
+    @session.current_url.should_not be_empty
+    @session.current_host.should_not be_empty
+    @session.current_path.should == '/foo'
+
+    @session.reset_session!
+    [nil, '', 'about:blank'].should include @session.current_url
+    @session.current_host.should be_nil
+    @session.current_path.should be_nil
+  end
+
+  it "resets page body" do
+    @session.visit('/with_html')
+    @session.should have_content('This is a test')
+    @session.find('.//h1').text.should include('This is a test')
+
+    @session.reset_session!
+    @session.body.should_not include('This is a test')
+    @session.should have_no_selector('.//h1')
+  end
+
+  it "raises any errors caught inside the server" do
+    expect do
+      quietly { @session.visit("/error") }
+      @session.reset_session!
+    end.to raise_error(TestApp::TestAppError)
+    @session.visit("/")
+    @session.current_path.should == "/"
+  end
+end

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

@@ -1,19 +1,6 @@
-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
+Capybara::SpecHelper.spec '#status_code' do
+  it "should return response codes", :requires => [:status_code] do
+    @session.visit('/with_simple_html')
+    @session.status_code.should == 200
   end
 end

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

@@ -0,0 +1,46 @@
+Capybara::SpecHelper.spec '#save_page' do
+  let(:alternative_path) { File.join(Dir.pwd, "save_and_open_page_tmp") }
+  before do
+    @session.visit("/foo")
+  end
+
+  after do
+    Capybara.save_and_open_page_path = nil
+    Dir.glob("capybara-*.html").each do |file|
+      FileUtils.rm(file)
+    end
+    FileUtils.rm_rf alternative_path
+  end
+
+  it "saves the page in the root directory" do
+    @session.save_page
+    path = Dir.glob("capybara-*.html").first
+    File.read(path).should include("Another World")
+  end
+
+  it "generates a sensible filename" do
+    @session.save_page
+    path = Dir.glob("capybara-*.html").first
+    filename = path.split("/").last
+    filename.should =~ /^capybara-\d+\.html$/
+  end
+
+  it "can store files in a specified directory" do
+    Capybara.save_and_open_page_path = alternative_path
+    @session.save_page
+    path = Dir.glob(alternative_path + "/capybara-*.html").first
+    File.read(path).should include("Another World")
+  end
+
+  it "uses the given filename" do
+    @session.save_page("capybara-001122.html")
+    File.read("capybara-001122.html").should include("Another World")
+  end
+
+  it "returns the filename" do
+    result = @session.save_page
+    path = Dir.glob("capybara-*.html").first
+    filename = path.split("/").last
+    result.should == filename
+  end
+end

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

@@ -0,0 +1,13 @@
+Capybara::SpecHelper.spec "#save_screenshot" do
+  let(:image_path) { File.join(Dir.tmpdir, 'capybara-screenshot.png') }
+
+  before do
+    @session.visit '/'
+    @session.save_screenshot image_path
+  end
+
+  it "should generate PNG file", :requires => [:screenshot] do
+    magic = File.read(image_path, 4)
+    magic.should eq "\x89PNG"
+  end
+end

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

@@ -1,113 +1,124 @@
-shared_examples_for "select" do
-  describe "#select" do
-    before do
-      @session.visit('/form')
-    end
+Capybara::SpecHelper.spec "#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 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 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 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 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'
+  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("Swedish")
+    @session.click_button('awesome')
+    extract_results(@session)['locale'].should == 'sv'
+  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
+
+  it "casts to string" do
+    @session.select(:"Miss", :from => :'Title')
+    @session.find_field('Title').value.should == 'Miss'
+  end
+
+  context "with a locator that doesn't exist" do
+    it "should raise an error" do
+      msg = "Unable to find select box \"does not exist\""
+      expect do
+        @session.select('foo', :from => 'does not exist')
+      end.to raise_error(Capybara::ElementNotFound, msg)
     end
+  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'
+  context "with an option that doesn't exist" do
+    it "should raise an error" do
+      msg = "Unable to find option \"Does not Exist\""
+      expect do
+        @session.select('Does not Exist', :from => 'form_locale')
+      end.to raise_error(Capybara::ElementNotFound, msg)
     end
+  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'
+  context "on a disabled select" do
+    it "should raise an error" do
+      expect do
+        @session.select('Should not see me', :from => 'Disabled Select')
+      end.to raise_error(Capybara::ElementNotFound)
     end
+  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'
+  context "with multiple select" do
+    it "should return an empty value" do
+      @session.find_field('Language').value.should == []
     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"
+    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 "show match labels with preceding or trailing whitespace" do
-      @session.select("Lojban", :from => 'Locale')
+    it "should select one option" do
+      @session.select("Ruby", :from => 'Language')
       @session.click_button('awesome')
-      extract_results(@session)['locale'].should == 'jbo'
+      extract_results(@session)['languages'].should == ['Ruby']
     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
+    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
 
-    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::ElementNotFound)
-      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
 
-    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
+    it "should return value attribute rather than content if present" do
+      @session.find_field('Underwear').value.should include('thermal')
     end
   end
 end

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

@@ -0,0 +1,12 @@
+Capybara::SpecHelper.spec '#source' do
+  it "should return the unmodified page source" do
+    @session.visit('/')
+    @session.source.should include('Hello world!')
+  end
+
+  it "should return the original, unmodified source of the page", :requires => [:js, :source] do
+    @session.visit('/with_js')
+    @session.send(method).should include('This is text')
+    @session.send(method).should_not include('I changed it')
+  end
+end

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

@@ -1,19 +1,22 @@
-shared_examples_for "text" do
-  describe '#text' do
-    before do
-      @session.visit('/with_simple_html')
-    end
+Capybara::SpecHelper.spec '#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
 
-    context "with css as default selector" do
-      before { Capybara.default_selector = :css }
-      it "should print the text of the page" do
-        @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

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

@@ -1,21 +1,26 @@
-shared_examples_for "uncheck" do  
-  describe "#uncheck" do
-    before do
-      @session.visit('/form')
-    end
+Capybara::SpecHelper.spec "#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 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
 
-    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
+  it "casts to string" 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
 end

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

@@ -1,61 +1,72 @@
-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
-        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::ElementNotFound)
-      end
+Capybara::SpecHelper.spec "#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', 'Boxerbriefs')
+      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', 'Boxerbriefs')
+      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', 'Boxerbriefs')
+      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', 'Boxerbriefs')
+      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
+
+    it "casts to string" do
+      @session.unselect(:"Briefs", :from => :'Underwear')
+      @session.click_button('awesome')
+      extract_results(@session)['underwear'].should include('Commando', 'Boxerbriefs')
+      extract_results(@session)['underwear'].should_not include('Briefs')
+    end
+  end
+
+  context "with single select" do
+    it "should raise an error" do
+      expect { @session.unselect("English", :from => 'form_locale') }.to raise_error(Capybara::UnselectNotAllowed)
+    end
+  end
+
+  context "with a locator that doesn't exist" do
+    it "should raise an error" do
+      msg = "Unable to find select box \"does not exist\""
+      expect do
+        @session.unselect('foo', :from => 'does not exist')
+      end.to raise_error(Capybara::ElementNotFound, msg)
+    end
+  end
+
+  context "with an option that doesn't exist" do
+    it "should raise an error" do
+      msg = "Unable to find option \"Does not Exist\""
+      expect do
+        @session.unselect('Does not Exist', :from => 'form_underwear')
+      end.to raise_error(Capybara::ElementNotFound, msg)
     end
   end
 end

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

@@ -0,0 +1,74 @@
+Capybara::SpecHelper.spec '#visit' do
+  it "should fetch a response from the driver with a relative url" do
+    @session.visit('/')
+    @session.should have_content('Hello world!')
+    @session.visit('/foo')
+    @session.should have_content('Another World')
+  end
+
+  it "should fetch a response from the driver with an absolute url with a port" do
+    # Preparation
+    @session.visit('/')
+    root_uri = URI.parse(@session.current_url)
+
+    @session.visit("http://#{root_uri.host}:#{root_uri.port}/")
+    @session.should have_content('Hello world!')
+    @session.visit("http://#{root_uri.host}:#{root_uri.port}/foo")
+    @session.should have_content('Another World')
+  end
+
+  context "when Capybara.always_include_port is true" do
+
+    let(:root_uri) do
+      @session.visit('/')
+      URI.parse(@session.current_url)
+    end
+
+    before(:each) do
+      Capybara.always_include_port = true
+    end
+
+    after(:each) do
+      Capybara.always_include_port = false
+    end
+
+    it "should fetch a response from the driver with an absolute url without a port" do
+      @session.visit("http://#{root_uri.host}/")
+      URI.parse(@session.current_url).port.should == root_uri.port
+      @session.should have_content('Hello world!')
+
+      @session.visit("http://#{root_uri.host}/foo")
+      URI.parse(@session.current_url).port.should == root_uri.port
+      @session.should have_content('Another World')
+    end
+  end
+
+  it "should send no referer when visiting a page" do
+    @session.visit '/get_referer'
+    @session.should have_content 'No referer'
+  end
+
+  it "should send no referer when visiting a second page" do
+    @session.visit '/get_referer'
+    @session.visit '/get_referer'
+    @session.should have_content 'No referer'
+  end
+
+  it "should send a referer when following a link" do
+    @session.visit '/referer_base'
+    @session.find('//a[@href="/get_referer"]').click
+    @session.body.should match %r{http://.*/referer_base}
+  end
+
+  it "should preserve the original referer URL when following a redirect" do
+    @session.visit('/referer_base')
+    @session.find('//a[@href="/redirect_to_get_referer"]').click
+    @session.body.should match %r{http://.*/referer_base}
+  end
+
+  it "should send a referer when submitting a form" do
+    @session.visit '/referer_base'
+    @session.find('//input').click
+    @session.body.should match %r{http://.*/referer_base}
+  end
+end