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

Capybara::SpecHelper.spec '#within' do
  before do
    @session.visit('/with_scope')
  end

  context "with CSS selector" do
    it "should click links in the given scope" do
      @session.within(:css, "#for_bar li[contains('With Simple HTML')]") do
        @session.click_link('Go')
      end
      @session.should have_content('Bar')
    end

    it "should assert content in the given scope" do
      @session.within(:css, "#for_foo") do
        @session.should_not have_content('First Name')
      end
      @session.should have_content('First Name')
    end

    it "should accept additional options" do
      @session.within(:css, "#for_bar li", :text => 'With Simple HTML') do
        @session.click_link('Go')
      end
      @session.should have_content('Bar')
    end
  end

  context "with XPath selector" do
    it "should click links in the given scope" do
      @session.within(:xpath, "//div[@id='for_bar']//li[contains(.,'With Simple HTML')]") do
        @session.click_link('Go')
      end
      @session.should have_content('Bar')
    end
  end

  context "with the default selector" do
    it "should use XPath" do
      @session.within("//div[@id='for_bar']//li[contains(.,'With Simple HTML')]") do
        @session.click_link('Go')
      end
      @session.should have_content('Bar')
    end
  end

  context "with Node rather than selector" do
    it "should click links in the given scope" do
      node_of_interest = @session.find(:css, "#for_bar li[contains('With Simple HTML')]")

      @session.within(node_of_interest) do
        @session.click_link('Go')
      end
      @session.should have_content('Bar')
    end
  end

  context "with the default selector set to CSS" do
    before { Capybara.default_selector = :css }
    it "should use CSS" do
      @session.within("#for_bar li[contains('With Simple HTML')]") do
        @session.click_link('Go')
      end
      @session.should have_content('Bar')
    end
    after { Capybara.default_selector = :xpath }
  end

  context "with nested scopes" do
    it "should respect the inner scope" do
      @session.within("//div[@id='for_bar']") do
        @session.within(".//li[contains(.,'Bar')]") do
          @session.click_link('Go')
        end
      end
      @session.should have_content('Another World')
    end

    it "should respect the outer scope" do
      @session.within("//div[@id='another_foo']") do
        @session.within(".//li[contains(.,'With Simple HTML')]") do
          @session.click_link('Go')
        end
      end
      @session.should have_content('Hello world')
    end
  end

  it "should raise an error if the scope is not found on the page" do
    running do
      @session.within("//div[@id='doesnotexist']") do
      end
    end.should raise_error(Capybara::ElementNotFound)
  end

  it "should restore the scope when an error is raised" do
    running do
      @session.within("//div[@id='for_bar']") do
        running do
          running do
            @session.within(".//div[@id='doesnotexist']") do
            end
          end.should raise_error(Capybara::ElementNotFound)
        end.should_not change { @session.has_xpath?(".//div[@id='another_foo']") }.from(false)
      end
    end.should_not change { @session.has_xpath?(".//div[@id='another_foo']") }.from(true)
  end

  it "should fill in a field and click a button" do
    @session.within("//li[contains(.,'Bar')]") do
      @session.click_button('Go')
    end
    extract_results(@session)['first_name'].should == 'Peter'
    @session.visit('/with_scope')
    @session.within("//li[contains(.,'Bar')]") do
      @session.fill_in('First Name', :with => 'Dagobert')
      @session.click_button('Go')
    end
    extract_results(@session)['first_name'].should == 'Dagobert'
  end
end

Capybara::SpecHelper.spec '#within_fieldset' do
  before do
    @session.visit('/fieldsets')
  end

  it "should restrict scope to a fieldset given by id" do
    @session.within_fieldset("villain_fieldset") do
      @session.fill_in("Name", :with => 'Goldfinger')
      @session.click_button("Create")
    end
    extract_results(@session)['villain_name'].should == 'Goldfinger'
  end

  it "should restrict scope to a fieldset given by legend" do
    @session.within_fieldset("Villain") do
      @session.fill_in("Name", :with => 'Goldfinger')
      @session.click_button("Create")
    end
    extract_results(@session)['villain_name'].should == 'Goldfinger'
  end
end

Capybara::SpecHelper.spec '#within_table' do
  before do
    @session.visit('/tables')
  end

  it "should restrict scope to a fieldset given by id" do
    @session.within_table("girl_table") do
      @session.fill_in("Name", :with => 'Christmas')
      @session.click_button("Create")
    end
    extract_results(@session)['girl_name'].should == 'Christmas'
  end

  it "should restrict scope to a fieldset given by legend" do
    @session.within_table("Villain") do
      @session.fill_in("Name", :with => 'Quantum')
      @session.click_button("Create")
    end
    extract_results(@session)['villain_name'].should == 'Quantum'
  end
end