lib/capybara/spec/session/within_spec.rb



# frozen_string_literal: true

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:first-child') do
        @session.click_link('Go')
      end
      expect(@session).to have_content('Bar')
    end

    it 'should assert content in the given scope' do
      @session.within(:css, '#for_foo') do
        expect(@session).not_to have_content('First Name')
      end
      expect(@session).to 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
      expect(@session).to 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
      expect(@session).to 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
      expect(@session).to 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', text: 'With Simple HTML')

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

  context 'with the default selector set to CSS' do
    before { Capybara.default_selector = :css }

    after { Capybara.default_selector = :xpath }

    it 'should use CSS' do
      @session.within('#for_bar li', text: 'With Simple HTML') do
        @session.click_link('Go')
      end
      expect(@session).to have_content('Bar')
    end
  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
      expect(@session).to 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
      expect(@session).to have_content('Hello world')
    end
  end

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

  it 'should restore the scope when an error is raised' do
    expect do
      @session.within("//div[@id='for_bar']") do
        expect do
          expect do
            @session.within(".//div[@id='doesnotexist']") do
            end
          end.to raise_error(Capybara::ElementNotFound)
        end.not_to change { @session.has_xpath?(".//div[@id='another_foo']") }.from(false)
      end
    end.not_to 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
    expect(extract_results(@session)['first_name']).to eq('Peter')
    @session.visit('/with_scope')
    @session.within("//li[contains(.,'Bar')]") do
      @session.fill_in('First Name', with: 'Dagobert')
      @session.click_button('Go')
    end
    expect(extract_results(@session)['first_name']).to eq('Dagobert')
  end

  it 'should have #within_element as an alias' do
    expect(Capybara::Session.instance_method(:within)).to eq Capybara::Session.instance_method(:within_element)
    @session.within_element(:css, '#for_foo') do
      expect(@session).not_to have_content('First Name')
    end
  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
    expect(extract_results(@session)['villain_name']).to eq('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
    expect(extract_results(@session)['villain_name']).to eq('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
    expect(extract_results(@session)['girl_name']).to eq('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
    expect(extract_results(@session)['villain_name']).to eq('Quantum')
  end
end