capybara 1.1.4 → 2.0.0

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

@@ -1,119 +1,119 @@
-shared_examples_for "click_link" do
-  describe '#click_link' do
-    before do
-      @session.visit('/with_html')
-    end
+Capybara::SpecHelper.spec '#click_link' do
+  before do
+    @session.visit('/with_html')
+  end
 
-    context "with id given" do
-      it "should take user to the linked page" do
-        @session.click_link('foo')
-        @session.body.should include('Another World')
-      end
-    end
+  it "should wait for asynchronous load", :requires => [:js] do
+    @session.visit('/with_js')
+    @session.click_link('Click me')
+    @session.click_link('Has been clicked')
+  end
 
-    context "with text given" do
-      it "should take user to the linked page" do
-        @session.click_link('labore')
-        @session.body.should include('Bar')
-      end
-
-      it "should accept partial matches" do
-        @session.click_link('abo')
-        @session.body.should include('Bar')
-      end
-
-      it "should prefer exact matches over partial matches" do
-        @session.click_link('A link')
-        @session.body.should include('Bar')
-      end
-    end
+  it "casts to string" do
+    @session.click_link(:'foo')
+    @session.should have_content('Another World')
+  end
 
-    context "with title given" do
-      it "should take user to the linked page" do
-        @session.click_link('awesome title')
-        @session.body.should include('Bar')
-      end
-
-      it "should accept partial matches" do
-        @session.click_link('some tit')
-        @session.body.should include('Bar')
-      end
-
-      it "should prefer exact matches over partial matches" do
-        @session.click_link('a fine link')
-        @session.body.should include('Bar')
-      end
+  context "with id given" do
+    it "should take user to the linked page" do
+      @session.click_link('foo')
+      @session.should have_content('Another World')
     end
+  end
 
-    context "with alternative text given to a contained image" do
-      it "should take user to the linked page" do
-        @session.click_link('awesome image')
-        @session.body.should include('Bar')
-      end
-
-      it "should take user to the linked page" do
-        @session.click_link('some imag')
-        @session.body.should include('Bar')
-      end
-
-      it "should prefer exact matches over partial matches" do
-        @session.click_link('fine image')
-        @session.body.should include('Bar')
-      end
+  context "with text given" do
+    it "should take user to the linked page" do
+      @session.click_link('labore')
+      @session.should have_content('Bar')
     end
 
-    context "with a locator that doesn't exist" do
-      it "should raise an error" do
-        running do
-          @session.click_link('does not exist')
-        end.should raise_error(Capybara::ElementNotFound)
-      end
+    it "should accept partial matches" do
+      @session.click_link('abo')
+      @session.should have_content('Bar')
     end
+  end
 
-    it "should follow relative links" do
-      @session.visit('/')
-      @session.click_link('Relative')
-      @session.body.should include('This is a test')
+  context "with title given" do
+    it "should take user to the linked page" do
+      @session.click_link('awesome title')
+      @session.should have_content('Bar')
     end
 
-    it "should follow redirects" do
-      @session.click_link('Redirect')
-      @session.body.should include('You landed')
+    it "should accept partial matches" do
+      @session.click_link('some titl')
+      @session.should have_content('Bar')
     end
+  end
 
-    it "should follow redirects" do
-      @session.click_link('BackToMyself')
-      @session.body.should include('This is a test')
+  context "with alternative text given to a contained image" do
+    it "should take user to the linked page" do
+      @session.click_link('awesome image')
+      @session.should have_content('Bar')
     end
 
-    it "should add query string to current URL with naked query string" do
-      @session.click_link('Naked Query String')
-      @session.body.should include('Query String sent')
+    it "should accept partial matches" do
+      @session.click_link('some imag')
+      @session.should have_content('Bar')
     end
+  end
 
-    it "should do nothing on anchor links" do
-      @session.fill_in("test_field", :with => 'blah')
-      @session.click_link('Anchor')
-      @session.find_field("test_field").value.should == 'blah'
-      @session.click_link('Blank Anchor')
-      @session.find_field("test_field").value.should == 'blah'
+  context "with a locator that doesn't exist" do
+    it "should raise an error" do
+      msg = "Unable to find link \"does not exist\""
+      expect do
+        @session.click_link('does not exist')
+      end.to raise_error(Capybara::ElementNotFound, msg)
     end
+  end
 
-    it "should do nothing on URL+anchor links for the same page" do
-      @session.fill_in("test_field", :with => 'blah')
-      @session.click_link('Anchor on same page')
-      @session.find_field("test_field").value.should == 'blah'
-    end
+  it "should follow relative links" do
+    @session.visit('/')
+    @session.click_link('Relative')
+    @session.should have_content('This is a test')
+  end
 
-    it "should follow link on URL+anchor links for a different page" do
-      @session.click_link('Anchor on different page')
-      @session.body.should include('Bar')
-    end
+  it "should follow protocol relative links" do
+    @session.click_link('Protocol')
+    @session.should have_content('Another World')
+  end
 
-    it "raise an error with links with no href" do
-      running do
-        @session.click_link('No Href')
-      end.should raise_error(Capybara::ElementNotFound)
-    end
+  it "should follow redirects" do
+    @session.click_link('Redirect')
+    @session.should have_content('You landed')
+  end
+
+  it "should follow redirects" do
+    @session.click_link('BackToMyself')
+    @session.should have_content('This is a test')
+  end
+
+  it "should add query string to current URL with naked query string" do
+    @session.click_link('Naked Query String')
+    @session.should have_content('Query String sent')
+  end
+
+  it "should do nothing on anchor links" do
+    @session.fill_in("test_field", :with => 'blah')
+    @session.click_link('Normal Anchor')
+    @session.find_field("test_field").value.should == 'blah'
+    @session.click_link('Blank Anchor')
+    @session.find_field("test_field").value.should == 'blah'
+  end
+
+  it "should do nothing on URL+anchor links for the same page" do
+    @session.fill_in("test_field", :with => 'blah')
+    @session.click_link('Anchor on same page')
+    @session.find_field("test_field").value.should == 'blah'
+  end
+
+  it "should follow link on URL+anchor links for a different page" do
+    @session.click_link('Anchor on different page')
+    @session.should have_content('Bar')
+  end
+
+  it "raise an error with links with no href" do
+    expect do
+      @session.click_link('No Href')
+    end.to raise_error(Capybara::ElementNotFound)
   end
 end

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

@@ -1,15 +1,93 @@
-shared_examples_for "current_url" do  
-  describe '#current_url' do
-    it "should return the current url" do
-      @session.visit('/form')
-      @session.current_url.should =~ %r(http://[^/]+/form)
-    end
+Capybara::SpecHelper.spec '#current_url, #current_path, #current_host' do
+  before :all do
+    @servers = 2.times.map { Capybara::Server.new(TestApp.clone).boot }
+    # sanity check
+    @servers[0].port.should_not == @servers[1].port
+    @servers.map { |s| s.port }.should_not include 80
+  end
+
+  def bases
+    @servers.map { |s| "http://#{s.host}:#{s.port}" }
   end
 
-  describe '#current_path' do
-    it 'should show the correct location' do
-      @session.visit('/foo')
-      @session.current_path.should == '/foo'
+  def should_be_on server_index, path="/host", scheme="http"
+    # Check that we are on /host on the given server
+    s = @servers[server_index]
+    @session.current_url.chomp('?').should == "#{scheme}://#{s.host}:#{s.port}#{path}"
+    @session.current_host.should == "#{scheme}://#{s.host}" # no port
+    @session.current_path.should == path
+    if path == '/host'
+      # Server should agree with us
+      @session.should have_content("Current host is #{scheme}://#{s.host}:#{s.port}")
     end
   end
+
+  def visit_host_links
+    @session.visit("#{bases[0]}/host_links?absolute_host=#{bases[1]}")
+  end
+
+  it "is affected by visiting a page directly" do
+    @session.visit("#{bases[0]}/host")
+    should_be_on 0
+  end
+
+  it "returns to the app host when visiting a relative url" do
+    Capybara.app_host = bases[1]
+    @session.visit("#{bases[0]}/host")
+    should_be_on 0
+    @session.visit('/host')
+    should_be_on 1
+    Capybara.app_host = nil
+  end
+
+  it "is affected by setting Capybara.app_host" do
+    Capybara.app_host = bases[0]
+    @session.visit("/host")
+    should_be_on 0
+    Capybara.app_host = bases[1]
+    @session.visit("/host")
+    should_be_on 1
+    Capybara.app_host = nil
+  end
+
+  it "is unaffected by following a relative link" do
+    visit_host_links
+    @session.click_link("Relative Host")
+    should_be_on 0
+  end
+
+  it "is affected by following an absolute link" do
+    visit_host_links
+    @session.click_link("Absolute Host")
+    should_be_on 1
+  end
+
+  it "is unaffected by posting through a relative form" do
+    visit_host_links
+    @session.click_button("Relative Host")
+    should_be_on 0
+  end
+
+  it "is affected by posting through an absolute form" do
+    visit_host_links
+    @session.click_button("Absolute Host")
+    should_be_on 1
+  end
+
+  it "is affected by following a redirect" do
+    @session.visit("#{bases[0]}/redirect")
+    should_be_on 0, "/landed"
+  end
+
+   it "is affected by pushState", :requires => [:js] do
+     @session.visit("/with_js")
+     @session.execute_script("window.history.pushState({}, '', '/pushed')")
+     @session.current_path.should == "/pushed"
+   end
+
+   it "is affected by replaceState", :requires => [:js] do
+     @session.visit("/with_js")
+     @session.execute_script("window.history.replaceState({}, '', '/replaced')")
+     @session.current_path.should == "/replaced"
+   end
 end

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

@@ -0,0 +1,6 @@
+Capybara::SpecHelper.spec "#evaluate_script", :requires => [:js] 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

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

@@ -0,0 +1,7 @@
+Capybara::SpecHelper.spec "#execute_script", :requires => [:js] 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

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

@@ -1,125 +1,141 @@
-shared_examples_for "fill_in" do
-  describe "#fill_in" do
-    before do
-      @session.visit('/form')
-    end
+Capybara::SpecHelper.spec "#fill_in" do
+  before do
+    @session.visit('/form')
+  end
 
-    it "should fill in a text field by id" do
-      @session.fill_in('form_first_name', :with => 'Harry')
-      @session.click_button('awesome')
-      extract_results(@session)['first_name'].should == 'Harry'
-    end
+  it "should fill in a text field by id" do
+    @session.fill_in('form_first_name', :with => 'Harry')
+    @session.click_button('awesome')
+    extract_results(@session)['first_name'].should == 'Harry'
+  end
 
-    it "should fill in a text field by name" do
-      @session.fill_in('form[last_name]', :with => 'Green')
-      @session.click_button('awesome')
-      extract_results(@session)['last_name'].should == 'Green'
-    end
+  it "should fill in a text field by name" do
+    @session.fill_in('form[last_name]', :with => 'Green')
+    @session.click_button('awesome')
+    extract_results(@session)['last_name'].should == 'Green'
+  end
 
-    it "should fill in a text field by label without for" do
-      @session.fill_in('Street', :with => 'Avenue Q')
-      @session.click_button('awesome')
-      extract_results(@session)['street'].should == 'Avenue Q'
-    end
+  it "should fill in a text field by label without for" do
+    @session.fill_in('First Name', :with => 'Harry')
+    @session.click_button('awesome')
+    extract_results(@session)['first_name'].should == 'Harry'
+  end
 
-    it "should fill in a url field by label without for" do
-      @session.fill_in('Html5 Url', :with => 'http://www.avenueq.com')
-      @session.click_button('html5_submit')
-      extract_results(@session)['html5_url'].should == 'http://www.avenueq.com'
-    end
+  it "should fill in a url field by label without for" do
+    @session.fill_in('Html5 Url', :with => 'http://www.avenueq.com')
+    @session.click_button('html5_submit')
+    extract_results(@session)['html5_url'].should == 'http://www.avenueq.com'
+  end
 
-    it "should favour exact label matches over partial matches" do
-      @session.fill_in('Name', :with => 'Harry Jones')
-      @session.click_button('awesome')
-      extract_results(@session)['name'].should == 'Harry Jones'
-    end
+  it "should fill in a textarea by id" do
+    @session.fill_in('form_description', :with => 'Texty text')
+    @session.click_button('awesome')
+    extract_results(@session)['description'].should == 'Texty text'
+  end
 
-    it "should fill in a textarea by id" do
-      @session.fill_in('form_description', :with => 'Texty text')
-      @session.click_button('awesome')
-      extract_results(@session)['description'].should == 'Texty text'
-    end
+  it "should fill in a textarea by label" do
+    @session.fill_in('Description', :with => 'Texty text')
+    @session.click_button('awesome')
+    extract_results(@session)['description'].should == 'Texty text'
+  end
 
-    it "should fill in a textarea by label" do
-      @session.fill_in('Description', :with => 'Texty text')
-      @session.click_button('awesome')
-      extract_results(@session)['description'].should == 'Texty text'
-    end
+  it "should fill in a textarea by name" do
+    @session.fill_in('form[description]', :with => 'Texty text')
+    @session.click_button('awesome')
+    extract_results(@session)['description'].should == 'Texty text'
+  end
 
-    it "should fill in a textarea by name" do
-      @session.fill_in('form[description]', :with => 'Texty text')
-      @session.click_button('awesome')
-      extract_results(@session)['description'].should == 'Texty text'
-    end
+  it "should fill in a password field by id" do
+    @session.fill_in('form_password', :with => 'supasikrit')
+    @session.click_button('awesome')
+    extract_results(@session)['password'].should == 'supasikrit'
+  end
 
-    it "should fill in a password field by id" do
-      @session.fill_in('form_password', :with => 'supasikrit')
-      @session.click_button('awesome')
-      extract_results(@session)['password'].should == 'supasikrit'
-    end
+  it "should fill in a field with a custom type" do
+    @session.fill_in('Schmooo', :with => 'Schmooo is the game')
+    @session.click_button('awesome')
+    extract_results(@session)['schmooo'].should == 'Schmooo is the game'
+  end
 
-    it "should fill in a field with a custom type" do
-      @session.fill_in('Schmooo', :with => 'Schmooo is the game')
-      @session.click_button('awesome')
-      extract_results(@session)['schmooo'].should == 'Schmooo is the game'
-    end
+  it "should fill in a field without a type" do
+    @session.fill_in('Phone', :with => '+1 555 7022')
+    @session.click_button('awesome')
+    extract_results(@session)['phone'].should == '+1 555 7022'
+  end
 
-    it "should fill in a field without a type" do
-      @session.fill_in('Phone', :with => '+1 555 7022')
-      @session.click_button('awesome')
-      extract_results(@session)['phone'].should == '+1 555 7022'
-    end
+  it "should fill in a text field respecting its maxlength attribute" do
+    @session.fill_in('Zipcode', :with => '52071350')
+    @session.click_button('awesome')
+    extract_results(@session)['zipcode'].should == '52071'
+  end
 
-    it "should fill in a text field respecting its maxlength attribute" do
-      @session.fill_in('Zipcode', :with => '52071350')
-      @session.click_button('awesome')
-      extract_results(@session)['zipcode'].should == '52071'
-    end
+  it "should fill in a password field by name" do
+    @session.fill_in('form[password]', :with => 'supasikrit')
+    @session.click_button('awesome')
+    extract_results(@session)['password'].should == 'supasikrit'
+  end
 
-    it "should fill in a password field by name" do
-      @session.fill_in('form[password]', :with => 'supasikrit')
-      @session.click_button('awesome')
-      extract_results(@session)['password'].should == 'supasikrit'
-    end
+  it "should fill in a password field by label" do
+    @session.fill_in('Password', :with => 'supasikrit')
+    @session.click_button('awesome')
+    extract_results(@session)['password'].should == 'supasikrit'
+  end
 
-    it "should fill in a password field by label" do
-      @session.fill_in('Password', :with => 'supasikrit')
-      @session.click_button('awesome')
-      extract_results(@session)['password'].should == 'supasikrit'
-    end
+  it "should fill in a password field by name" do
+    @session.fill_in('form[password]', :with => 'supasikrit')
+    @session.click_button('awesome')
+    extract_results(@session)['password'].should == 'supasikrit'
+  end
 
-    it "should fill in a password field by name" do
-      @session.fill_in('form[password]', :with => 'supasikrit')
-      @session.click_button('awesome')
-      extract_results(@session)['password'].should == 'supasikrit'
-    end
-    
-    it "should prefer exact matches over partial matches" do
-      @session.fill_in('Name', :with => 'Ford Prefect')
-      @session.click_button('awesome')
-      extract_results(@session)['name'].should == 'Ford Prefect'
+  it "should throw an exception if a hash containing 'with' is not provided" do
+    lambda{@session.fill_in 'Name', 'ignu'}.should raise_error
+  end
+
+  it "should wait for asynchronous load", :requires => [:js] do
+    @session.visit('/with_js')
+    @session.click_link('Click me')
+    @session.fill_in('new_field', :with => 'Testing...')
+  end
+
+  it "casts to string" do
+    @session.fill_in(:'form_first_name', :with => :'Harry')
+    @session.click_button('awesome')
+    extract_results(@session)['first_name'].should == 'Harry'
+  end
+
+  context 'on a pre-populated textfield with a reformatting onchange', :requires => [:js] do
+    it 'should only trigger onchange once' do
+      @session.visit('/with_js')
+      @session.fill_in('with_change_event', :with => 'some value')
+      @session.find(:css, '#with_change_event').value.should == 'some value'
     end
-    
-    it "should throw an exception if a hash containing 'with' is not provided" do
-      lambda{@session.fill_in 'Name', 'ignu'}.should raise_error
+  end
+
+  context "with ignore_hidden_fields" do
+    before { Capybara.ignore_hidden_elements = true }
+    after  { Capybara.ignore_hidden_elements = false }
+    it "should not find a hidden field" do
+      msg = "Unable to find field \"Super Secret\""
+      expect do
+        @session.fill_in('Super Secret', :with => '777')
+      end.to raise_error(Capybara::ElementNotFound, msg)
     end
-    
-    context "with ignore_hidden_fields" do
-      before { Capybara.ignore_hidden_elements = true }
-      after  { Capybara.ignore_hidden_elements = false }
-      it "should not find a hidden field" do
-        running do
-          @session.fill_in('Super Secret', :with => '777')
-        end.should raise_error(Capybara::ElementNotFound)
-      end
+  end
+
+  context "with a locator that doesn't exist" do
+    it "should raise an error" do
+      msg = "Unable to find field \"does not exist\""
+      expect do
+        @session.fill_in('does not exist', :with => 'Blah blah')
+      end.to raise_error(Capybara::ElementNotFound, msg)
     end
+  end
 
-    context "with a locator that doesn't exist" do
-      it "should raise an error" do
-        running do
-          @session.fill_in('does not exist', :with => 'Blah blah')
-        end.should raise_error(Capybara::ElementNotFound)
-      end
+  context "on a disabled field" do
+    it "should raise an error" do
+      expect do
+        @session.fill_in('Disabled Text Field', :with => 'Blah blah')
+      end.to raise_error(Capybara::ElementNotFound)
     end
   end
 end

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

@@ -1,18 +1,20 @@
-shared_examples_for "find_button" do  
-  describe '#find_button' do
-    before do
-      @session.visit('/form')
-    end
+Capybara::SpecHelper.spec '#find_button' do
+  before do
+    @session.visit('/form')
+  end
+
+  it "should find any button" do
+    @session.find_button('med')[:id].should == "mediocre"
+    @session.find_button('crap321').value.should == "crappy"
+  end
 
-    it "should find any field" do
-      @session.find_button('med')[:id].should == "mediocre"
-      @session.find_button('crap321').value.should == "crappy"
-    end
+  it "casts to string" do
+    @session.find_button(:'med')[:id].should == "mediocre"
+  end
 
-    it "should raise error if the field doesn't exist" do
-      running do
-        @session.find_button('Does not exist')
-      end.should raise_error(Capybara::ElementNotFound)
-    end
+  it "should raise error if the button doesn't exist" do
+    expect do
+      @session.find_button('Does not exist')
+    end.to raise_error(Capybara::ElementNotFound)
   end
 end