david-capybara 0.3.8

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

@@ -0,0 +1,118 @@
+shared_examples_for "click_link" do
+  describe '#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
+
+    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
+
+    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
+    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
+    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
+    end
+
+    it "should follow redirects" do
+      @session.click_link('Redirect')
+      @session.body.should include('You landed')
+    end
+    
+    it "should follow redirects" do
+      @session.click_link('BackToMyself')
+      @session.body.should include('This is a test')
+    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'
+    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.body.should include('Bar')
+    end
+
+    it "should follow an image map link with alt attribute" do
+      @session.click_link('Image Map')
+      @session.body.should include('Bar')
+    end
+    
+    it "should follow an image map link using the coordinates" do
+      @session.click_link('109,240,129,259')
+      @session.body.should include('Bar')
+    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
+  end
+end

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

@@ -0,0 +1,24 @@
+shared_examples_for "click" do
+  describe '#click' do
+    it "should click on a link" do
+      @session.visit('/with_html')
+      @session.click('labore')
+      @session.body.should include('Bar')
+    end
+
+    it "should click on a button" do
+      @session.visit('/form')
+      @session.click('awe123')
+      extract_results(@session)['first_name'].should == 'John'
+    end
+
+    context "with a locator that doesn't exist" do
+      it "should raise an error" do
+        @session.visit('/with_html')
+        running do
+          @session.click('does not exist')
+        end.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,8 @@
+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
+  end
+end

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

@@ -0,0 +1,108 @@
+shared_examples_for "fill_in" do
+  describe "#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 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 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 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 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
+      pending "selenium doesn't seem to find custom fields" if @session.mode == :selenium
+      @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 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 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'
+    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
+        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
+        running do
+          @session.fill_in('does not exist', :with => 'Blah blah')
+        end.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+shared_examples_for "find_button" do  
+  describe '#find_button' do
+    before do
+      @session.visit('/form')
+    end
+
+    it "should find any field" do
+      @session.find_button('med')[:id].should == "mediocre"
+      @session.find_button('crap321').value.should == "crappy"
+    end
+
+    it "should return nil if the field doesn't exist" do
+      @session.find_button('Does not exist').should be_nil
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+shared_examples_for "find_by_id" do  
+  describe '#find_by_id' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it "should find any element by id" do
+      @session.find_by_id('red').tag_name.should == 'a'
+      @session.find_by_id('hidden_via_ancestor').tag_name.should == 'div'
+    end
+
+    it "should return nil if no element with id is found" do
+      @session.find_by_id('nothing_with_this_id').should be_nil
+    end
+  end
+end

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

@@ -0,0 +1,22 @@
+shared_examples_for "find_field" do  
+  describe '#find_field' do
+    before do
+      @session.visit('/form')
+    end
+
+    it "should find any field" do
+      @session.find_field('Dog').value.should == 'dog'
+      @session.find_field('form_description').text.should == 'Descriptive text goes here'
+      @session.find_field('Region')[:name].should == 'form[region]'
+    end
+
+    it "should be nil if the field doesn't exist" do
+      @session.find_field('Does not exist').should be_nil
+    end
+
+    it "should be aliased as 'field_labeled' for webrat compatibility" do
+      @session.field_labeled('Dog').value.should == 'dog'
+      @session.field_labeled('Does not exist').should be_nil
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+shared_examples_for "find_link" do
+
+  describe '#find_link' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it "should find any field" do
+      @session.find_link('foo').text.should == "ullamco"
+      @session.find_link('labore')[:href].should == "/with_simple_html"
+    end
+
+    it "should return nil if the field doesn't exist" do
+      @session.find_link('Does not exist').should be_nil
+    end
+  end
+end

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

@@ -0,0 +1,57 @@
+shared_examples_for "find" do  
+  describe '#find' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it "should find the first element using the given locator" do
+      @session.find('//h1').text.should == 'This is a test'
+      @session.find("//input[@id='test_field']")[:value].should == 'monkey'
+    end
+
+    context "with css selectors" do
+      it "should find the first element using the given locator" do
+        @session.find(:css, 'h1').text.should == 'This is a test'
+        @session.find(:css, "input[id='test_field']")[:value].should == 'monkey'
+      end
+    end
+
+    context "with xpath selectors" do
+      it "should find the first element using the given locator" do
+        @session.find(:xpath, '//h1').text.should == 'This is a test'
+        @session.find(:xpath, "//input[@id='test_field']")[:value].should == 'monkey'
+      end
+    end
+
+    context "with css as default selector" do
+      before { Capybara.default_selector = :css }
+      it "should find the first element using the given locator" do
+        @session.find('h1').text.should == 'This is a test'
+        @session.find("input[id='test_field']")[:value].should == 'monkey'
+      end
+      after { Capybara.default_selector = :xpath }
+    end
+
+    it "should return nil when nothing was found" do
+      @session.find('//div[@id="nosuchthing"]').should be_nil
+    end
+
+    it "should accept an XPath instance and respect the order of paths" do
+      @session.visit('/form')
+      @xpath = Capybara::XPath.text_field('Name')
+      @session.find(@xpath).value.should == 'John Smith'
+    end
+
+    context "within a scope" do
+      before do
+        @session.visit('/with_scope')
+      end
+
+      it "should find the first element using the given locator" do
+        @session.within(:xpath, "//div[@id='for_bar']") do
+          @session.find('//li').text.should =~ /With Simple HTML/
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+shared_examples_for "has_button" do  
+  describe '#has_button?' do
+    before do
+      @session.visit('/form')
+    end
+
+    it "should be true if the given button is on the page" do
+      @session.should have_button('med')
+      @session.should have_button('crap321')
+    end
+
+    it "should be false if the given button is not on the page" do
+      @session.should_not have_button('monkey')
+    end
+  end
+
+  describe '#has_no_button?' do
+    before do
+      @session.visit('/form')
+    end
+
+    it "should be true if the given button is on the page" do
+      @session.should_not have_no_button('med')
+      @session.should_not have_no_button('crap321')
+    end
+
+    it "should be false if the given button is not on the page" do
+      @session.should have_no_button('monkey')
+    end
+  end
+end
+

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

@@ -0,0 +1,106 @@
+shared_examples_for "has_content" do
+  describe '#has_content?' do
+    it "should be true if the given content is on the page at least once" do
+      @session.visit('/with_html')
+      @session.should have_content('est')
+      @session.should have_content('Lorem')
+      @session.should have_content('Redirect')
+    end
+
+    it "should be true if scoped to an element which has the content" do
+      @session.visit('/with_html')
+      @session.within("//a[@title='awesome title']") do
+        @session.should have_content('labore')
+      end
+    end
+
+    it "should be false if scoped to an element which does not have the content" do
+      @session.visit('/with_html')
+      @session.within("//a[@title='awesome title']") do
+        @session.should_not have_content('monkey')
+      end
+    end
+
+    it "should ignore tags" do
+      @session.visit('/with_html')
+      @session.should_not have_content('exercitation <a href="/foo" id="foo">ullamco</a> laboris')
+      @session.should have_content('exercitation ullamco laboris')
+    end
+
+    it "should ignore extra whitespace and newlines" do
+      @session.visit('/with_html')
+      @session.should have_content('text with whitespace')
+    end
+
+    it "should be false if the given content is not on the page" do
+      @session.visit('/with_html')
+      @session.should_not have_content('xxxxyzzz')
+      @session.should_not have_content('monkey')
+    end
+
+    it 'should handle single quotes in the content' do
+      @session.visit('/with-quotes')
+      @session.should have_content("can't")
+    end
+
+    it 'should handle double quotes in the content' do
+      @session.visit('/with-quotes')
+      @session.should have_content(%q{"No," he said})
+    end
+
+    it 'should handle mixed single and double quotes in the content' do
+      @session.visit('/with-quotes')
+      @session.should have_content(%q{"you can't do that."})
+    end
+  end
+
+  describe '#has_no_content?' do
+    it "should be false if the given content is on the page at least once" do
+      @session.visit('/with_html')
+      @session.should_not have_no_content('est')
+      @session.should_not have_no_content('Lorem')
+      @session.should_not have_no_content('Redirect')
+    end
+
+    it "should be false if scoped to an element which has the content" do
+      @session.visit('/with_html')
+      @session.within("//a[@title='awesome title']") do
+        @session.should_not have_no_content('labore')
+      end
+    end
+
+    it "should be true if scoped to an element which does not have the content" do
+      @session.visit('/with_html')
+      @session.within("//a[@title='awesome title']") do
+        @session.should have_no_content('monkey')
+      end
+    end
+
+    it "should ignore tags" do
+      @session.visit('/with_html')
+      @session.should have_no_content('exercitation <a href="/foo" id="foo">ullamco</a> laboris')
+      @session.should_not have_no_content('exercitation ullamco laboris')
+    end
+
+    it "should be true if the given content is not on the page" do
+      @session.visit('/with_html')
+      @session.should have_no_content('xxxxyzzz')
+      @session.should have_no_content('monkey')
+    end
+
+    it 'should handle single quotes in the content' do
+      @session.visit('/with-quotes')
+      @session.should_not have_no_content("can't")
+    end
+
+    it 'should handle double quotes in the content' do
+      @session.visit('/with-quotes')
+      @session.should_not have_no_content(%q{"No," he said})
+    end
+
+    it 'should handle mixed single and double quotes in the content' do
+      @session.visit('/with-quotes')
+      @session.should_not have_no_content(%q{"you can't do that."})
+    end
+  end
+end