capybara 1.1.4 → 2.0.0

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

@@ -0,0 +1,195 @@
+Capybara::SpecHelper.spec '#has_text?' do
+  it "should be true if the given text is on the page at least once" do
+    @session.visit('/with_html')
+    @session.should have_text('est')
+    @session.should have_text('Lorem')
+    @session.should have_text('Redirect')
+    @session.should have_text(:'Redirect')
+  end
+
+  it "should be true if scoped to an element which has the text" do
+    @session.visit('/with_html')
+    @session.within("//a[@title='awesome title']") do
+      @session.should have_text('labore')
+    end
+  end
+
+  it "should be false if scoped to an element which does not have the text" do
+    @session.visit('/with_html')
+    @session.within("//a[@title='awesome title']") do
+      @session.should_not have_text('monkey')
+    end
+  end
+
+  it "should ignore tags" do
+    @session.visit('/with_html')
+    @session.should_not have_text('exercitation <a href="/foo" id="foo">ullamco</a> laboris')
+    @session.should have_text('exercitation ullamco laboris')
+  end
+
+  it "should ignore extra whitespace and newlines" do
+    @session.visit('/with_html')
+    @session.should have_text('text with whitespace')
+  end
+
+  it "should ignore whitespace and newlines in the search string" do
+    @session.visit('/with_html')
+    @session.should have_text("text     with \n\n whitespace")
+  end
+
+  it "should be false if the given text is not on the page" do
+    @session.visit('/with_html')
+    @session.should_not have_text('xxxxyzzz')
+    @session.should_not have_text('monkey')
+  end
+
+  it 'should handle single quotes in the text' do
+    @session.visit('/with-quotes')
+    @session.should have_text("can't")
+  end
+
+  it 'should handle double quotes in the text' do
+    @session.visit('/with-quotes')
+    @session.should have_text(%q{"No," he said})
+  end
+
+  it 'should handle mixed single and double quotes in the text' do
+    @session.visit('/with-quotes')
+    @session.should have_text(%q{"you can't do that."})
+  end
+
+  it 'should be false if text is in the title tag in the head' do
+    @session.visit('/with_js')
+    @session.should_not have_text('with_js')
+  end
+
+  it 'should be false if text is inside a script tag in the body' do
+    @session.visit('/with_js')
+    @session.should_not have_text('a javascript comment')
+    @session.should_not have_text('aVar')
+  end
+
+  it "should be false if the given text is on the page but not visible" do
+    @session.visit('/with_html')
+    @session.should_not have_text('Inside element with hidden ancestor')
+  end
+
+  it "should be true if the text in the page matches given regexp" do
+    @session.visit('/with_html')
+    @session.should have_text(/Lorem/)
+  end
+
+  it "should be false if the text in the page doesn't match given regexp" do
+    @session.visit('/with_html')
+    @session.should_not have_text(/xxxxyzzz/)
+  end
+
+  it "should escape any characters that would have special meaning in a regexp" do
+    @session.visit('/with_html')
+    @session.should_not have_text('.orem')
+  end
+
+  it "should accept non-string parameters" do
+    @session.visit('/with_html')
+    @session.should have_text(42)
+  end
+
+  it "should be true when passed nil" do
+    # Historical behavior; no particular reason other than compatibility.
+    @session.visit('/with_html')
+    @session.should have_text(nil)
+  end
+
+  it "should wait for text to appear", :requires => [:js] do
+    @session.visit('/with_js')
+    @session.click_link('Click me')
+    @session.should have_text("Has been clicked")
+  end
+end
+
+Capybara::SpecHelper.spec '#has_no_text?' do
+  it "should be false if the given text is on the page at least once" do
+    @session.visit('/with_html')
+    @session.should_not have_no_text('est')
+    @session.should_not have_no_text('Lorem')
+    @session.should_not have_no_text('Redirect')
+  end
+
+  it "should be false if scoped to an element which has the text" do
+    @session.visit('/with_html')
+    @session.within("//a[@title='awesome title']") do
+      @session.should_not have_no_text('labore')
+    end
+  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
+      @session.should have_no_text('monkey')
+    end
+  end
+
+  it "should ignore tags" do
+    @session.visit('/with_html')
+    @session.should have_no_text('exercitation <a href="/foo" id="foo">ullamco</a> laboris')
+    @session.should_not have_no_text('exercitation ullamco laboris')
+  end
+
+  it "should be true if the given text is not on the page" do
+    @session.visit('/with_html')
+    @session.should have_no_text('xxxxyzzz')
+    @session.should have_no_text('monkey')
+  end
+
+  it 'should handle single quotes in the text' do
+    @session.visit('/with-quotes')
+    @session.should_not have_no_text("can't")
+  end
+
+  it 'should handle double quotes in the text' do
+    @session.visit('/with-quotes')
+    @session.should_not have_no_text(%q{"No," he said})
+  end
+
+  it 'should handle mixed single and double quotes in the text' do
+    @session.visit('/with-quotes')
+    @session.should_not have_no_text(%q{"you can't do that."})
+  end
+
+  it 'should be true if text is in the title tag in the head' do
+    @session.visit('/with_js')
+    @session.should have_no_text('with_js')
+  end
+
+  it 'should be true if text is inside a script tag in the body' do
+    @session.visit('/with_js')
+    @session.should have_no_text('a javascript comment')
+    @session.should have_no_text('aVar')
+  end
+
+  it "should be true if the given text is on the page but not visible" do
+    @session.visit('/with_html')
+    @session.should have_no_text('Inside element with hidden ancestor')
+  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/)
+  end
+
+  it "should be false if the text in the page  matches given regexp" do
+    @session.visit('/with_html')
+    @session.should_not have_no_text(/Lorem/)
+  end
+
+  it "should escape any characters that would have special meaning in a regexp" do
+    @session.visit('/with_html')
+    @session.should have_no_text('.orem')
+  end
+
+  it "should wait for text to disappear", :requires => [:js] do
+    @session.visit('/with_js')
+    @session.click_link('Click me')
+    @session.should have_no_text("I changed it")
+  end
+end

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

@@ -1,123 +1,127 @@
-shared_examples_for "has_xpath" do  
-  describe '#has_xpath?' do
-    before do
-      @session.visit('/with_html')
-    end
+Capybara::SpecHelper.spec '#has_xpath?' do
+  before do
+    @session.visit('/with_html')
+  end
+
+  it "should be true if the given selector is on the page" do
+    @session.should have_xpath("//p")
+    @session.should have_xpath("//p//a[@id='foo']")
+    @session.should have_xpath("//p[contains(.,'est')]")
+  end
 
-    it "should be true if the given selector is on the page" do
-      @session.should have_xpath("//p")
-      @session.should have_xpath("//p//a[@id='foo']")
-      @session.should have_xpath("//p[contains(.,'est')]")
+  it "should be false if the given selector is not on the page" do
+    @session.should_not have_xpath("//abbr")
+    @session.should_not have_xpath("//p//a[@id='doesnotexist']")
+    @session.should_not have_xpath("//p[contains(.,'thisstringisnotonpage')]")
+  end
+
+  it "should use xpath even if default selector is CSS" do
+    Capybara.default_selector = :css
+    @session.should_not have_xpath("//p//a[@id='doesnotexist']")
+  end
+
+  it "should respect scopes" do
+    @session.within "//p[@id='first']" do
+      @session.should have_xpath(".//a[@id='foo']")
+      @session.should_not have_xpath(".//a[@id='red']")
     end
+  end
+
+  it "should wait for content to appear", :requires => [:js] do
+    @session.visit('/with_js')
+    @session.click_link('Click me')
+    @session.should have_xpath("//input[@type='submit' and @value='New Here']")
+  end
 
-    it "should be false if the given selector is not on the page" do
-      @session.should_not have_xpath("//abbr")
-      @session.should_not have_xpath("//p//a[@id='doesnotexist']")
-      @session.should_not have_xpath("//p[contains(.,'thisstringisnotonpage')]")
+  context "with count" do
+    it "should be true if the content occurs the given number of times" do
+      @session.should have_xpath("//p", :count => 3)
+      @session.should have_xpath("//p//a[@id='foo']", :count => 1)
+      @session.should have_xpath("//p[contains(.,'est')]", :count => 1)
+      @session.should have_xpath("//p//a[@id='doesnotexist']", :count => 0)
     end
 
-    it "should use xpath even if default selector is CSS" do
-      Capybara.default_selector = :css
-      @session.should_not have_xpath("//p//a[@id='doesnotexist']")
+    it "should be false if the content occurs a different number of times than the given" do
+      @session.should_not have_xpath("//p", :count => 6)
+      @session.should_not have_xpath("//p//a[@id='foo']", :count => 2)
+      @session.should_not have_xpath("//p[contains(.,'est')]", :count => 5)
+      @session.should_not have_xpath("//p//a[@id='doesnotexist']", :count => 1)
     end
+  end
 
-    it "should respect scopes" do
-      @session.within "//p[@id='first']" do
-        @session.should have_xpath(".//a[@id='foo']")
-        @session.should_not have_xpath(".//a[@id='red']")
-      end
+  context "with text" do
+    it "should discard all matches where the given string is not contained" do
+      @session.should have_xpath("//p//a", :text => "Redirect", :count => 1)
+      @session.should_not have_xpath("//p", :text => "Doesnotexist")
     end
 
-    context "with count" do
-      it "should be true if the content is on the page the given number of times" do
-        @session.should have_xpath("//p", :count => 3)
-        @session.should have_xpath("//p//a[@id='foo']", :count => 1)
-        @session.should have_xpath("//p[contains(.,'est')]", :count => 1)
-      end
-
-      it "should be false if the content is on the page the given number of times" do
-        @session.should_not have_xpath("//p", :count => 6)
-        @session.should_not have_xpath("//p//a[@id='foo']", :count => 2)
-        @session.should_not have_xpath("//p[contains(.,'est')]", :count => 5)
-      end
-
-      it "should be false if the content isn't on the page at all" do
-        @session.should_not have_xpath("//abbr", :count => 2)
-        @session.should_not have_xpath("//p//a[@id='doesnotexist']", :count => 1)
-      end
+    it "should discard all matches where the given regexp is not matched" do
+      @session.should have_xpath("//p//a", :text => /re[dab]i/i, :count => 1)
+      @session.should_not have_xpath("//p//a", :text => /Red$/)
     end
+  end
+end
 
-    context "with text" do
-      it "should discard all matches where the given string is not contained" do
-        @session.should have_xpath("//p//a", :text => "Redirect", :count => 1)
-        @session.should_not have_xpath("//p", :text => "Doesnotexist")
-      end
+Capybara::SpecHelper.spec '#has_no_xpath?' do
+  before do
+    @session.visit('/with_html')
+  end
 
-      it "should discard all matches where the given regexp is not matched" do
-        @session.should have_xpath("//p//a", :text => /re[dab]i/i, :count => 1)
-        @session.should_not have_xpath("//p//a", :text => /Red$/)
-      end
-    end
+  it "should be false if the given selector is on the page" do
+    @session.should_not have_no_xpath("//p")
+    @session.should_not have_no_xpath("//p//a[@id='foo']")
+    @session.should_not have_no_xpath("//p[contains(.,'est')]")
   end
 
-  describe '#has_no_xpath?' do
-    before do
-      @session.visit('/with_html')
-    end
+  it "should be true if the given selector is not on the page" do
+    @session.should have_no_xpath("//abbr")
+    @session.should have_no_xpath("//p//a[@id='doesnotexist']")
+    @session.should have_no_xpath("//p[contains(.,'thisstringisnotonpage')]")
+  end
 
-    it "should be false if the given selector is on the page" do
-      @session.should_not have_no_xpath("//p")
-      @session.should_not have_no_xpath("//p//a[@id='foo']")
-      @session.should_not have_no_xpath("//p[contains(.,'est')]")
-    end
+  it "should use xpath even if default selector is CSS" do
+    Capybara.default_selector = :css
+    @session.should have_no_xpath("//p//a[@id='doesnotexist']")
+  end
 
-    it "should be true if the given selector is not on the page" do
-      @session.should have_no_xpath("//abbr")
-      @session.should have_no_xpath("//p//a[@id='doesnotexist']")
-      @session.should have_no_xpath("//p[contains(.,'thisstringisnotonpage')]")
+  it "should respect scopes" do
+    @session.within "//p[@id='first']" do
+      @session.should_not have_no_xpath(".//a[@id='foo']")
+      @session.should have_no_xpath(".//a[@id='red']")
     end
+  end
 
-    it "should use xpath even if default selector is CSS" do
-      Capybara.default_selector = :css
-      @session.should have_no_xpath("//p//a[@id='doesnotexist']")
-    end
+  it "should wait for content to disappear", :requires => [:js] do
+    @session.visit('/with_js')
+    @session.click_link('Click me')
+    @session.should have_no_xpath("//p[@id='change']")
+  end
 
-    it "should respect scopes" do
-      @session.within "//p[@id='first']" do
-        @session.should_not have_no_xpath(".//a[@id='foo']")
-        @session.should have_no_xpath(".//a[@id='red']")
-      end
+  context "with count" do
+    it "should be false if the content occurs the given number of times" do
+      @session.should_not have_no_xpath("//p", :count => 3)
+      @session.should_not have_no_xpath("//p//a[@id='foo']", :count => 1)
+      @session.should_not have_no_xpath("//p[contains(.,'est')]", :count => 1)
+      @session.should_not have_no_xpath("//p//a[@id='doesnotexist']", :count => 0)
     end
 
-    context "with count" do
-      it "should be false if the content is on the page the given number of times" do
-        @session.should_not have_no_xpath("//p", :count => 3)
-        @session.should_not have_no_xpath("//p//a[@id='foo']", :count => 1)
-        @session.should_not have_no_xpath("//p[contains(.,'est')]", :count => 1)
-      end
-
-      it "should be true if the content is on the page the wrong number of times" do
-        @session.should have_no_xpath("//p", :count => 6)
-        @session.should have_no_xpath("//p//a[@id='foo']", :count => 2)
-        @session.should have_no_xpath("//p[contains(.,'est')]", :count => 5)
-      end
-
-      it "should be true if the content isn't on the page at all" do
-        @session.should have_no_xpath("//abbr", :count => 2)
-        @session.should have_no_xpath("//p//a[@id='doesnotexist']", :count => 1)
-      end
+    it "should be true if the content occurs a different number of times than the given" do
+      @session.should have_no_xpath("//p", :count => 6)
+      @session.should have_no_xpath("//p//a[@id='foo']", :count => 2)
+      @session.should have_no_xpath("//p[contains(.,'est')]", :count => 5)
+      @session.should have_no_xpath("//p//a[@id='doesnotexist']", :count => 1)
     end
+  end
 
-    context "with text" do
-      it "should discard all matches where the given string is contained" do
-        @session.should_not have_no_xpath("//p//a", :text => "Redirect", :count => 1)
-        @session.should have_no_xpath("//p", :text => "Doesnotexist")
-      end
+  context "with text" do
+    it "should discard all matches where the given string is contained" do
+      @session.should_not have_no_xpath("//p//a", :text => "Redirect", :count => 1)
+      @session.should have_no_xpath("//p", :text => "Doesnotexist")
+    end
 
-      it "should discard all matches where the given regexp is matched" do
-        @session.should_not have_no_xpath("//p//a", :text => /re[dab]i/i, :count => 1)
-        @session.should have_no_xpath("//p//a", :text => /Red$/)
-      end
+    it "should discard all matches where the given regexp is matched" do
+      @session.should_not have_no_xpath("//p//a", :text => /re[dab]i/i, :count => 1)
+      @session.should have_no_xpath("//p//a", :text => /Red$/)
     end
   end
 end

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

@@ -1,19 +1,6 @@
-shared_examples_for "session with headers support" do
-  describe '#response_headers' do
-    it "should return response headers" do
-      @session.visit('/with_simple_html')
-      @session.response_headers['Content-Type'].should =~ %r(text/html)
-    end
-  end
-end
-
-shared_examples_for "session without headers support" do
-  describe "#response_headers" do
-    before{ @session.visit('/with_simple_html') }
-    it "should raise an error" do
-      running {
-        @session.response_headers
-      }.should raise_error(Capybara::NotSupportedByDriverError)
-    end
+Capybara::SpecHelper.spec '#response_headers' do
+  it "should return response headers", :requires => [:response_headers] do
+    @session.visit('/with_simple_html')
+    @session.response_headers['Content-Type'].should =~ %r(text/html)
   end
 end

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

@@ -0,0 +1,15 @@
+Capybara::SpecHelper.spec '#html' do
+  it "should return the unmodified page body" do
+    # html and body should be aliased, but we can't just check for
+    # method(:html) == method(:body) because these shared examples get run
+    # against the DSL, which uses forwarding methods.  So we test behavior.
+    @session.visit('/')
+    @session.html.should include('Hello world!')
+  end
+
+  it "should return the current state of the page", :requires => [:js] do
+    @session.visit('/with_js')
+    @session.html.should include('I changed it')
+    @session.html.should_not include('This is text')
+  end
+end

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

@@ -0,0 +1,205 @@
+Capybara::SpecHelper.spec "node" do
+  before do
+    @session.visit('/with_html')
+  end
+
+  it "should act like a session object" do
+    @session.visit('/form')
+    @form = @session.find(:css, '#get-form')
+    @form.should have_field('Middle Name')
+    @form.should have_no_field('Languages')
+    @form.fill_in('Middle Name', :with => 'Monkey')
+    @form.click_button('med')
+    extract_results(@session)['middle_name'].should == 'Monkey'
+  end
+
+  it "should scope CSS selectors" do
+    @session.find(:css, '#second').should have_no_css('h1')
+  end
+
+  describe "#parent" do
+    it "should have a reference to its parent if there is one" do
+      @node = @session.find(:css, '#first')
+      @node.parent.should == @node.session.document
+      @node.find(:css, '#foo').parent.should == @node
+    end
+  end
+
+  describe "#text" do
+    it "should extract node texts" do
+      @session.all('//a')[0].text.should == 'labore'
+      @session.all('//a')[1].text.should == 'ullamco'
+    end
+
+    it "should return document text on /html selector" do
+      @session.visit('/with_simple_html')
+      @session.all('/html')[0].text.should == 'Bar'
+    end
+  end
+
+  describe "#[]" do
+    it "should extract node attributes" do
+      @session.all('//a')[0][:class].should == 'simple'
+      @session.all('//a')[1][:id].should == 'foo'
+      @session.all('//input')[0][:type].should == 'text'
+    end
+
+    it "should extract boolean node attributes" do
+      @session.find('//input[@id="checked_field"]')[:checked].should be_true
+    end
+  end
+
+  describe "#value" do
+    it "should allow retrieval of the value" do
+      @session.find('//textarea[@id="normal"]').value.should == 'banana'
+    end
+
+    it "should not swallow extra newlines in textarea" do
+      @session.find('//textarea[@id="additional_newline"]').value.should == "\nbanana"
+    end
+  end
+
+  describe "#set" do
+    it "should allow assignment of field value" do
+      @session.first('//input').value.should == 'monkey'
+      @session.first('//input').set('gorilla')
+      @session.first('//input').value.should == 'gorilla'
+    end
+  end
+
+  describe "#tag_name" do
+    it "should extract node tag name" do
+      @session.all('//a')[0].tag_name.should == 'a'
+      @session.all('//a')[1].tag_name.should == 'a'
+      @session.all('//p')[1].tag_name.should == 'p'
+    end
+  end
+
+  describe "#visible?" do
+    it "should extract node visibility" do
+      @session.first('//a').should be_visible
+
+      @session.find('//div[@id="hidden"]').should_not be_visible
+      @session.find('//div[@id="hidden_via_ancestor"]').should_not be_visible
+    end
+  end
+
+  describe "#checked?" do
+    it "should extract node checked state" do
+      @session.visit('/form')
+      @session.find('//input[@id="gender_female"]').should be_checked
+      @session.find('//input[@id="gender_male"]').should_not be_checked
+      @session.first('//h1').should_not be_checked
+    end
+  end
+
+  describe "#selected?" do
+    it "should extract node selected state" do
+      @session.visit('/form')
+      @session.find('//option[@value="en"]').should be_selected
+      @session.find('//option[@value="sv"]').should_not be_selected
+      @session.first('//h1').should_not be_selected
+    end
+  end
+
+  describe "#==" do
+    it "preserve object identity" do
+      (@session.find('//h1') == @session.find('//h1')).should be_true
+      (@session.find('//h1') === @session.find('//h1')).should be_true
+      (@session.find('//h1').eql? @session.find('//h1')).should be_false
+    end
+  end
+
+  describe "#trigger", :requires => [:js, :trigger] do
+    it "should allow triggering of custom JS events" do
+      @session.visit('/with_js')
+      @session.find(:css, '#with_focus_event').trigger(:focus)
+      @session.should have_css('#focus_event_triggered')
+    end
+  end
+
+  describe '#drag_to', :requires => [:js, :drag] do
+    it "should drag and drop an object" do
+      @session.visit('/with_js')
+      element = @session.find('//div[@id="drag"]')
+      target = @session.find('//div[@id="drop"]')
+      element.drag_to(target)
+      @session.find('//div[contains(., "Dropped!")]').should_not be_nil
+    end
+  end
+
+  describe '#reload', :requires => [:js] do
+    context "without automatic reload" do
+      before { Capybara.automatic_reload = false }
+      it "should reload the current context of the node" do
+        @session.visit('/with_js')
+        node = @session.find(:css, '#reload-me')
+        @session.click_link('Reload!')
+        sleep(0.3)
+        node.reload.text.should == 'has been reloaded'
+        node.text.should == 'has been reloaded'
+      end
+
+      it "should reload a parent node" do
+        @session.visit('/with_js')
+        node = @session.find(:css, '#reload-me').find(:css, 'em')
+        @session.click_link('Reload!')
+        sleep(0.3)
+        node.reload.text.should == 'has been reloaded'
+        node.text.should == 'has been reloaded'
+      end
+
+      it "should not automatically reload" do
+        @session.visit('/with_js')
+        node = @session.find(:css, '#reload-me')
+        @session.click_link('Reload!')
+        sleep(0.3)
+        expect { node.text.to == 'has been reloaded' }.to raise_error
+      end
+      after { Capybara.automatic_reload = true }
+    end
+
+    context "with automatic reload" do
+      it "should reload the current context of the node automatically" do
+        @session.visit('/with_js')
+        node = @session.find(:css, '#reload-me')
+        @session.click_link('Reload!')
+        sleep(0.3)
+        node.text.should == 'has been reloaded'
+      end
+
+      it "should reload a parent node automatically" do
+        @session.visit('/with_js')
+        node = @session.find(:css, '#reload-me').find(:css, 'em')
+        @session.click_link('Reload!')
+        sleep(0.3)
+        node.text.should == 'has been reloaded'
+      end
+
+      it "should reload a node automatically when using find" do
+        @session.visit('/with_js')
+        node = @session.find(:css, '#reload-me')
+        @session.click_link('Reload!')
+        sleep(0.3)
+        node.find(:css, 'a').text.should == 'has been reloaded'
+      end
+
+      it "should not reload nodes which haven't been found" do
+        @session.visit('/with_js')
+        node = @session.all(:css, '#the-list li')[1]
+        @session.click_link('Fetch new list!')
+        sleep(0.3)
+        expect { node.text.to == 'Foo' }.to raise_error
+        expect { node.text.to == 'Bar' }.to raise_error
+      end
+
+      it "should reload nodes with options" do
+        @session.visit('/with_js')
+        node = @session.find(:css, 'em', :text => "reloaded")
+        @session.click_link('Reload!')
+        sleep(1)
+        node.text.should == 'has been reloaded'
+      end
+    end
+  end
+end