capybara 2.3.0 → 2.4.0

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

@@ -0,0 +1,195 @@
+Capybara::SpecHelper.spec '#assert_text' do
+  it "should be true if the given text is on the page" do
+    @session.visit('/with_html')
+    expect(@session.assert_text('est')).to eq(true)
+    expect(@session.assert_text('Lorem')).to eq(true)
+    expect(@session.assert_text('Redirect')).to eq(true)
+    expect(@session.assert_text(:'Redirect')).to eq(true)
+    expect(@session.assert_text('text with whitespace')).to eq(true)
+    expect(@session.assert_text("text     with \n\n whitespace")).to eq(true)
+  end
+
+  it "should take scopes into account" do
+    @session.visit('/with_html')
+    @session.within("//a[@title='awesome title']") do
+      expect(@session.assert_text('labore')).to eq(true)
+    end
+  end
+
+  it "should raise if scoped to an element which does not have the text" do
+    @session.visit('/with_html')
+    @session.within("//a[@title='awesome title']") do
+      expect do
+        @session.assert_text('monkey')
+      end.to raise_error(Capybara::ExpectationNotMet, 'expected to find text "monkey" in "labore"')
+    end
+  end
+
+  it "should be true if :all given and text is invisible." do
+    @session.visit('/with_html')
+    expect(@session.assert_text(:all, 'Some of this text is hidden!')).to eq(true)
+  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')
+    expect(@session.assert_text('Some of this text is hidden!')).to eq(true)
+  end
+
+  it "should be true if the text in the page matches given regexp" do
+    @session.visit('/with_html')
+    expect(@session.assert_text(/Lorem/)).to eq(true)
+  end
+
+  it "should be raise error if the text in the page doesn't match given regexp" do
+    @session.visit('/with_html')
+    expect do
+      @session.assert_text(/xxxxyzzz/)
+    end.to raise_error(Capybara::ExpectationNotMet, /\Aexpected to find text matching \/xxxxyzzz\/ in "This is a test Header Class(.+)"\Z/)
+  end
+
+  it "should escape any characters that would have special meaning in a regexp" do
+    @session.visit('/with_html')
+    expect do
+      @session.assert_text('.orem')
+    end.to raise_error(Capybara::ExpectationNotMet)
+  end
+
+  it "should wait for text to appear", :requires => [:js] do
+    @session.visit('/with_js')
+    @session.click_link('Click me')
+    expect(@session.assert_text('Has been clicked')).to eq(true)
+  end
+
+  context "with between" do
+    it "should be true if the text occurs within the range given" do
+      @session.visit('/with_count')
+      expect(@session.assert_text('count', between: 1..3)).to eq(true)
+    end
+
+    it "should be false if the text occurs more or fewer times than range" do
+      @session.visit('/with_html')
+      expect do
+        @session.find(:css, '.number').assert_text(/\d/, between: 0..1)
+      end.to raise_error(Capybara::ExpectationNotMet, "expected to find text matching /\\d/ between 0 and 1 times but found 2 times in \"42\"")
+    end
+  end
+
+  context "with wait", :requires => [:js] do
+    it "should find element if it appears before given wait duration" do
+      Capybara.using_wait_time(0) do
+        @session.visit('/with_js')
+        @session.find(:css, '#reload-list').click
+        @session.find(:css, '#the-list').assert_text('Foo Bar', wait: 0.9)
+      end
+    end
+
+    it "should raise error if it appears after given wait duration" do
+      Capybara.using_wait_time(0) do
+        @session.visit('/with_js')
+        @session.find(:css, '#reload-list').click
+        el = @session.find(:css, '#the-list', visible: false)
+        expect do
+          el.assert_text(:all, 'Foo Bar', wait: 0.3)
+        end.to raise_error(Capybara::ExpectationNotMet)
+      end
+    end
+  end
+
+  context 'with multiple count filters' do
+    before(:each) do
+      @session.visit('/with_html')
+    end
+
+    it 'ignores other filters when :count is specified' do
+      o = {:count   => 5,
+           :minimum => 6,
+           :maximum => 0,
+           :between => 0..4}
+      expect { @session.assert_text('Header', o) }.not_to raise_error
+    end
+    context 'with no :count expectation' do
+      it 'fails if :minimum is not met' do
+        o = {:minimum => 6,
+             :maximum => 5,
+             :between => 2..7}
+        expect { @session.assert_text('Header', o) }.to raise_error(Capybara::ExpectationNotMet)
+      end
+      it 'fails if :maximum is not met' do
+        o = {:minimum => 0,
+             :maximum => 0,
+             :between => 2..7}
+        expect { @session.assert_text('Header', o) }.to raise_error(Capybara::ExpectationNotMet)
+      end
+      it 'fails if :between is not met' do
+        o = {:minimum => 0,
+             :maximum => 5,
+             :between => 0..4}
+        expect { @session.assert_text('Header', o) }.to raise_error(Capybara::ExpectationNotMet)
+      end
+      it 'succeeds if all combineable expectations are met' do
+        o = {:minimum => 0,
+             :maximum => 5,
+             :between => 2..7}
+        expect { @session.assert_text('Header', o) }.not_to raise_error
+      end
+    end
+  end
+end
+
+Capybara::SpecHelper.spec '#assert_no_text' do
+  it "should raise error if the given text is on the page at least once" do
+    @session.visit('/with_html')
+    expect do
+      @session.assert_no_text('Lorem')
+    end.to raise_error(Capybara::ExpectationNotMet, /\Aexpected not to find text "Lorem" in "This is a test Header Class.+"\Z/)
+  end
+
+  it "should be true if scoped to an element which does not have the text" do
+    @session.visit('/with_html')
+    @session.within("//a[@title='awesome title']") do
+      expect(@session.assert_no_text('monkey')).to eq(true)
+    end
+  end
+
+  it "should be true if the given text is on the page but not visible" do
+    @session.visit('/with_html')
+    expect(@session.assert_no_text('Inside element with hidden ancestor')).to eq(true)
+  end
+
+  it "should raise error if :all given and text is invisible." do
+    @session.visit('/with_html')
+    el = @session.find(:css, '#hidden-text', visible: false)
+    expect do
+      el.assert_no_text(:all, 'Some of this text is hidden!')
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected not to find text "Some of this text is hidden!" in "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.assert_no_text(/xxxxyzzz/)
+  end
+
+  context "with count" do
+    it "should be true if the text occurs within the range given" do
+      @session.visit('/with_count')
+      expect(@session.assert_text('count', count: 2)).to eq(true)
+    end
+
+    it "should be false if the text occurs more or fewer times than range" do
+      @session.visit('/with_html')
+      expect do
+        @session.find(:css, '.number').assert_text(/\d/, count: 1)
+      end.to raise_error(Capybara::ExpectationNotMet, "expected to find text matching /\\d/ 1 time but found 2 times in \"42\"")
+    end
+  end
+
+  context "with wait", :requires => [:js] do
+    it "should not find element if it appears after given wait duration" do
+      @session.visit('/with_js')
+      @session.click_link('Click me')
+      @session.find(:css, '#reload-list').click
+      @session.find(:css, '#the-list').assert_no_text('Foo Bar', :wait => 0.4)
+    end
+  end
+end

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

@@ -0,0 +1,69 @@
+Capybara::SpecHelper.spec '#assert_title' do
+  before do
+    @session.visit('/with_js')
+  end
+
+  it "should be true if the page's title contains the given string" do
+    expect(@session.assert_title('js')).to eq(true)
+  end
+
+  it "should be true when given an empty string" do
+    expect(@session.assert_title('')).to eq(true)
+  end
+
+  it "should allow regexp matches" do
+    expect(@session.assert_title(/w[a-z]{3}_js/)).to eq(true)
+    expect do
+      @session.assert_title(/w[a-z]{10}_js/)
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected "with_js" to match /w[a-z]{10}_js/')
+  end
+
+  it "should wait for title", :requires => [:js] do
+    @session.click_link("Change title")
+    expect(@session.assert_title("changed title")).to eq(true)
+  end
+
+  it "should raise error if the title doesn't contain the given string" do
+    expect do
+      @session.assert_title('monkey')
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected "with_js" to include "monkey"')
+  end
+
+  it "should normalize given title" do
+    @session.assert_title('  with_js  ')
+  end
+
+  it "should normalize given title in error message" do
+    expect do
+      @session.assert_title(2)
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected "with_js" to include "2"')
+  end
+end
+
+Capybara::SpecHelper.spec '#assert_no_title' do
+  before do
+    @session.visit('/with_js')
+  end
+
+  it "should raise error if the title contains the given string" do
+    expect do
+      @session.assert_no_title('with_j')
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected "with_js" not to include "with_j"')
+  end
+
+  it "should allow regexp matches" do
+    expect do
+      @session.assert_no_title(/w[a-z]{3}_js/)
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected "with_js" not to match /w[a-z]{3}_js/')
+    @session.assert_no_title(/monkey/)
+  end
+
+  it "should wait for title to disappear", :requires => [:js] do
+    @session.click_link("Change title")
+    expect(@session.assert_no_title('with_js')).to eq(true)
+  end
+
+  it "should be true if the title doesn't contain the given string" do
+    expect(@session.assert_no_title('monkey')).to eq(true)
+  end
+end

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

@@ -0,0 +1,35 @@
+Capybara::SpecHelper.spec '#dismiss_confirm', :requires => [:modals] do
+  before do
+    @session.visit('/with_js')
+  end
+
+  it "should dismiss the confirm" do
+    @session.dismiss_confirm do
+      @session.click_link('Open confirm')
+    end
+    expect(@session).to have_xpath("//a[@id='open-confirm' and @confirmed='false']")
+  end
+  
+  it "should dismiss the confirm if the message matches" do
+    @session.dismiss_confirm 'Confirm opened' do
+      @session.click_link('Open confirm')
+    end
+    expect(@session).to have_xpath("//a[@id='open-confirm' and @confirmed='false']")
+  end
+  
+  it "should not dismiss the confirm if the message doesn't match" do
+    expect do
+      @session.dismiss_confirm 'Incorrect Text' do
+        @session.click_link('Open confirm')
+      end
+    end.to raise_error(Capybara::ModalNotFound)
+  end
+    
+
+  it "should return the message presented" do
+    message = @session.dismiss_confirm do
+      @session.click_link('Open confirm')
+    end
+    expect(message).to eq('Confirm opened')
+  end
+end

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

@@ -0,0 +1,19 @@
+Capybara::SpecHelper.spec '#dismiss_prompt', :requires => [:modals] do
+  before do
+    @session.visit('/with_js')
+  end
+
+  it "should dismiss the prompt" do
+    @session.dismiss_prompt do
+      @session.click_link('Open prompt')
+    end
+    expect(@session).to have_xpath("//a[@id='open-prompt' and @response='dismissed']")
+  end
+  
+  it "should return the message presented" do
+    message = @session.dismiss_prompt do
+      @session.click_link('Open prompt')
+    end
+    expect(message).to eq('Prompt opened')
+  end
+end

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

@@ -19,6 +19,12 @@ Capybara::SpecHelper.spec '#find_field' do
     end.to raise_error(Capybara::ElementNotFound)
   end
 
+  it "should warn if filter option is invalid" do
+    expect_any_instance_of(Kernel).to receive(:warn).
+      with('Invalid value nil passed to filter disabled')
+    @session.find_field('Dog', disabled: nil)
+  end
+
   it "should be aliased as 'field_labeled' for webrat compatibility" do
     expect(@session.field_labeled('Dog').value).to eq('dog')
     expect do

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

@@ -106,7 +106,7 @@ Capybara::SpecHelper.spec '#has_text?' do
   end
 
   it "should be true when passed nil" do
-    # Historical behavior; no particular reason other than compatibility.
+    # nil is converted to '' when to_s is invoked
     @session.visit('/with_html')
     expect(@session).to have_text(nil)
   end

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

@@ -97,6 +97,10 @@ Capybara::SpecHelper.spec "node" do
       @session.first('//input[@readonly]').set('changed')
       expect(@session.first('//input[@readonly]').value).to eq('should not change')
     end
+    
+    it "should raise if the text field is readonly" do
+      expect(@session.first('//input[@readonly]').set('changed')).to raise_error(Capybara::ReadOnlyElementError)
+    end if Capybara::VERSION.to_f > 3.0
 
     it "should not set if the textarea is readonly" do
       expect(@session.first('//textarea[@readonly]').value).to eq('textarea should not change')
@@ -104,6 +108,10 @@ Capybara::SpecHelper.spec "node" do
       expect(@session.first('//textarea[@readonly]').value).to eq('textarea should not change')
     end
 
+    it "should raise if the text field is readonly" do
+      expect(@session.first('//textarea[@readonly]').set('changed')).to raise_error(Capybara::ReadOnlyElementError)
+    end if Capybara::VERSION.to_f > 3.0
+
     it 'should allow me to change the contents of a contenteditable element', :requires => [:js] do
       @session.visit('/with_js')
       @session.find(:css,'#existing_content_editable').set('WYSIWYG')
@@ -221,6 +229,13 @@ Capybara::SpecHelper.spec "node" do
     end
   end
   
+  describe '#click' do
+    it "should not follow a link if no href" do
+      @session.find(:css, '#link_placeholder').click
+      expect(@session.current_url).to match(%r{/with_html$})
+    end
+  end
+  
   describe '#double_click', :requires => [:js] do
     it "should double click an element" do
       @session.visit('/with_js')
@@ -230,7 +245,7 @@ Capybara::SpecHelper.spec "node" do
   end
 
   describe '#right_click', :requires => [:js] do
-    it "should double click an element" do
+    it "should right click an element" do
       @session.visit('/with_js')
       @session.find(:css, '#click-test').right_click
       expect(@session.find(:css, '#has-been-right-clicked')).to be

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

@@ -6,7 +6,7 @@ Capybara::SpecHelper.spec '#save_and_open_screenshot' do
   end
 
   it 'opens file from the default directory', :requires => [:screenshot] do
-    expected_file_regex = %r{capybara/capybara-\d+\.png}
+    expected_file_regex = %r{capybara-\d+\.png}
     allow(@session.driver).to receive(:save_screenshot)
     allow(Launchy).to receive(:open)
 

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

@@ -33,6 +33,11 @@ Capybara::SpecHelper.spec '#visit' do
     end.to raise_error(TestApp::TestAppError)
   end
 
+  it "should be able to open non-http url", requires: [:about_scheme] do
+    @session.visit("about:blank")
+    @session.assert_no_selector :xpath, "/html/body/*"
+  end
+
   context "when Capybara.always_include_port is true" do
 
     let(:root_uri) do

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

@@ -107,3 +107,7 @@ banana</textarea>
 </div>
 
 <input type="text" disabled="disabled" name="disabled_text" value="This is disabled"/>
+
+<div>
+  <a id="link_placeholder">No href</a>
+</div>

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

@@ -72,6 +72,23 @@
         
     <p id="click-test">Click me</p>
 
+    <p>
+      <a href="#" id="open-alert">Open alert</a>
+    </p>
+
+    <p>
+      <a href="#" id="open-delayed-alert">Open delayed alert</a>
+      <a href="#" id="open-slow-alert">Open slow alert</a>
+    </p>
+
+    <p>
+      <a href="#" id="open-confirm">Open confirm</a>
+    </p>
+
+    <p>
+      <a href="#" id="open-prompt">Open prompt</a>
+    </p>
+
     <script type="text/javascript">
       // a javascript comment
       var aVar = 123;

data/lib/capybara/version.rb

@@ -1,3 +1,3 @@
 module Capybara
-  VERSION = '2.3.0'
+  VERSION = '2.4.0'
 end