capybara 2.0.3 → 2.1.0

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

@@ -70,7 +70,7 @@ Capybara::SpecHelper.spec '#has_css?' do
 
     it "should be false when content occurs more times than given" do
       @session.should_not have_css("h2.head", :maximum => 4) # edge case
-      @session.should_not have_css("h2", :maximum => 6)
+      @session.should_not have_css("h2", :maximum => 3)
       @session.should_not have_css("p", :maximum => 1)
     end
 
@@ -184,7 +184,7 @@ Capybara::SpecHelper.spec '#has_no_css?' do
 
     it "should be true when content occurs more times than given" do
       @session.should have_no_css("h2.head", :maximum => 4) # edge case
-      @session.should have_no_css("h2", :maximum => 6)
+      @session.should have_no_css("h2", :maximum => 3)
       @session.should have_no_css("p", :maximum => 1)
     end
 

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

@@ -42,12 +42,16 @@ Capybara::SpecHelper.spec '#has_field' do
       @session.should have_field('First Name', :type => 'text')
       @session.should have_field('Html5 Email', :type => 'email')
       @session.should have_field('Html5 Tel', :type => 'tel')
+      @session.should have_field('Description', :type => 'textarea')
+      @session.should have_field('Languages', :type => 'select')
     end
 
     it "should be false if the given field is not on the page" do
-      @session.should_not have_field('First Name', :type => 'email')
+      @session.should_not have_field('First Name', :type => 'textarea')
       @session.should_not have_field('Html5 Email', :type => 'tel')
       @session.should_not have_field('Description', :type => '')
+      @session.should_not have_field('Description', :type => 'email')
+      @session.should_not have_field('Languages', :type => 'textarea')
     end
   end
 end
@@ -95,12 +99,16 @@ Capybara::SpecHelper.spec '#has_no_field' do
       @session.should_not have_no_field('First Name', :type => 'text')
       @session.should_not have_no_field('Html5 Email', :type => 'email')
       @session.should_not have_no_field('Html5 Tel', :type => 'tel')
+      @session.should_not have_no_field('Description', :type => 'textarea')
+      @session.should_not have_no_field('Languages', :type => 'select')
     end
 
     it "should be true if the given field is not on the page" do
-      @session.should have_no_field('First Name', :type => 'email')
+      @session.should have_no_field('First Name', :type => 'textarea')
       @session.should have_no_field('Html5 Email', :type => 'tel')
       @session.should have_no_field('Description', :type => '')
+      @session.should have_no_field('Description', :type => 'email')
+      @session.should have_no_field('Languages', :type => 'textarea')
     end
   end
 end

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

@@ -53,6 +53,15 @@ Capybara::SpecHelper.spec '#has_selector?' do
       @session.should_not have_selector("//p", :text => "Doesnotexist")
     end
 
+    it "should respect visibility setting" do
+      @session.should have_selector(:id, "hidden-text", :text => "Some of this text is hidden!", :visible => false)
+      @session.should_not have_selector(:id, "hidden-text", :text => "Some of this text is hidden!", :visible => true)
+      Capybara.ignore_hidden_elements = false
+      @session.should have_selector(:id, "hidden-text", :text => "Some of this text is hidden!", :visible => false)
+      Capybara.visible_text_only = true
+      @session.should_not have_selector(:id, "hidden-text", :text => "Some of this text is hidden!", :visible => true)
+    end
+
     it "should discard all matches where the given regexp is not matched" do
       @session.should have_selector("//p//a", :text => /re[dab]i/i, :count => 1)
       @session.should_not have_selector("//p//a", :text => /Red$/)

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

@@ -74,6 +74,17 @@ Capybara::SpecHelper.spec '#has_text?' do
     @session.should_not have_text('Inside element with hidden ancestor')
   end
 
+  it "should be true if :all given and text is invisible." do
+    @session.visit('/with_html')
+    @session.should have_text(:all, 'Some of this text is hidden!')
+  end
+
+  it "should be true if `Capybara.ignore_hidden_elements = true` and text is invisible." do
+    Capybara.ignore_hidden_elements = false
+    @session.visit('/with_html')
+    @session.should have_text('Some of this text is hidden!')
+  end
+
   it "should be true if the text in the page matches given regexp" do
     @session.visit('/with_html')
     @session.should have_text(/Lorem/)
@@ -105,6 +116,80 @@ Capybara::SpecHelper.spec '#has_text?' do
     @session.click_link('Click me')
     @session.should have_text("Has been clicked")
   end
+
+  context "with between" do
+    it "should be true if the text occurs within the range given" do
+      @session.visit('/with_count')
+      @session.should have_text('count', between: 1..3)
+      @session.should have_text(/count/, between: 2..2)
+    end
+
+    it "should be false if the text occurs more or fewer times than range" do
+      @session.visit('/with_count')
+      @session.should_not have_text('count', between: 0..1)
+      @session.should_not have_text('count', between: 3..10)
+      @session.should_not have_text(/count/, between: 2...2)
+    end
+  end
+
+  context "with count" do
+    it "should be true if the text occurs the given number of times" do
+      @session.visit('/with_count')
+      @session.should have_text('count', count: 2)
+    end
+
+    it "should be false if the text occurs a different number of times than the given" do
+      @session.visit('/with_count')
+      @session.should_not have_text('count', count: 0)
+      @session.should_not have_text('count', count: 1)
+      @session.should_not have_text(/count/, count: 3)
+    end
+
+    it "should coerce count to an integer" do
+      @session.visit('/with_count')
+      @session.should have_text('count', count: '2')
+      @session.should_not have_text('count', count: '3')
+    end
+  end
+
+  context "with maximum" do
+    it "should be true when text occurs same or fewer times than given" do
+      @session.visit('/with_count')
+      @session.should have_text('count', maximum: 2)
+      @session.should have_text(/count/, maximum: 3)
+    end
+
+    it "should be false when text occurs more times than given" do
+      @session.visit('/with_count')
+      @session.should_not have_text('count', maximum: 1)
+      @session.should_not have_text('count', maximum: 0)
+    end
+
+    it "should coerce maximum to an integer" do
+      @session.visit('/with_count')
+      @session.should have_text('count', maximum: '2')
+      @session.should_not have_text('count', maximum: '1')
+    end
+  end
+
+  context "with minimum" do
+    it "should be true when text occurs same or more times than given" do
+      @session.visit('/with_count')
+      @session.should have_text('count', minimum: 2)
+      @session.should have_text(/count/, minimum: 0)
+    end
+
+    it "should be false when text occurs fewer times than given" do
+      @session.visit('/with_count')
+      @session.should_not have_text('count', minimum: 3)
+    end
+
+    it "should coerce minimum to an integer" do
+      @session.visit('/with_count')
+      @session.should have_text('count', minimum: '2')
+      @session.should_not have_text('count', minimum: '3')
+    end
+  end
 end
 
 Capybara::SpecHelper.spec '#has_no_text?' do
@@ -172,6 +257,17 @@ Capybara::SpecHelper.spec '#has_no_text?' do
     @session.should have_no_text('Inside element with hidden ancestor')
   end
 
+  it "should be false if :all given and text is invisible." do
+    @session.visit('/with_html')
+    @session.should_not have_no_text(:all, 'Some of this text is hidden!')
+  end
+
+  it "should be false if `Capybara.ignore_hidden_elements = true` and text is invisible." do
+    Capybara.ignore_hidden_elements = false
+    @session.visit('/with_html')
+    @session.should_not have_no_text('Some of this text is hidden!')
+  end
+
   it "should be true if the text in the page doesn't match given regexp" do
     @session.visit('/with_html')
     @session.should have_no_text(/xxxxyzzz/)

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

@@ -0,0 +1,47 @@
+Capybara::SpecHelper.spec '#has_title?' do
+  before do
+    @session.visit('/with_js')
+  end
+
+  it "should be true if the page has the given title" do
+    @session.should have_title('with_js')
+  end
+
+  it "should allow regexp matches" do
+    @session.should have_title(/w[a-z]{3}_js/)
+    @session.should_not have_title(/monkey/)
+  end
+
+  it "should wait for title", :requires => [:js] do
+    @session.click_link("Change title")
+    @session.should have_title("changed title")
+  end
+
+  it "should be false if the page has not the given title" do
+    @session.should_not have_title('monkey')
+  end
+end
+
+Capybara::SpecHelper.spec '#has_no_title?' do
+  before do
+    @session.visit('/with_js')
+  end
+
+  it "should be false if the page has the given title" do
+    @session.should_not have_no_title('with_js')
+  end
+
+  it "should allow regexp matches" do
+    @session.should_not have_no_title(/w[a-z]{3}_js/)
+    @session.should have_no_title(/monkey/)
+  end
+
+  it "should wait for title to disappear", :requires => [:js] do
+    @session.click_link("Change title")
+    @session.should have_no_title('with_js')
+  end
+
+  it "should be true if the page has not the given title" do
+    @session.should have_no_title('monkey')
+  end
+end

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

@@ -57,6 +57,11 @@ Capybara::SpecHelper.spec "node" do
     it "should not swallow extra newlines in textarea" do
       @session.find('//textarea[@id="additional_newline"]').value.should == "\nbanana"
     end
+
+    it "return any HTML content in textarea" do
+      @session.find('//textarea[1]').set("some <em>html</em> here")
+      @session.find('//textarea[1]').value.should == "some <em>html</em> here"
+    end
   end
 
   describe "#set" do
@@ -71,6 +76,18 @@ Capybara::SpecHelper.spec "node" do
       @session.first('//input').set('')
       @session.first('//input').value.should == ''
     end
+
+    it "should not set if the text field is readonly" do
+      @session.first('//input[@readonly]').value.should == 'should not change'
+      @session.first('//input[@readonly]').set('changed')
+      @session.first('//input[@readonly]').value.should == 'should not change'
+    end
+
+    it "should not set if the textarea is readonly" do
+      @session.first('//textarea[@readonly]').value.should == 'textarea should not change'
+      @session.first('//textarea[@readonly]').set('changed')
+      @session.first('//textarea[@readonly]').value.should == 'textarea should not change'
+    end
   end
 
   describe "#tag_name" do
@@ -81,8 +98,29 @@ Capybara::SpecHelper.spec "node" do
     end
   end
 
+  describe "#disabled?" do
+    it "should extract disabled node" do
+      @session.visit('/form')
+      @session.find('//input[@id="customer_name"]').should be_disabled
+      @session.find('//input[@id="customer_email"]').should_not be_disabled
+    end
+
+    it "should see disabled options as disabled" do
+      @session.visit('/form')
+      @session.find('//select[@id="form_title"]/option[1]').should_not be_disabled
+      @session.find('//select[@id="form_title"]/option[@disabled]').should be_disabled
+    end
+
+    it "should see enabled options in disabled select as disabled" do
+      @session.visit('/form')
+      @session.find('//select[@id="form_disabled_select"]/option').should be_disabled
+      @session.find('//select[@id="form_title"]/option[1]').should_not be_disabled
+    end
+  end
+
   describe "#visible?" do
     it "should extract node visibility" do
+      Capybara.ignore_hidden_elements = false
       @session.first('//a').should be_visible
 
       @session.find('//div[@id="hidden"]').should_not be_visible
@@ -138,6 +176,16 @@ Capybara::SpecHelper.spec "node" do
     end
   end
 
+  describe '#hover', :requires => [:hover] do
+    it "should allow hovering on an element" do
+      pending "Selenium with firefox doesn't currently work with this (selenium with chrome does)" if @session.respond_to?(:mode) && @session.mode == :selenium && @session.driver.browser.browser == :firefox
+      @session.visit('/with_hover')
+      @session.find(:css,'.hidden_until_hover', :visible => false).should_not be_visible
+      @session.find(:css,'.wrapper').hover
+      @session.find(:css, '.hidden_until_hover', :visible => false).should be_visible
+    end
+  end
+
   describe '#reload', :requires => [:js] do
     context "without automatic reload" do
       before { Capybara.automatic_reload = false }

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

@@ -31,12 +31,20 @@ Capybara::SpecHelper.spec '#reset_session!' do
     @session.should have_no_selector('.//h1')
   end
 
-  it "raises any errors caught inside the server" do
+  it "raises any errors caught inside the server", :requires => [:server] do
+    quietly { @session.visit("/error") }
     expect do
-      quietly { @session.visit("/error") }
       @session.reset_session!
     end.to raise_error(TestApp::TestAppError)
     @session.visit("/")
     @session.current_path.should == "/"
   end
+
+  it "ignores server errors when `Capybara.raise_server_errors = false`", :requires => [:server] do
+    Capybara.raise_server_errors = false
+    quietly { @session.visit("/error") }
+    @session.reset_session!
+    @session.visit("/")
+    @session.current_path.should == "/"
+  end
 end

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

@@ -43,4 +43,34 @@ Capybara::SpecHelper.spec '#save_page' do
     filename = path.split("/").last
     result.should == filename
   end
+
+  context "asset_host contains a string" do
+    before { Capybara.asset_host = "http://example.com" }
+    after { Capybara.asset_host = nil }
+
+    it "prepends base tag with value from asset_host to the head" do
+      @session.visit("/with_js")
+      path = @session.save_page
+
+      result = File.read(path)
+      result.should include("<head><base href='http://example.com' />")
+    end
+
+    it "doesn't prepend base tag to pages when asset_host is nil" do
+      Capybara.asset_host = nil
+      @session.visit("/with_js")
+      path = @session.save_page
+
+      result = File.read(path)
+      result.should_not include("http://example.com")
+    end
+
+    it "doesn't prepend base tag to pages which already have it" do
+      @session.visit("/with_base_tag")
+      path = @session.save_page
+
+      result = File.read(path)
+      result.should_not include("http://example.com")
+    end
+  end
 end

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

@@ -12,6 +12,29 @@ Capybara::SpecHelper.spec "#select" do
     @session.find_field('Title').value.should == 'Miss'
   end
 
+  it "should allow selecting options where there are inexact matches" do
+    @session.select("Mr", :from => 'Title')
+    @session.find_field('Title').value.should == 'Mr'
+  end
+
+  it "should allow selecting options where they are the only inexact match" do
+    @session.select("Mis", :from => 'Title')
+    @session.find_field('Title').value.should == 'Miss'
+  end
+
+  it "should not allow selecting options where they are the only inexact match if `Capybara.exact_options = true`" do
+    Capybara.exact_options = true
+    expect do
+      @session.select("Mis", :from => 'Title')
+    end.to raise_error(Capybara::ElementNotFound)
+  end
+
+  it "should not allow selecting an option if the match is ambiguous" do
+    expect do
+      @session.select("M", :from => 'Title')
+    end.to raise_error(Capybara::Ambiguous)
+  end
+
   it "should return the value attribute rather than content if present" do
     @session.find_field('Locale').value.should == 'en'
   end
@@ -121,4 +144,46 @@ Capybara::SpecHelper.spec "#select" do
       @session.find_field('Underwear').value.should include('thermal')
     end
   end
+
+  context "with :exact option" do
+    context "when `false`" do
+      it "can match select box approximately" do
+        @session.select("Finish", :from => "Loc", :exact => false)
+        @session.click_button("awesome")
+        extract_results(@session)["locale"].should == "fi"
+      end
+
+      it "can match option approximately" do
+        @session.select("Fin", :from => "Locale", :exact => false)
+        @session.click_button("awesome")
+        extract_results(@session)["locale"].should == "fi"
+      end
+
+      it "can match option approximately when :from not given" do
+        @session.select("made-up language", :exact => false)
+        @session.click_button("awesome")
+        extract_results(@session)["locale"].should == "jo"
+      end
+    end
+
+    context "when `true`" do
+      it "can match select box approximately" do
+        expect do
+          @session.select("Finish", :from => "Loc", :exact => true)
+        end.to raise_error(Capybara::ElementNotFound)
+      end
+
+      it "can match option approximately" do
+        expect do
+          @session.select("Fin", :from => "Locale", :exact => true)
+        end.to raise_error(Capybara::ElementNotFound)
+      end
+
+      it "can match option approximately when :from not given" do
+        expect do
+          @session.select("made-up language", :exact => true)
+        end.to raise_error(Capybara::ElementNotFound)
+      end
+    end
+  end
 end

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

@@ -4,6 +4,37 @@ Capybara::SpecHelper.spec '#text' do
     @session.text.should == 'Bar'
   end
 
+  it "ignores invisible text by default" do
+    @session.visit('/with_html')
+    @session.find(:id, "hidden-text").text.should == 'Some of this text is'
+  end
+
+  it "shows invisible text if `:all` given" do
+    @session.visit('/with_html')
+    @session.find(:id, "hidden-text").text(:all).should == 'Some of this text is hidden!'
+  end
+
+  it "ignores invisible text if `:visible` given" do
+    Capybara.ignore_hidden_elements = false
+    @session.visit('/with_html')
+    @session.find(:id, "hidden-text").text(:visible).should == 'Some of this text is'
+  end
+
+  it "ignores invisible text if `Capybara.ignore_hidden_elements = true`" do
+    @session.visit('/with_html')
+    @session.find(:id, "hidden-text").text.should == 'Some of this text is'
+    Capybara.ignore_hidden_elements = false
+    @session.find(:id, "hidden-text").text.should == 'Some of this text is hidden!'
+  end
+
+  it "ignores invisible text if `Capybara.visible_text_only = true`" do
+    @session.visit('/with_html')
+    Capybara.visible_text_only = true
+    @session.find(:id, "hidden-text").text.should == 'Some of this text is'
+    Capybara.ignore_hidden_elements = false
+    @session.find(:id, "hidden-text").text.should == 'Some of this text is'
+  end
+
   context "with css as default selector" do
     before { Capybara.default_selector = :css }
     it "should print the text of the page" do

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

@@ -0,0 +1,16 @@
+Capybara::SpecHelper.spec '#title' do
+
+  it "should print the title of the page" do
+    @session.visit('/with_title')
+    @session.title.should == 'Test Title'
+  end
+
+  context "with css as default selector" do
+    before { Capybara.default_selector = :css }
+    it "should print the title of the page" do
+      @session.visit('/with_title')
+      @session.title.should == 'Test Title'
+    end
+    after { Capybara.default_selector = :xpath }
+  end
+end

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

@@ -23,4 +23,18 @@ Capybara::SpecHelper.spec "#uncheck" do
     extract_results(@session)['pets'].should include('dog')
     extract_results(@session)['pets'].should_not include('hamster')
   end
+
+  context "with :exact option" do
+    it "should accept partial matches when false" do
+      @session.uncheck('Ham', :exact => false)
+      @session.click_button('awesome')
+      extract_results(@session)['pets'].should_not include('hamster')
+    end
+
+    it "should not accept partial matches when true" do
+      expect do
+        @session.uncheck('Ham', :exact => true)
+      end.to raise_error(Capybara::ElementNotFound)
+    end
+  end
 end

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

@@ -69,4 +69,46 @@ Capybara::SpecHelper.spec "#unselect" do
       end.to raise_error(Capybara::ElementNotFound, msg)
     end
   end
+
+  context "with :exact option" do
+    context "when `false`" do
+      it "can match select box approximately" do
+        @session.unselect("Boxerbriefs", :from => "Under", :exact => false)
+        @session.click_button("awesome")
+        extract_results(@session)["underwear"].should_not include("Boxerbriefs")
+      end
+
+      it "can match option approximately" do
+        @session.unselect("Boxerbr", :from => "Underwear", :exact => false)
+        @session.click_button("awesome")
+        extract_results(@session)["underwear"].should_not include("Boxerbriefs")
+      end
+
+      it "can match option approximately when :from not given" do
+        @session.unselect("Boxerbr", :exact => false)
+        @session.click_button("awesome")
+        extract_results(@session)["underwear"].should_not include("Boxerbriefs")
+      end
+    end
+
+    context "when `true`" do
+      it "can match select box approximately" do
+        expect do
+          @session.unselect("Boxerbriefs", :from => "Under", :exact => true)
+        end.to raise_error(Capybara::ElementNotFound)
+      end
+
+      it "can match option approximately" do
+        expect do
+          @session.unselect("Boxerbr", :from => "Underwear", :exact => true)
+        end.to raise_error(Capybara::ElementNotFound)
+      end
+
+      it "can match option approximately when :from not given" do
+        expect do
+          @session.unselect("Boxerbr", :exact => true)
+        end.to raise_error(Capybara::ElementNotFound)
+      end
+    end
+  end
 end

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

@@ -72,18 +72,18 @@ Capybara::SpecHelper.spec '#visit' do
   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}
+    @session.should have_content %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}
+    @session.should have_content %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}
+    @session.should have_content %r{http://.*/referer_base}
   end
 end

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

@@ -28,4 +28,18 @@ Capybara::SpecHelper.spec '#within_frame', :requires => [:frames] do
   it "should return the result of executing the block" do
     @session.within_frame("frameOne") { "return value" }.should eql "return value"
   end
+  it "should find the div given Element" do
+    element = @session.find(:id, 'frameOne')
+    @session.within_frame element do
+      @session.find("//*[@id='divInFrameOne']").text.should eql 'This is the text of divInFrameOne'
+    end
+  end
+  it "should find multiple nested frames" do
+    @session.within_frame 'parentFrame' do
+      @session.within_frame 'childFrame' do
+        @session.within_frame 'grandchildFrame1' do end
+        @session.within_frame 'grandchildFrame2' do end
+      end    
+    end
+  end
 end

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

@@ -5,7 +5,7 @@ Capybara::SpecHelper.spec '#within' do
 
   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.within(:css, "#for_bar li", text: 'With Simple HTML') do
         @session.click_link('Go')
       end
       @session.should have_content('Bar')
@@ -46,7 +46,7 @@ Capybara::SpecHelper.spec '#within' do
 
   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')]")
+      node_of_interest = @session.find(:css, "#for_bar li", text: 'With Simple HTML')
 
       @session.within(node_of_interest) do
         @session.click_link('Go')
@@ -58,7 +58,7 @@ Capybara::SpecHelper.spec '#within' do
   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.within("#for_bar li", text: 'With Simple HTML') do
         @session.click_link('Go')
       end
       @session.should have_content('Bar')