capybara 1.1.4 → 2.0.0

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

@@ -1,18 +1,20 @@
-shared_examples_for "find_by_id" do  
-  describe '#find_by_id' do
-    before do
-      @session.visit('/with_html')
-    end
+Capybara::SpecHelper.spec '#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 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 "casts to string" do
+    @session.find_by_id(:'red').tag_name.should == 'a'
+  end
 
-    it "should raise error if no element with id is found" do
-      running do
-        @session.find_by_id('nothing_with_this_id')
-      end.should raise_error(Capybara::ElementNotFound)
-    end
+  it "should raise error if no element with id is found" do
+    expect do
+      @session.find_by_id('nothing_with_this_id')
+    end.to raise_error(Capybara::ElementNotFound)
   end
 end

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

@@ -1,26 +1,28 @@
-shared_examples_for "find_field" do  
-  describe '#find_field' do
-    before do
-      @session.visit('/form')
-    end
+Capybara::SpecHelper.spec '#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 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 raise error if the field doesn't exist" do
-      running do
-        @session.find_field('Does not exist')
-      end.should raise_error(Capybara::ElementNotFound)
-    end
+  it "casts to string" do
+    @session.find_field(:'Dog').value.should == 'dog'
+  end
+
+  it "should raise error if the field doesn't exist" do
+    expect do
+      @session.find_field('Does not exist')
+    end.to raise_error(Capybara::ElementNotFound)
+  end
 
-    it "should be aliased as 'field_labeled' for webrat compatibility" do
-      @session.field_labeled('Dog').value.should == 'dog'
-      running do
-        @session.field_labeled('Does not exist')
-      end.should raise_error(Capybara::ElementNotFound)
-    end
+  it "should be aliased as 'field_labeled' for webrat compatibility" do
+    @session.field_labeled('Dog').value.should == 'dog'
+    expect do
+      @session.field_labeled('Does not exist')
+    end.to raise_error(Capybara::ElementNotFound)
   end
 end

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

@@ -1,19 +1,20 @@
-shared_examples_for "find_link" do
+Capybara::SpecHelper.spec '#find_link' do
+  before do
+    @session.visit('/with_html')
+  end
 
-  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 =~ %r(/with_simple_html$)
+  end
 
-    it "should find any field" do
-      @session.find_link('foo').text.should == "ullamco"
-      @session.find_link('labore')[:href].should =~ %r(/with_simple_html$)
-    end
+  it "casts to string" do
+    @session.find_link(:'foo').text.should == "ullamco"
+  end
 
-    it "should raise error if the field doesn't exist" do
-      running do
-        @session.find_link('Does not exist')
-      end.should raise_error(Capybara::ElementNotFound)
-    end
+  it "should raise error if the field doesn't exist" do
+    expect do
+      @session.find_link('Does not exist')
+    end.to raise_error(Capybara::ElementNotFound)
   end
 end

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

@@ -1,148 +1,126 @@
-shared_examples_for "find" do
-  describe '#find' do
-    before do
-      @session.visit('/with_html')
-    end
+Capybara::SpecHelper.spec '#find' do
+  before do
+    @session.visit('/with_html')
+  end
 
-    after do
-      Capybara::Selector.remove(:monkey)
-    end
+  after do
+    Capybara::Selector.remove(:monkey)
+  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
+  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
 
-    it "should find the first element using the given locator and options" do
-      @session.find('//a', :text => 'Redirect')[:id].should == 'red'
-      @session.find(:css, 'a', :text => 'A link')[:title].should == 'twas a fine link'
-    end
+  it "should find the first element using the given locator and options" do
+    @session.find('//a', :text => 'Redirect')[:id].should == 'red'
+    @session.find(:css, 'a', :text => 'A link came first')[:title].should == 'twas a fine link'
+  end
 
-    describe 'the returned node' do
-      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 raise an error if there are multiple matches" do
+    expect { @session.find('//a') }.to raise_error(Capybara::Ambiguous)
+  end
 
-      it "should scope CSS selectors" do
-        @session.find(:css, '#second').should have_no_css('h1')
-      end
+  it "should wait for asynchronous load", :requires => [:js] do
+    @session.visit('/with_js')
+    @session.click_link('Click me')
+    @session.find(:css, "a#has-been-clicked").text.should include('Has been clicked')
+  end
 
-      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('a').parent.should == @node
-      end
+  context "with frozen time", :requires => [:js] do
+    it "raises an error suggesting that Capybara is stuck in time" do
+      @session.visit('/with_js')
+      now = Time.now
+      Time.stub(:now).and_return(now)
+      expect { @session.find('//isnotthere') }.to raise_error(Capybara::FrozenInTime)
     end
+  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
+  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 id selectors" do
-      it "should find the first element using the given locator" do
-        @session.find(:id, 'john_monkey').text.should == 'Monkey John'
-        @session.find(:id, 'red').text.should == 'Redirect'
-        @session.find(:red).text.should == 'Redirect'
-      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 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'
+  context "with custom selector" do
+    it "should use the custom selector" do
+      Capybara.add_selector(:monkey) do
+        xpath { |name| ".//*[@id='#{name}_monkey']" }
       end
+      @session.find(:monkey, 'john').text.should == 'Monkey John'
+      @session.find(:monkey, 'paul').text.should == 'Monkey Paul'
     end
+  end
 
-    context "with custom selector" do
-      it "should use the custom selector" do
-        Capybara.add_selector(:monkey) do
-          xpath { |name| ".//*[@id='#{name}_monkey']" }
-        end
-        @session.find(:monkey, 'john').text.should == 'Monkey John'
-        @session.find(:monkey, 'paul').text.should == 'Monkey Paul'
+  context "with custom selector with :for option" do
+    it "should use the selector when it matches the :for option" do
+      Capybara.add_selector(:monkey) do
+        xpath { |num| ".//*[contains(@id, 'monkey')][#{num}]" }
+        match { |value| value.is_a?(Fixnum) }
       end
+      @session.find(:monkey, '2').text.should == 'Monkey Paul'
+      @session.find(1).text.should == 'Monkey John'
+      @session.find(2).text.should == 'Monkey Paul'
+      @session.find('//h1').text.should == 'This is a test'
     end
+  end
 
-    context "with custom selector with :for option" do
-      it "should use the selector when it matches the :for option" do
-        Capybara.add_selector(:monkey) do
-          xpath { |num| ".//*[contains(@id, 'monkey')][#{num}]" }
-          match { |value| value.is_a?(Fixnum) }
-        end
-        @session.find(:monkey, '2').text.should == 'Monkey Paul'
-        @session.find(1).text.should == 'Monkey John'
-        @session.find(2).text.should == 'Monkey Paul'
-        @session.find('//h1').text.should == 'This is a test'
+  context "with custom selector with custom filter" do
+    before do
+      Capybara.add_selector(:monkey) do
+        xpath { |num| ".//*[contains(@id, 'monkey')][#{num}]" }
+        filter(:name) { |node, name| node.text == name }
       end
     end
 
-    context "with custom selector with failure_message option" do
-      it "should raise an error with the failure message if the element is not found" do
-        Capybara.add_selector(:monkey) do
-          xpath { |num| ".//*[contains(@id, 'monkey')][#{num}]" }
-          failure_message { |node, selector| node.all(".//*[contains(@id, 'monkey')]").map { |node| node.text }.sort.join(', ') }
-        end
-        running do
-          @session.find(:monkey, '14').text.should == 'Monkey Paul'
-        end.should raise_error(Capybara::ElementNotFound, "Monkey John, Monkey Paul")
-      end
-
-      it "should pass the selector as the second argument" do
-        Capybara.add_selector(:monkey) do
-          xpath { |num| ".//*[contains(@id, 'monkey')][#{num}]" }
-          failure_message { |node, selector| selector.name.to_s + ': ' + selector.locator + ' - ' + node.all(".//*[contains(@id, 'monkey')]").map { |node| node.text }.sort.join(', ') }
-        end
-        running do
-          @session.find(:monkey, '14').text.should == 'Monkey Paul'
-        end.should raise_error(Capybara::ElementNotFound, "monkey: 14 - Monkey John, Monkey Paul")
-      end
+    it "should find elements that match the filter" do
+      @session.find(:monkey, '1', :name => 'Monkey John').text.should == 'Monkey John'
+      @session.find(:monkey, '2', :name => 'Monkey Paul').text.should == 'Monkey Paul'
     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 }
+    it "should not find elements that don't match the filter" do
+      expect { @session.find(:monkey, '2', :name => 'Monkey John') }.to raise_error(Capybara::ElementNotFound)
+      expect { @session.find(:monkey, '1', :name => 'Monkey Paul') }.to raise_error(Capybara::ElementNotFound)
     end
+  end
 
-    it "should raise ElementNotFound with specified fail message if nothing was found" do
-      running do
-        @session.find(:xpath, '//div[@id="nosuchthing"]', :message => 'arghh').should be_nil
-      end.should raise_error(Capybara::ElementNotFound, "arghh")
+  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 raise ElementNotFound with a useful default message if nothing was found" do
-      running do
-        @session.find(:xpath, '//div[@id="nosuchthing"]').should be_nil
-      end.should raise_error(Capybara::ElementNotFound, "Unable to find xpath \"//div[@id=\\\"nosuchthing\\\"]\"")
-    end
+  it "should raise ElementNotFound with a useful default message if nothing was found" do
+    expect do
+      @session.find(:xpath, '//div[@id="nosuchthing"]').to be_nil
+    end.to raise_error(Capybara::ElementNotFound, "Unable to find xpath \"//div[@id=\\\"nosuchthing\\\"]\"")
+  end
 
-    it "should accept an XPath instance and respect the order of paths" do
-      @session.visit('/form')
-      @xpath = XPath::HTML.fillable_field('Name')
-      @session.find(@xpath).value.should == 'John Smith'
-    end
+  it "should accept an XPath instance" do
+    @session.visit('/form')
+    @xpath = XPath::HTML.fillable_field('First Name')
+    @session.find(@xpath).value.should == 'John'
+  end
 
-    context "within a scope" do
-      before do
-        @session.visit('/with_scope')
-      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
+    it "should find the an element using the given locator" do
+      @session.within(:xpath, "//div[@id='for_bar']") do
+        @session.find('.//li[1]').text.should =~ /With Simple HTML/
       end
     end
   end

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

@@ -1,104 +1,70 @@
-shared_examples_for "first" do
-  describe '#first' do
-    before do
-      @session.visit('/with_html')
-    end
+Capybara::SpecHelper.spec '#first' do
+  before do
+    @session.visit('/with_html')
+  end
 
-    it "should find the first element using the given locator" do
-      @session.first('//h1').text.should == 'This is a test'
-      @session.first("//input[@id='test_field']")[:value].should == 'monkey'
-    end
+  it "should find the first element using the given locator" do
+    @session.first('//h1').text.should == 'This is a test'
+    @session.first("//input[@id='test_field']")[:value].should == 'monkey'
+  end
 
-    it "should return nil when nothing was found" do
-      @session.first('//div[@id="nosuchthing"]').should be_nil
-    end
+  it "should return nil when nothing was found" do
+    @session.first('//div[@id="nosuchthing"]').should be_nil
+  end
 
-    it "should accept an XPath instance" do
-      @session.visit('/form')
-      @xpath = XPath::HTML.fillable_field('Name')
-      @session.first(@xpath).value.should == 'John Smith'
-    end
+  it "should accept an XPath instance" do
+    @session.visit('/form')
+    @xpath = XPath::HTML.fillable_field('First Name')
+    @session.first(@xpath).value.should == 'John'
+  end
 
-    context "with css selectors" do
-      it "should find the first element using the given selector" do
-        @session.first(:css, 'h1').text.should == 'This is a test'
-        @session.first(:css, "input[id='test_field']")[:value].should == 'monkey'
-      end
+  context "with css selectors" do
+    it "should find the first element using the given selector" do
+      @session.first(:css, 'h1').text.should == 'This is a test'
+      @session.first(: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.first(:xpath, '//h1').text.should == 'This is a test'
-        @session.first(:xpath, "//input[@id='test_field']")[:value].should == 'monkey'
-      end
+  context "with xpath selectors" do
+    it "should find the first element using the given locator" do
+      @session.first(:xpath, '//h1').text.should == 'This is a test'
+      @session.first(: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.first('h1').text.should == 'This is a test'
-        @session.first("input[id='test_field']")[:value].should == 'monkey'
-      end
-      after { Capybara.default_selector = :xpath }
+  context "with css as default selector" do
+    before { Capybara.default_selector = :css }
+    it "should find the first element using the given locator" do
+      @session.first('h1').text.should == 'This is a test'
+      @session.first("input[id='test_field']")[:value].should == 'monkey'
     end
+    after { Capybara.default_selector = :xpath }
+  end
 
-    context "with visible filter" do
-      after { Capybara.ignore_hidden_elements = false }
-      it "should only find visible nodes if true given" do
-        @session.first(:css, "a#invisible").should_not be_nil
-        @session.first(:css, "a#invisible", :visible => true).should be_nil
-        Capybara.ignore_hidden_elements = true
-        @session.first(:css, "a#invisible").should be_nil
-      end
-
-      it "should include invisible nodes if false given" do
-        Capybara.ignore_hidden_elements = true
-        @session.first(:css, "a#invisible", :visible => false).should_not be_nil
-        @session.first(:css, "a#invisible").should be_nil
-      end
+  context "with visible filter" do
+    after { Capybara.ignore_hidden_elements = false }
+    it "should only find visible nodes if true given" do
+      @session.first(:css, "a#invisible").should_not be_nil
+      @session.first(:css, "a#invisible", :visible => true).should be_nil
+      Capybara.ignore_hidden_elements = true
+      @session.first(:css, "a#invisible").should be_nil
     end
 
-    context "with prefer visible elements" do
-      it "should find invisible elements if no visible element exists" do
-        @session.first(:css, 'a#invisible')[:id].should == 'invisible'
-      end
-
-      it "should prefer visible elements over invisible elements" do
-        @session.first(:css, 'a.visibility')[:id].should == 'visible'
-      end
-
-      it "should return the first invisible element if no visible elements exist" do
-        @session.first(:css, 'a.hidden')[:id].should == 'first_invisble'
-      end
-
-      it "find visible links normally" do
-        @session.first(:css, 'a#visible')[:id].should == 'visible'
-      end
+    it "should include invisible nodes if false given" do
+      Capybara.ignore_hidden_elements = true
+      @session.first(:css, "a#invisible", :visible => false).should_not be_nil
+      @session.first(:css, "a#invisible").should be_nil
     end
+  end
 
-    context "without prefer visible elements" do
-      before { Capybara.prefer_visible_elements = false }
-
-      it "should find invisible elements if no visible element exists" do
-        @session.first(:css, 'a#invisible')[:id].should == 'invisible'
-      end
-
-      it "should not prefer visible elements over invisible elements" do
-        @session.first(:css, 'a.visibility')[:id].should == 'invisible'
-      end
-
-      after { Capybara.prefer_visible_elements = true }
+  context "within a scope" do
+    before do
+      @session.visit('/with_scope')
     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.first('.//form').should_not be_nil
-        end
+    it "should find the first element using the given locator" do
+      @session.within(:xpath, "//div[@id='for_bar']") do
+        @session.first('.//form').should_not be_nil
       end
     end
   end

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

@@ -1,32 +1,30 @@
-shared_examples_for "has_button" do  
-  describe '#has_button?' do
-    before do
-      @session.visit('/form')
-    end
+Capybara::SpecHelper.spec '#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 true if the given button is on the page" do
+    @session.should have_button('med')
+    @session.should have_button('crap321')
+    @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
+  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
+Capybara::SpecHelper.spec '#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 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
+  it "should be false if the given button is not on the page" do
+    @session.should have_no_button('monkey')
   end
 end
-