teamcapybara--capybara/lib/capybara/spec/session/find_spec.rb

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

    it "should be aliased as locate for backward compatibility" do
      @session.locate('//h1').text.should == 'This is a test'
      @session.locate("//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
    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'
      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) { |name| ".//*[@id='#{name}_monkey']" }
        @session.find(:monkey, 'john').text.should == 'Monkey John'
        @session.find(:monkey, 'paul').text.should == '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 '//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