capybara_minitest_spec 0.1.0

data/test_app/session/find_by_id_spec.rb

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

data/test_app/session/find_field_spec.rb

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

data/test_app/session/find_link_spec.rb

@@ -0,0 +1,19 @@
+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 =~ %r(/with_simple_html$)
+    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
+  end
+end

data/test_app/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/test_app/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/test_app/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/test_app/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