bbc-capybara 1.1.2

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

@@ -0,0 +1,83 @@
+shared_examples_for "current_url" do  
+  before :all do
+    @servers = 2.times.map { Capybara::Server.new(TestApp.clone).boot }
+    # sanity check
+    @servers[0].port.should_not == @servers[1].port
+    @servers.map { |s| s.port }.should_not include 80
+  end
+
+  def bases
+    @servers.map { |s| "http://#{s.host}:#{s.port}" }
+  end
+
+  describe '#current_url, #current_path, #current_host' do
+    def should_be_on server_index, path="/host", scheme="http"
+      # Check that we are on /host on the given server
+      s = @servers[server_index]
+      @session.current_url.chomp('?').should == "#{scheme}://#{s.host}:#{s.port}#{path}"
+      @session.current_host.should == "#{scheme}://#{s.host}" # no port
+      @session.current_path.should == path
+      if path == '/host'
+        # Server should agree with us
+        @session.body.should include("Current host is #{scheme}://#{s.host}:#{s.port}")
+      end
+    end
+
+    def visit_host_links
+      @session.visit("#{bases[0]}/host_links?absolute_host=#{bases[1]}")
+    end
+
+    it "is affected by visiting a page directly" do
+      @session.visit("#{bases[0]}/host")
+      should_be_on 0
+    end
+
+    it "returns to the app host when visiting a relative url" do
+      Capybara.app_host = bases[1]
+      @session.visit("#{bases[0]}/host")
+      should_be_on 0
+      @session.visit('/host')
+      should_be_on 1
+      Capybara.app_host = nil
+    end
+
+    it "is affected by setting Capybara.app_host" do
+      Capybara.app_host = bases[0]
+      @session.visit("/host")
+      should_be_on 0
+      Capybara.app_host = bases[1]
+      @session.visit("/host")
+      should_be_on 1
+      Capybara.app_host = nil
+    end
+
+    it "is unaffected by following a relative link" do
+      visit_host_links
+      @session.click_link("Relative Host")
+      should_be_on 0
+    end
+
+    it "is affected by following an absolute link" do
+      visit_host_links
+      @session.click_link("Absolute Host")
+      should_be_on 1
+    end
+
+    it "is unaffected by posting through a relative form" do
+      visit_host_links
+      @session.click_button("Relative Host")
+      should_be_on 0
+    end
+
+    it "is affected by posting through an absolute form" do
+      visit_host_links
+      @session.click_button("Absolute Host")
+      should_be_on 1
+    end
+
+    it "is affected by following a redirect" do
+      @session.visit("#{bases[0]}/redirect")
+      should_be_on 0, "/landed"
+    end
+  end
+end

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

@@ -0,0 +1,127 @@
+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 fill in a url field by label without for" do
+      @session.fill_in('Html5 Url', :with => 'http://www.avenueq.com')
+      @session.click_button('html5_submit')
+      extract_results(@session)['html5_url'].should == 'http://www.avenueq.com'
+    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
+      @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 field without a type" do
+      @session.fill_in('Phone', :with => '+1 555 7022')
+      @session.click_button('awesome')
+      extract_results(@session)['phone'].should == '+1 555 7022'
+    end
+
+    it "should fill in a text field respecting its maxlength attribute" do
+      @session.fill_in('Zipcode', :with => '52071350')
+      @session.click_button('awesome')
+      extract_results(@session)['zipcode'].should == '52071'
+    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
+        msg = "no text field, text area or password field with id, name, or label 'Super Secret' found"
+        running do
+          @session.fill_in('Super Secret', :with => '777')
+        end.should raise_error(Capybara::ElementNotFound, msg)
+      end
+    end
+
+    context "with a locator that doesn't exist" do
+      it "should raise an error" do
+        msg = "no text field, text area or password field with id, name, or label 'does not exist' found"
+        running do
+          @session.fill_in('does not exist', :with => 'Blah blah')
+        end.should raise_error(Capybara::ElementNotFound, msg)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+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 raise error if the field doesn't exist" do
+      running do
+        @session.find_button('Does not exist')
+      end.should raise_error(Capybara::ElementNotFound)
+    end
+  end
+end

data/lib/capybara/spec/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/lib/capybara/spec/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/lib/capybara/spec/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/lib/capybara/spec/session/find_spec.rb

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