capybara 3.32.2

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#sibling' do
+  before do
+    @session.visit('/with_html')
+  end
+
+  after do
+    Capybara::Selector.remove(:monkey)
+  end
+
+  it 'should find a prior sibling element using the given locator' do
+    el = @session.find(:css, '#mid_sibling')
+    expect(el.sibling('//div[@data-pre]')[:id]).to eq('pre_sibling')
+  end
+
+  it 'should find a following sibling element using the given locator' do
+    el = @session.find(:css, '#mid_sibling')
+    expect(el.sibling('//div[@data-post]')[:id]).to eq('post_sibling')
+  end
+
+  it 'should raise an error if there are multiple matches' do
+    el = @session.find(:css, '#mid_sibling')
+    expect { el.sibling('//div') }.to raise_error(Capybara::Ambiguous)
+  end
+
+  context 'with css selectors' do
+    it 'should find the first element using the given locator' do
+      el = @session.find(:css, '#mid_sibling')
+      expect(el.sibling(:css, '#pre_sibling')).to have_text('Pre Sibling')
+      expect(el.sibling(:css, '#post_sibling')).to have_text('Post Sibling')
+    end
+  end
+
+  context 'with custom selector' do
+    it 'should use the custom selector' do
+      Capybara.add_selector(:data_attribute) do
+        xpath { |attr| ".//*[@data-#{attr}]" }
+      end
+      el = @session.find(:css, '#mid_sibling')
+      expect(el.sibling(:data_attribute, 'pre').text).to eq('Pre Sibling')
+      expect(el.sibling(:data_attribute, 'post').text).to eq('Post Sibling')
+    end
+  end
+
+  it 'should raise ElementNotFound with a useful default message if nothing was found' do
+    el = @session.find(:css, '#child')
+    expect do
+      el.sibling(:xpath, '//div[@id="nosuchthing"]')
+    end.to raise_error(Capybara::ElementNotFound, 'Unable to find xpath "//div[@id=\\"nosuchthing\\"]" that is a sibling of visible css "#child"')
+  end
+end

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

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#text' do
+  it 'should print the text of the page' do
+    @session.visit('/with_simple_html')
+    expect(@session.text).to eq('Bar')
+  end
+
+  it 'ignores invisible text by default' do
+    @session.visit('/with_html')
+    expect(@session.find(:id, 'hidden-text').text).to eq('Some of this text is')
+  end
+
+  it 'shows invisible text if `:all` given' do
+    @session.visit('/with_html')
+    expect(@session.find(:id, 'hidden-text').text(:all)).to eq('Some of this text is hidden!')
+  end
+
+  it 'ignores invisible text if `:visible` given' do
+    Capybara.ignore_hidden_elements = false
+    @session.visit('/with_html')
+    expect(@session.find(:id, 'hidden-text').text(:visible)).to eq('Some of this text is')
+  end
+
+  it 'ignores invisible text if `Capybara.ignore_hidden_elements = true`' do
+    @session.visit('/with_html')
+    expect(@session.find(:id, 'hidden-text').text).to eq('Some of this text is')
+    Capybara.ignore_hidden_elements = false
+    expect(@session.find(:id, 'hidden-text').text).to eq('Some of this text is hidden!')
+  end
+
+  it 'ignores invisible text if `Capybara.visible_text_only = true`' do
+    @session.visit('/with_html')
+    Capybara.visible_text_only = true
+    expect(@session.find(:id, 'hidden-text').text).to eq('Some of this text is')
+    Capybara.ignore_hidden_elements = false
+    expect(@session.find(:id, 'hidden-text').text).to eq('Some of this text is')
+  end
+
+  it 'ignores invisible text if ancestor is invisible' do
+    @session.visit('/with_html')
+    expect(@session.find(:id, 'hidden_via_ancestor', visible: false).text).to eq('')
+  end
+
+  context 'with css as default selector' do
+    before { Capybara.default_selector = :css }
+
+    after { Capybara.default_selector = :xpath }
+
+    it 'should print the text of the page' do
+      @session.visit('/with_simple_html')
+      expect(@session.text).to eq('Bar')
+    end
+  end
+
+  it 'should be correctly normalized when visible' do
+    @session.visit('/with_html')
+    el = @session.find(:css, '#normalized')
+    expect(el.text).to eq "Some text\nMore text\nAnd more text\nEven more    text on multiple lines"
+  end
+
+  it 'should be a textContent with irrelevant whitespace collapsed when non-visible' do
+    @session.visit('/with_html')
+    el = @session.find(:css, '#non_visible_normalized', visible: false)
+    expect(el.text(:all)).to eq 'Some textMore text And more text Even more    text on multiple lines'
+  end
+
+  it 'should strip correctly' do
+    @session.visit('/with_html')
+    el = @session.find(:css, '#ws')
+    expect(el.text).to eq ' '
+    expect(el.text(:all)).to eq ' '
+  end
+end

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#title' do
+  it 'should get the title of the page' do
+    @session.visit('/with_title')
+    expect(@session.title).to eq('Test Title')
+  end
+
+  context 'with css as default selector' do
+    before { Capybara.default_selector = :css }
+
+    after { Capybara.default_selector = :xpath }
+
+    it 'should get the title of the page' do
+      @session.visit('/with_title')
+      expect(@session.title).to eq('Test Title')
+    end
+  end
+
+  context 'within iframe', requires: [:frames] do
+    it 'should get the title of the top level browsing context' do
+      @session.visit('/within_frames')
+      expect(@session.title).to eq('With Frames')
+      @session.within_frame('frameOne') do
+        expect(@session.title).to eq('With Frames')
+      end
+    end
+  end
+end

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

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#uncheck' do
+  before do
+    @session.visit('/form')
+  end
+
+  it 'should uncheck a checkbox by id' do
+    @session.uncheck('form_pets_hamster')
+    @session.click_button('awesome')
+    expect(extract_results(@session)['pets']).to include('dog')
+    expect(extract_results(@session)['pets']).not_to include('hamster')
+  end
+
+  it 'should uncheck a checkbox by label' do
+    @session.uncheck('Hamster')
+    @session.click_button('awesome')
+    expect(extract_results(@session)['pets']).to include('dog')
+    expect(extract_results(@session)['pets']).not_to include('hamster')
+  end
+
+  it 'should work without a locator string' do
+    @session.uncheck(id: 'form_pets_hamster')
+    @session.click_button('awesome')
+    expect(extract_results(@session)['pets']).to include('dog')
+    expect(extract_results(@session)['pets']).not_to include('hamster')
+  end
+
+  it 'should be able to uncheck itself if no locator specified' do
+    cb = @session.find(:id, 'form_pets_hamster')
+    cb.uncheck
+    @session.click_button('awesome')
+    expect(extract_results(@session)['pets']).to include('dog')
+    expect(extract_results(@session)['pets']).not_to include('hamster')
+  end
+
+  it 'casts to string' do
+    @session.uncheck(:form_pets_hamster)
+    @session.click_button('awesome')
+    expect(extract_results(@session)['pets']).to include('dog')
+    expect(extract_results(@session)['pets']).not_to include('hamster')
+  end
+
+  context 'with :exact option' do
+    it 'should accept partial matches when false' do
+      @session.uncheck('Ham', exact:  false)
+      @session.click_button('awesome')
+      expect(extract_results(@session)['pets']).not_to include('hamster')
+    end
+
+    it 'should not accept partial matches when true' do
+      expect do
+        @session.uncheck('Ham', exact:  true)
+      end.to raise_error(Capybara::ElementNotFound)
+    end
+  end
+
+  context 'when checkbox hidden' do
+    context 'with Capybara.automatic_label_click == true' do
+      around do |spec|
+        old_click_label, Capybara.automatic_label_click = Capybara.automatic_label_click, true
+        spec.run
+        Capybara.automatic_label_click = old_click_label
+      end
+
+      it 'should uncheck via clicking the label with :for attribute if possible' do
+        expect(@session.find(:checkbox, 'form_cars_jaguar', checked: true, visible: :hidden)).to be_truthy
+        @session.uncheck('form_cars_jaguar')
+        @session.click_button('awesome')
+        expect(extract_results(@session)['cars']).not_to include('jaguar')
+      end
+
+      it 'should uncheck via clicking the wrapping label if possible' do
+        expect(@session.find(:checkbox, 'form_cars_koenigsegg', checked: true, visible: :hidden)).to be_truthy
+        @session.uncheck('form_cars_koenigsegg')
+        @session.click_button('awesome')
+        expect(extract_results(@session)['cars']).not_to include('koenigsegg')
+      end
+
+      it 'should not click the label if unneeded' do
+        expect(@session.find(:checkbox, 'form_cars_tesla', unchecked: true, visible: :hidden)).to be_truthy
+        @session.uncheck('form_cars_tesla')
+        @session.click_button('awesome')
+        expect(extract_results(@session)['cars']).not_to include('tesla')
+      end
+
+      it 'should raise original error when no label available' do
+        expect { @session.uncheck('form_cars_porsche') }.to raise_error(Capybara::ElementNotFound, /Unable to find visible checkbox "form_cars_porsche"/)
+      end
+
+      it 'should raise error if not allowed to click label' do
+        expect { @session.uncheck('form_cars_jaguar', allow_label_click: false) }.to raise_error(Capybara::ElementNotFound, /Unable to find visible checkbox "form_cars_jaguar"/)
+      end
+
+      it 'should include node filter description in error if necessary' do
+        expect { @session.uncheck('form_cars_maserati', allow_label_click: false) }.to raise_error(Capybara::ElementNotFound, 'Unable to find visible checkbox "form_cars_maserati" that is not disabled')
+      end
+    end
+  end
+end

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

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#unselect' do
+  before do
+    @session.visit('/form')
+  end
+
+  context 'with multiple select' do
+    it 'should unselect an option from a select box by id' do
+      @session.unselect('Commando', from: 'form_underwear')
+      @session.click_button('awesome')
+      expect(extract_results(@session)['underwear']).to include('Briefs', 'Boxerbriefs')
+      expect(extract_results(@session)['underwear']).not_to include('Commando')
+    end
+
+    it 'should unselect an option without a select box' do
+      @session.unselect('Commando')
+      @session.click_button('awesome')
+      expect(extract_results(@session)['underwear']).to include('Briefs', 'Boxerbriefs')
+      expect(extract_results(@session)['underwear']).not_to include('Commando')
+    end
+
+    it 'should unselect an option from a select box by label' do
+      @session.unselect('Commando', from: 'Underwear')
+      @session.click_button('awesome')
+      expect(extract_results(@session)['underwear']).to include('Briefs', 'Boxerbriefs')
+      expect(extract_results(@session)['underwear']).not_to include('Commando')
+    end
+
+    it 'should favour exact matches to option labels' do
+      @session.unselect('Briefs', from: 'Underwear')
+      @session.click_button('awesome')
+      expect(extract_results(@session)['underwear']).to include('Commando', 'Boxerbriefs')
+      expect(extract_results(@session)['underwear']).not_to include('Briefs')
+    end
+
+    it 'should escape quotes' do
+      @session.unselect("Frenchman's Pantalons", from: 'Underwear')
+      @session.click_button('awesome')
+      expect(extract_results(@session)['underwear']).not_to include("Frenchman's Pantalons")
+    end
+
+    it 'casts to string' do
+      @session.unselect(:Briefs, from: :Underwear)
+      @session.click_button('awesome')
+      expect(extract_results(@session)['underwear']).to include('Commando', 'Boxerbriefs')
+      expect(extract_results(@session)['underwear']).not_to include('Briefs')
+    end
+  end
+
+  context 'with single select' do
+    it 'should raise an error' do
+      expect { @session.unselect('English', from: 'form_locale') }.to raise_error(Capybara::UnselectNotAllowed)
+    end
+  end
+
+  context "with a locator that doesn't exist" do
+    it 'should raise an error' do
+      msg = /Unable to find select box "does not exist"/
+      expect do
+        @session.unselect('foo', from: 'does not exist')
+      end.to raise_error(Capybara::ElementNotFound, msg)
+    end
+  end
+
+  context "with an option that doesn't exist" do
+    it 'should raise an error' do
+      msg = /^Unable to find option "Does not Exist" within/
+      expect do
+        @session.unselect('Does not Exist', from: 'form_underwear')
+      end.to raise_error(Capybara::ElementNotFound, msg)
+    end
+  end
+
+  context 'with :exact option' do
+    context 'when `false`' do
+      it 'can match select box approximately' do
+        @session.unselect('Boxerbriefs', from: 'Under', exact: false)
+        @session.click_button('awesome')
+        expect(extract_results(@session)['underwear']).not_to include('Boxerbriefs')
+      end
+
+      it 'can match option approximately' do
+        @session.unselect('Boxerbr', from: 'Underwear', exact: false)
+        @session.click_button('awesome')
+        expect(extract_results(@session)['underwear']).not_to include('Boxerbriefs')
+      end
+
+      it 'can match option approximately when :from not given' do
+        @session.unselect('Boxerbr', exact: false)
+        @session.click_button('awesome')
+        expect(extract_results(@session)['underwear']).not_to include('Boxerbriefs')
+      end
+    end
+
+    context 'when `true`' do
+      it 'can match select box approximately' do
+        expect do
+          @session.unselect('Boxerbriefs', from: 'Under', exact:  true)
+        end.to raise_error(Capybara::ElementNotFound)
+      end
+
+      it 'can match option approximately' do
+        expect do
+          @session.unselect('Boxerbr', from: 'Underwear', exact:  true)
+        end.to raise_error(Capybara::ElementNotFound)
+      end
+
+      it 'can match option approximately when :from not given' do
+        expect do
+          @session.unselect('Boxerbr', exact: true)
+        end.to raise_error(Capybara::ElementNotFound)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,204 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#visit' do
+  it 'should fetch a response from the driver with a relative url' do
+    @session.visit('/')
+    expect(@session).to have_content('Hello world!')
+    @session.visit('/foo')
+    expect(@session).to have_content('Another World')
+  end
+
+  it 'should fetch a response from the driver with an absolute url with a port' do
+    # Preparation
+    @session.visit('/')
+    root_uri = URI.parse(@session.current_url)
+
+    @session.visit("http://#{root_uri.host}:#{root_uri.port}/")
+    expect(@session).to have_content('Hello world!')
+    @session.visit("http://#{root_uri.host}:#{root_uri.port}/foo")
+    expect(@session).to have_content('Another World')
+  end
+
+  it "should fetch a response when absolute URI doesn't have a trailing slash" do
+    # Preparation
+    @session.visit('/foo/bar')
+    root_uri = URI.parse(@session.current_url)
+
+    @session.visit("http://#{root_uri.host}:#{root_uri.port}")
+    expect(@session).to have_content('Hello world!')
+  end
+
+  it 'should fetch a response when sequentially visiting same destination with a target' do
+    @session.visit('/form')
+    expect(@session).to have_css('#form_title')
+    @session.visit('/form#form_title')
+    expect(@session).to have_css('#form_title')
+  end
+
+  it 'raises any errors caught inside the server', requires: [:server] do
+    quietly { @session.visit('/error') }
+    expect do
+      @session.visit('/')
+    end.to raise_error(TestApp::TestAppError)
+  end
+
+  it 'should be able to open non-http url', requires: [:about_scheme] do
+    @session.visit('about:blank')
+    @session.assert_no_selector :xpath, '/html/body/*'
+  end
+
+  context 'when Capybara.always_include_port is true' do
+    let(:root_uri) do
+      @session.visit('/')
+      URI.parse(@session.current_url)
+    end
+
+    before do
+      Capybara.always_include_port = true
+    end
+
+    after do
+      Capybara.always_include_port = false
+    end
+
+    it 'should fetch a response from the driver with an absolute url without a port' do
+      @session.visit("http://#{root_uri.host}/")
+      expect(URI.parse(@session.current_url).port).to eq(root_uri.port)
+      expect(@session).to have_content('Hello world!')
+
+      @session.visit("http://#{root_uri.host}/foo")
+      expect(URI.parse(@session.current_url).port).to eq(root_uri.port)
+      expect(@session).to have_content('Another World')
+    end
+
+    it 'should add the server port to a visited url if no port specified', requires: [:server] do
+      allow(@session.driver).to receive(:visit)
+      @session.visit('http://www.example.com')
+      expect(@session.driver).to have_received(:visit).with("http://www.example.com:#{@session.server.port}")
+    end
+
+    it 'should not override the visit specified port even if default for scheme', requires: [:server] do
+      allow(@session.driver).to receive(:visit)
+      @session.visit('http://www.example.com:80')
+      expect(@session.driver).to have_received(:visit).with('http://www.example.com:80')
+    end
+
+    it 'should give preference to app_host port if specified', requires: [:server] do
+      allow(@session.driver).to receive(:visit)
+      Capybara.app_host = 'http://www.example.com:6666'
+      @session.visit('/random')
+      expect(@session.driver).to have_received(:visit).with('http://www.example.com:6666/random')
+    end
+
+    it "shouldn't override port if no server", requires: [:server] do
+      session = Capybara::Session.new(@session.mode, nil)
+      allow(session.driver).to receive(:visit)
+      session.visit('http://www.google.com')
+      expect(session.driver).to have_received(:visit).with('http://www.google.com')
+    end
+
+    it "shouldn't override port if no server but app_host is set", requires: [:server] do
+      session = Capybara::Session.new(@session.mode, nil)
+      Capybara.app_host = 'http://www.example.com:6666'
+      allow(session.driver).to receive(:visit)
+      session.visit('http://www.google.com')
+      expect(session.driver).to have_received(:visit).with('http://www.google.com')
+    end
+  end
+
+  context 'when Capybara.always_include_port is false' do
+    before do
+      Capybara.always_include_port = false
+    end
+
+    it "shouldn't overwrite port if app_host is set", requires: [:server] do
+      session = Capybara::Session.new(@session.mode, nil)
+      Capybara.app_host = 'http://www.example.com:6666'
+      allow(session.driver).to receive(:visit)
+      session.visit('http://www.google.com')
+      expect(session.driver).to have_received(:visit).with('http://www.google.com')
+    end
+
+    it "shouldn't overwrite port if port specfified", requires: [:server] do
+      session = Capybara::Session.new(@session.mode, nil)
+      Capybara.app_host = 'http://www.example.com:6666'
+      allow(session.driver).to receive(:visit)
+      session.visit('http://www.google.com:99')
+      expect(session.driver).to have_received(:visit).with('http://www.google.com:99')
+    end
+  end
+
+  context 'without a server', requires: [:server] do
+    it 'should respect `app_host`' do
+      serverless_session = Capybara::Session.new(@session.mode, nil)
+      Capybara.app_host = "http://#{@session.server.host}:#{@session.server.port}"
+      serverless_session.visit('/foo')
+      expect(serverless_session).to have_content('Another World')
+    end
+
+    it 'should visit a fully qualified URL' do
+      serverless_session = Capybara::Session.new(@session.mode, nil)
+      serverless_session.visit("http://#{@session.server.host}:#{@session.server.port}/foo")
+      expect(serverless_session).to have_content('Another World')
+    end
+  end
+
+  context 'with Capybara.app_host set' do
+    it 'should override server', requires: [:server] do
+      another_session = Capybara::Session.new(@session.mode, @session.app.dup)
+      Capybara.app_host = "http://#{@session.server.host}:#{@session.server.port}"
+      another_session.visit('/foo')
+      expect(another_session).to have_content('Another World')
+      expect(another_session.current_url).to start_with(Capybara.app_host)
+      expect(URI.parse(another_session.current_url).port).not_to eq another_session.server.port
+      expect(URI.parse(another_session.current_url).port).to eq @session.server.port
+    end
+
+    it 'should append relative path', requires: [:server] do
+      Capybara.app_host = "http://#{@session.server.host}:#{@session.server.port}/redirect/0"
+      @session.visit('/times')
+      expect(@session).to have_content('redirection complete')
+    end
+
+    it 'should work if `app_host` has a trailing /', requires: [:server] do
+      Capybara.app_host = "http://#{@session.server.host}:#{@session.server.port}/"
+      @session.visit('/')
+      expect(@session).to have_content('Hello world!')
+    end
+  end
+
+  it 'should send no referer when visiting a page' do
+    @session.visit '/get_referer'
+    expect(@session).to have_content 'No referer'
+  end
+
+  it 'should send no referer when visiting a second page' do
+    @session.visit '/get_referer'
+    @session.visit '/get_referer'
+    expect(@session).to have_content 'No referer'
+  end
+
+  it 'should send a referer when following a link' do
+    @session.visit '/referer_base'
+    @session.find('//a[@href="/get_referer"]').click
+    expect(@session).to have_content %r{http://.*/referer_base}
+  end
+
+  it 'should preserve the original referer URL when following a redirect' do
+    @session.visit('/referer_base')
+    @session.find('//a[@href="/redirect_to_get_referer"]').click
+    expect(@session).to have_content %r{http://.*/referer_base}
+  end
+
+  it 'should send a referer when submitting a form' do
+    @session.visit '/referer_base'
+    @session.find('//input').click
+    expect(@session).to have_content %r{http://.*/referer_base}
+  end
+
+  it 'can set cookie if a blank path is specified' do
+    @session.visit('')
+    @session.visit('/get_cookie')
+    expect(@session).to have_content('root cookie')
+  end
+end