nimboids-capybara 1.1.2

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

@@ -0,0 +1,149 @@
+shared_examples_for "find" do
+  describe '#find' do
+    before do
+      @session.visit('/with_html')
+    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 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
+
+    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 scope CSS selectors" do
+        @session.find(:css, '#second').should have_no_css('h1')
+      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
+    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
+    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 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 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 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
+    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 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")
+    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 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
+
+    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/first_spec.rb

@@ -0,0 +1,105 @@
+shared_examples_for "first" do
+  describe '#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 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
+
+    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
+    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 }
+    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
+    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
+    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 }
+    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
+      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

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

@@ -0,0 +1,243 @@
+shared_examples_for "has_css" do  
+  describe '#has_css?' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it "should be true if the given selector is on the page" do
+      @session.should have_css("p")
+      @session.should have_css("p a#foo")
+    end
+
+    it "should be false if the given selector is not on the page" do
+      @session.should_not have_css("abbr")
+      @session.should_not have_css("p a#doesnotexist")
+      @session.should_not have_css("p.nosuchclass")
+    end
+
+    it "should respect scopes" do
+      @session.within "//p[@id='first']" do
+        @session.should have_css("a#foo")
+        @session.should_not have_css("a#red")
+      end
+    end
+
+    context "with between" do
+      it "should be true if the content occurs within the range given" do
+        @session.should have_css("p", :between => 1..4)
+        @session.should have_css("p a#foo", :between => 1..3)
+      end
+
+      it "should be false if the content occurs more or fewer times than range" do
+        @session.should_not have_css("p", :between => 6..11 )
+        @session.should_not have_css("p a#foo", :between => 4..7)
+      end
+
+      it "should be false if the content isn't on the page at all" do
+        @session.should_not have_css("abbr", :between => 1..8)
+        @session.should_not have_css("p a.doesnotexist", :between => 3..8)
+      end
+    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_css("p", :count => 3)
+        @session.should have_css("p a#foo", :count => 1)
+      end
+
+      it "should be false if the content occurs the given number of times" do
+        @session.should_not have_css("p", :count => 6)
+        @session.should_not have_css("p a#foo", :count => 2)
+      end
+
+      it "should be false if the content isn't on the page at all" do
+        @session.should_not have_css("abbr", :count => 2)
+        @session.should_not have_css("p a.doesnotexist", :count => 1)
+      end
+
+      it "should coerce count to an integer" do
+        @session.should have_css("p", :count => "3")
+        @session.should have_css("p a#foo", :count => "1")
+      end
+    end
+
+    context "with maximum" do
+      it "should be true when content occurs same or fewer times than given" do
+        @session.should have_css("h2.head", :maximum => 5) # edge case
+        @session.should have_css("h2", :maximum => 10)
+      end
+
+      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("p", :maximum => 1)
+      end
+
+      it "should be false if the content isn't on the page at all" do
+        @session.should_not have_css("abbr", :maximum => 2)
+        @session.should_not have_css("p a.doesnotexist", :maximum => 1)
+      end
+
+      it "should coerce maximum to an integer" do
+        @session.should have_css("h2.head", :maximum => "5") # edge case
+        @session.should have_css("h2", :maximum => "10")
+      end
+    end
+
+    context "with minimum" do
+      it "should be true when content occurs same or more times than given" do
+        @session.should have_css("h2.head", :minimum => 5) # edge case
+        @session.should have_css("h2", :minimum => 3)
+      end
+
+      it "should be false when content occurs fewer times than given" do
+        @session.should_not have_css("h2.head", :minimum => 6) # edge case
+        @session.should_not have_css("h2", :minimum => 8)
+        @session.should_not have_css("p", :minimum => 10)
+      end
+
+      it "should be false if the content isn't on the page at all" do
+        @session.should_not have_css("abbr", :minimum => 2)
+        @session.should_not have_css("p a.doesnotexist", :minimum => 7)
+      end
+
+      it "should coerce minimum to an integer" do
+        @session.should have_css("h2.head", :minimum => "5") # edge case
+        @session.should have_css("h2", :minimum => "3")
+      end
+    end
+
+    context "with text" do
+      it "should discard all matches where the given string is not contained" do
+        @session.should have_css("p a", :text => "Redirect", :count => 1)
+        @session.should_not have_css("p a", :text => "Doesnotexist")
+      end
+
+      it "should discard all matches where the given regexp is not matched" do
+        @session.should have_css("p a", :text => /re[dab]i/i, :count => 1)
+        @session.should_not have_css("p a", :text => /Red$/)
+      end
+    end
+  end
+
+  describe '#has_no_css?' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it "should be false if the given selector is on the page" do
+      @session.should_not have_no_css("p")
+      @session.should_not have_no_css("p a#foo")
+    end
+
+    it "should be true if the given selector is not on the page" do
+      @session.should have_no_css("abbr")
+      @session.should have_no_css("p a#doesnotexist")
+      @session.should have_no_css("p.nosuchclass")
+    end
+
+    it "should respect scopes" do
+      @session.within "//p[@id='first']" do
+        @session.should_not have_no_css("a#foo")
+        @session.should have_no_css("a#red")
+      end
+    end
+
+    context "with between" do
+      it "should be false if the content occurs within the range given" do
+        @session.should_not have_no_css("p", :between => 1..4)
+        @session.should_not have_no_css("p a#foo", :between => 1..3)
+      end
+
+      it "should be true if the content occurs more or fewer times than range" do
+        @session.should have_no_css("p", :between => 6..11 )
+        @session.should have_no_css("p a#foo", :between => 4..7)
+      end
+
+      it "should be true if the content isn't on the page at all" do
+        @session.should have_no_css("abbr", :between => 1..8)
+        @session.should have_no_css("p a.doesnotexist", :between => 3..8)
+      end
+    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_css("p", :count => 3)
+        @session.should_not have_no_css("p a#foo", :count => 1)
+      end
+
+      it "should be true if the content is on the page the given number of times" do
+        @session.should have_no_css("p", :count => 6)
+        @session.should have_no_css("p a#foo", :count => 2)
+      end
+
+      it "should be true if the content isn't on the page at all" do
+        @session.should have_no_css("abbr", :count => 2)
+        @session.should have_no_css("p a.doesnotexist", :count => 1)
+      end
+
+      it "should coerce count to an integer" do
+        @session.should_not have_no_css("p", :count => "3")
+        @session.should_not have_no_css("p a#foo", :count => "1")
+      end
+    end
+
+    context "with maximum" do
+      it "should be false when content occurs same or fewer times than given" do
+        @session.should_not have_no_css("h2.head", :maximum => 5) # edge case
+        @session.should_not have_no_css("h2", :maximum => 10)
+      end
+
+      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("p", :maximum => 1)
+      end
+
+      it "should be true if the content isn't on the page at all" do
+        @session.should have_no_css("abbr", :maximum => 5)
+        @session.should have_no_css("p a.doesnotexist", :maximum => 10)
+      end
+
+      it "should coerce maximum to an integer" do
+        @session.should_not have_no_css("h2.head", :maximum => "5") # edge case
+        @session.should_not have_no_css("h2", :maximum => "10")
+      end
+    end
+
+    context "with minimum" do
+      it "should be false when content occurs more times than given" do
+        @session.should_not have_no_css("h2.head", :minimum => 4) # edge case
+        @session.should_not have_no_css("h2", :minimum => 3)
+      end
+
+      it "should be true when content occurs fewer times than given" do
+        @session.should have_no_css("h2.head", :minimum => 6) # edge case
+        @session.should have_no_css("h2", :minimum => 8)
+        @session.should have_no_css("p", :minimum => 15)
+      end
+
+      it "should be true if the content isn't on the page at all" do
+        @session.should have_no_css("abbr", :minimum => 5)
+        @session.should have_no_css("p a.doesnotexist", :minimum => 10)
+      end
+
+      it "should coerce minimum to an integer" do
+        @session.should_not have_no_css("h2.head", :minimum => "4") # edge case
+        @session.should_not have_no_css("h2", :minimum => "3")
+      end
+    end
+
+    context "with text" do
+      it "should discard all matches where the given string is not contained" do
+        @session.should_not have_no_css("p a", :text => "Redirect", :count => 1)
+        @session.should have_no_css("p a", :text => "Doesnotexist")
+      end
+
+      it "should discard all matches where the given regexp is not matched" do
+        @session.should_not have_no_css("p a", :text => /re[dab]i/i, :count => 1)
+        @session.should have_no_css("p a", :text => /Red$/)
+      end
+    end
+  end
+end