capybara 3.32.2

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

@@ -0,0 +1,258 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#assert_text' do
+  it 'should be true if the given text is on the page' do
+    @session.visit('/with_html')
+    expect(@session.assert_text('est')).to eq(true)
+    expect(@session.assert_text('Lorem')).to eq(true)
+    expect(@session.assert_text('Redirect')).to eq(true)
+    expect(@session.assert_text(:Redirect)).to eq(true)
+    expect(@session.assert_text('text with   whitespace')).to eq(true)
+  end
+
+  it 'should support collapsing whitespace' do
+    @session.visit('/with_html')
+    expect(@session.assert_text('text with whitespace', normalize_ws: true)).to eq(true)
+  end
+
+  context 'with enabled default collapsing whitespace' do
+    before { Capybara.default_normalize_ws = true }
+
+    it 'should be true if the given unnormalized text is on the page' do
+      @session.visit('/with_html')
+      expect(@session.assert_text('text with   whitespace', normalize_ws: false)).to eq(true)
+    end
+
+    it 'should support collapsing whitespace' do
+      @session.visit('/with_html')
+      expect(@session.assert_text('text with whitespace')).to eq(true)
+    end
+  end
+
+  it 'should take scopes into account' do
+    @session.visit('/with_html')
+    @session.within("//a[@title='awesome title']") do
+      expect(@session.assert_text('labore')).to eq(true)
+    end
+  end
+
+  it 'should raise if scoped to an element which does not have the text' do
+    @session.visit('/with_html')
+    @session.within("//a[@title='awesome title']") do
+      expect do
+        @session.assert_text('monkey')
+      end.to raise_error(Capybara::ExpectationNotMet, 'expected to find text "monkey" in "labore"')
+    end
+  end
+
+  it 'should be true if :all given and text is invisible.' do
+    @session.visit('/with_html')
+    expect(@session.assert_text(:all, 'Some of this text is hidden!')).to eq(true)
+  end
+
+  it 'should be true if `Capybara.ignore_hidden_elements = true` and text is invisible.' do
+    Capybara.ignore_hidden_elements = false
+    @session.visit('/with_html')
+    expect(@session.assert_text('Some of this text is hidden!')).to eq(true)
+  end
+
+  it 'should raise error with a helpful message if the requested text is present but invisible' do
+    @session.visit('/with_html')
+    el = @session.find(:css, '#hidden-text')
+    expect do
+      el.assert_text(:visible, 'Some of this text is hidden!')
+    end.to raise_error(Capybara::ExpectationNotMet, /it was found 1 time including non-visible text/)
+  end
+
+  it 'should raise error with a helpful message if the requested text is present but with incorrect case' do
+    @session.visit('/with_html')
+    expect do
+      @session.assert_text('Text With   Whitespace')
+    end.to raise_error(Capybara::ExpectationNotMet, /it was found 1 time using a case insensitive search/)
+  end
+
+  it 'should raise error with helpful message if requested text is present but invisible and with incorrect case', requires: [:js] do
+    @session.visit('/with_html')
+    el = @session.find(:css, '#uppercase')
+    expect do
+      el.assert_text('text here')
+    end.to raise_error(Capybara::ExpectationNotMet, /it was found 1 time using a case insensitive search and it was found 1 time including non-visible text/)
+  end
+
+  it 'should raise the correct error if requested text is missing but contains regex special characters' do
+    @session.visit('/with_html')
+    expect do
+      @session.assert_text('[]*.')
+    end.to raise_error(Capybara::ExpectationNotMet, /expected to find text "\[\]\*\."/)
+  end
+
+  it 'should be true if the text in the page matches given regexp' do
+    @session.visit('/with_html')
+    expect(@session.assert_text(/Lorem/)).to eq(true)
+  end
+
+  it "should raise error if the text in the page doesn't match given regexp" do
+    @session.visit('/with_html')
+    expect do
+      @session.assert_text(/xxxxyzzz/)
+    end.to raise_error(Capybara::ExpectationNotMet, %r{\Aexpected to find text matching /xxxxyzzz/ in "This is a test\\nHeader Class(.+)"\Z})
+  end
+
+  it 'should escape any characters that would have special meaning in a regexp' do
+    @session.visit('/with_html')
+    expect do
+      @session.assert_text('.orem')
+    end.to raise_error(Capybara::ExpectationNotMet)
+  end
+
+  it 'should wait for text to appear', requires: [:js] do
+    Capybara.default_max_wait_time = 2
+    @session.visit('/with_js')
+    @session.click_link('Click me')
+    expect(@session.assert_text('Has been clicked')).to eq(true)
+  end
+
+  context 'with between' do
+    it 'should be true if the text occurs within the range given' do
+      @session.visit('/with_count')
+      expect(@session.assert_text('count', between: 1..3)).to eq(true)
+    end
+
+    it 'should be false if the text occurs more or fewer times than range' do
+      @session.visit('/with_html')
+      expect do
+        @session.find(:css, '.number').assert_text(/\d/, between: 0..1)
+      end.to raise_error(Capybara::ExpectationNotMet, 'expected to find text matching /\\d/ between 0 and 1 times but found 2 times in "42"')
+    end
+  end
+
+  context 'with wait', requires: [:js] do
+    it 'should find element if it appears before given wait duration' do
+      Capybara.using_wait_time(0) do
+        @session.visit('/with_js')
+        @session.find(:css, '#reload-list').click
+        @session.find(:css, '#the-list').assert_text("Foo\nBar", wait: 0.9)
+      end
+    end
+
+    it 'should raise error if it appears after given wait duration' do
+      Capybara.using_wait_time(0) do
+        @session.visit('/with_js')
+        @session.find(:css, '#reload-list').click
+        el = @session.find(:css, '#the-list', visible: false)
+        expect do
+          el.assert_text(:all, 'Foo Bar', wait: 0.3)
+        end.to raise_error(Capybara::ExpectationNotMet)
+      end
+    end
+  end
+
+  context 'with multiple count filters' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it 'ignores other filters when :count is specified' do
+      o = { count: 5,
+            minimum: 6,
+            maximum: 0,
+            between: 0..4 }
+      expect { @session.assert_text('Header', **o) }.not_to raise_error
+    end
+
+    context 'with no :count expectation' do
+      it 'fails if :minimum is not met' do
+        o = { minimum: 6,
+              maximum: 5,
+              between: 2..7 }
+        expect { @session.assert_text('Header', **o) }.to raise_error(Capybara::ExpectationNotMet)
+      end
+
+      it 'fails if :maximum is not met' do
+        o = { minimum: 0,
+              maximum: 0,
+              between: 2..7 }
+        expect { @session.assert_text('Header', **o) }.to raise_error(Capybara::ExpectationNotMet)
+      end
+
+      it 'fails if :between is not met' do
+        o = { minimum: 0,
+              maximum: 5,
+              between: 0..4 }
+        expect { @session.assert_text('Header', **o) }.to raise_error(Capybara::ExpectationNotMet)
+      end
+
+      it 'succeeds if all combineable expectations are met' do
+        o = { minimum: 0,
+              maximum: 5,
+              between: 2..7 }
+        expect { @session.assert_text('Header', **o) }.not_to raise_error
+      end
+    end
+  end
+end
+
+Capybara::SpecHelper.spec '#assert_no_text' do
+  it 'should raise error if the given text is on the page at least once' do
+    @session.visit('/with_html')
+    expect do
+      @session.assert_no_text('Lorem')
+    end.to raise_error(Capybara::ExpectationNotMet, /\Aexpected not to find text "Lorem" in "This is a test.*"\z/)
+  end
+
+  it 'should be true if scoped to an element which does not have the text' do
+    @session.visit('/with_html')
+    @session.within("//a[@title='awesome title']") do
+      expect(@session.assert_no_text('monkey')).to eq(true)
+    end
+  end
+
+  it 'should be true if the given text is on the page but not visible' do
+    @session.visit('/with_html')
+    expect(@session.assert_no_text('Inside element with hidden ancestor')).to eq(true)
+  end
+
+  it 'should raise error if :all given and text is invisible.' do
+    @session.visit('/with_html')
+    el = @session.find(:css, '#hidden-text', visible: false)
+    expect do
+      el.assert_no_text(:all, 'Some of this text is hidden!')
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected not to find text "Some of this text is hidden!" in "Some of this text is hidden!"')
+  end
+
+  it 'should raise error if :all given and text is invisible.' do
+    @session.visit('/with_html')
+    el = @session.find(:css, '#some-hidden-text', visible: false)
+    expect do
+      el.assert_no_text(:visible, 'hidden')
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected not to find text "hidden" in "Some of this text is not hidden"')
+  end
+
+  it "should be true if the text in the page doesn't match given regexp" do
+    @session.visit('/with_html')
+    @session.assert_no_text(/xxxxyzzz/)
+  end
+
+  context 'with count' do
+    it 'should be true if the text occurs within the range given' do
+      @session.visit('/with_count')
+      expect(@session.assert_text('count', count: 2)).to eq(true)
+    end
+
+    it 'should be false if the text occurs more or fewer times than range' do
+      @session.visit('/with_html')
+      expect do
+        @session.find(:css, '.number').assert_text(/\d/, count: 1)
+      end.to raise_error(Capybara::ExpectationNotMet, 'expected to find text matching /\\d/ 1 time but found 2 times in "42"')
+    end
+  end
+
+  context 'with wait', requires: [:js] do
+    it 'should not find element if it appears after given wait duration' do
+      @session.visit('/with_js')
+      @session.click_link('Click me')
+      @session.find(:css, '#reload-list').click
+      @session.find(:css, '#the-list').assert_no_text('Foo Bar', wait: 0.3)
+    end
+  end
+end

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

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#assert_title' do
+  before do
+    @session.visit('/with_js')
+  end
+
+  it "should not raise if the page's title contains the given string" do
+    expect do
+      @session.assert_title('js')
+    end.not_to raise_error
+  end
+
+  it 'should not raise when given an empty string' do
+    expect do
+      @session.assert_title('')
+    end.not_to raise_error
+  end
+
+  it 'should allow regexp matches' do
+    expect do
+      @session.assert_title(/w[a-z]{3}_js/)
+    end.not_to raise_error
+
+    expect do
+      @session.assert_title(/w[a-z]{10}_js/)
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected "with_js" to match /w[a-z]{10}_js/')
+  end
+
+  it 'should wait for title', requires: [:js] do
+    @session.click_link('Change title')
+    expect do
+      @session.assert_title('changed title', wait: 3)
+    end.not_to raise_error
+  end
+
+  it "should raise error if the title doesn't contain the given string" do
+    expect do
+      @session.assert_title('monkey')
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected "with_js" to include "monkey"')
+  end
+
+  it 'should not normalize given title' do
+    @session.visit('/with_js')
+    expect { @session.assert_title('  with_js  ') }.to raise_error(Capybara::ExpectationNotMet)
+  end
+
+  it 'should match correctly normalized title' do
+    uri = Addressable::URI.parse('/with_title')
+    uri.query_values = { title: '   with space  title   ' }
+    @session.visit(uri.to_s)
+    @session.assert_title('  with space  title')
+    expect { @session.assert_title('with space title') }.to raise_error(Capybara::ExpectationNotMet)
+  end
+
+  it 'should not normalize given title in error message' do
+    expect do
+      @session.assert_title(2)
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected "with_js" to include "2"')
+  end
+end
+
+Capybara::SpecHelper.spec '#assert_no_title' do
+  before do
+    @session.visit('/with_js')
+  end
+
+  it 'should raise error if the title contains the given string' do
+    expect do
+      @session.assert_no_title('with_j')
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected "with_js" not to include "with_j"')
+  end
+
+  it 'should allow regexp matches' do
+    expect do
+      @session.assert_no_title(/w[a-z]{3}_js/)
+    end.to raise_error(Capybara::ExpectationNotMet, 'expected "with_js" not to match /w[a-z]{3}_js/')
+    @session.assert_no_title(/monkey/)
+  end
+
+  it 'should wait for title to disappear', requires: [:js] do
+    @session.click_link('Change title')
+    expect do
+      @session.assert_no_title('with_js', wait: 3)
+    end.not_to raise_error
+  end
+
+  it "should not raise if the title doesn't contain the given string" do
+    expect do
+      @session.assert_no_title('monkey')
+    end.not_to raise_error
+  end
+end

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

@@ -0,0 +1,216 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#attach_file' do
+  let(:test_file_path) { File.expand_path('../fixtures/test_file.txt', File.dirname(__FILE__)) }
+  let(:another_test_file_path) { File.expand_path('../fixtures/another_test_file.txt', File.dirname(__FILE__)) }
+  let(:test_jpg_file_path) { File.expand_path('../fixtures/capybara.jpg', File.dirname(__FILE__)) }
+  let(:no_extension_file_path) { File.expand_path('../fixtures/no_extension', File.dirname(__FILE__)) }
+
+  before do
+    @session.visit('/form')
+  end
+
+  context 'with normal form' do
+    it 'should set a file path by id' do
+      @session.attach_file 'form_image', with_os_path_separators(__FILE__)
+      @session.click_button('awesome')
+      expect(extract_results(@session)['image']).to end_with(File.basename(__FILE__))
+    end
+
+    it 'should set a file path by label' do
+      @session.attach_file 'Image', with_os_path_separators(__FILE__)
+      @session.click_button('awesome')
+      expect(extract_results(@session)['image']).to end_with(File.basename(__FILE__))
+    end
+
+    it 'should be able to set on element if no locator passed' do
+      ff = @session.find(:file_field, 'Image')
+      ff.attach_file(with_os_path_separators(__FILE__))
+      @session.click_button('awesome')
+      expect(extract_results(@session)['image']).to end_with(File.basename(__FILE__))
+    end
+
+    it 'casts to string' do
+      @session.attach_file :form_image, with_os_path_separators(__FILE__)
+      @session.click_button('awesome')
+      expect(extract_results(@session)['image']).to end_with(File.basename(__FILE__))
+    end
+  end
+
+  context 'with multipart form' do
+    it 'should set a file path by id' do
+      @session.attach_file 'form_document', with_os_path_separators(test_file_path)
+      @session.click_button('Upload Single')
+      expect(@session).to have_content(File.read(test_file_path))
+    end
+
+    it 'should set a file path by label' do
+      @session.attach_file 'Single Document', with_os_path_separators(test_file_path)
+      @session.click_button('Upload Single')
+      expect(@session).to have_content(File.read(test_file_path))
+    end
+
+    it 'should not break if no file is submitted' do
+      @session.click_button('Upload Single')
+      expect(@session).to have_content('No file uploaded')
+    end
+
+    it 'should send content type text/plain when uploading a text file' do
+      @session.attach_file 'Single Document', with_os_path_separators(test_file_path)
+      @session.click_button 'Upload Single'
+      expect(@session).to have_content('text/plain')
+    end
+
+    it 'should send content type image/jpeg when uploading an image' do
+      @session.attach_file 'Single Document', with_os_path_separators(test_jpg_file_path)
+      @session.click_button 'Upload Single'
+      expect(@session).to have_content('image/jpeg')
+    end
+
+    it 'should not break when uploading a file without extension' do
+      @session.attach_file 'Single Document', with_os_path_separators(no_extension_file_path)
+      @session.click_button 'Upload Single'
+      expect(@session).to have_content(File.read(no_extension_file_path))
+    end
+
+    it 'should not break when using HTML5 multiple file input' do
+      @session.attach_file 'Multiple Documents', with_os_path_separators(test_file_path)
+      @session.click_button('Upload Multiple')
+      expect(@session).to have_content(File.read(test_file_path))
+      expect(@session.body).to include('1 | ') # number of files
+    end
+
+    it 'should not break when using HTML5 multiple file input uploading multiple files' do
+      @session.attach_file('Multiple Documents',
+                           [test_file_path, another_test_file_path].map { |f| with_os_path_separators(f) })
+      @session.click_button('Upload Multiple')
+      expect(@session).to have_content('2 | ') # number of files
+      expect(@session.body).to include(File.read(test_file_path))
+      expect(@session.body).to include(File.read(another_test_file_path))
+    end
+
+    it 'should not send anything when attaching no files to a multiple upload field' do
+      @session.click_button('Upload Empty Multiple')
+      expect(@session).to have_content('Successfully ignored empty file field')
+    end
+
+    it 'should not append files to already attached' do
+      @session.attach_file 'Multiple Documents', with_os_path_separators(test_file_path)
+      @session.attach_file 'Multiple Documents', with_os_path_separators(another_test_file_path)
+      @session.click_button('Upload Multiple')
+      expect(@session).to have_content('1 | ') # number of files
+      expect(@session.body).to include(File.read(another_test_file_path))
+      expect(@session.body).not_to include(File.read(test_file_path))
+    end
+
+    it 'should fire change once when uploading multiple files from empty', requires: [:js] do
+      @session.visit('with_js')
+      @session.attach_file('multiple-file',
+                           [test_file_path, another_test_file_path].map { |f| with_os_path_separators(f) })
+      expect(@session).to have_css('.file_change', count: 1)
+    end
+
+    it 'should fire change once for each set of files uploaded', requires: [:js] do
+      @session.visit('with_js')
+      @session.attach_file('multiple-file', [test_jpg_file_path].map { |f| with_os_path_separators(f) })
+      @session.attach_file('multiple-file',
+                           [test_file_path, another_test_file_path].map { |f| with_os_path_separators(f) })
+      expect(@session).to have_css('.file_change', count: 2)
+    end
+  end
+
+  context "with a locator that doesn't exist" do
+    it 'should raise an error' do
+      msg = /Unable to find file field "does not exist"/
+      expect do
+        @session.attach_file('does not exist', with_os_path_separators(test_file_path))
+      end.to raise_error(Capybara::ElementNotFound, msg)
+    end
+  end
+
+  context "with a path that doesn't exist" do
+    it 'should raise an error' do
+      expect { @session.attach_file('Image', '/no_such_file.png') }.to raise_error(Capybara::FileNotFound)
+    end
+  end
+
+  context 'with :exact option' do
+    it 'should set a file path by partial label when false' do
+      @session.attach_file 'Imag', with_os_path_separators(__FILE__), exact: false
+      @session.click_button('awesome')
+      expect(extract_results(@session)['image']).to end_with(File.basename(__FILE__))
+    end
+
+    it 'should not allow partial matches when true' do
+      expect do
+        @session.attach_file 'Imag', with_os_path_separators(__FILE__), exact: true
+      end.to raise_error(Capybara::ElementNotFound)
+    end
+  end
+
+  context 'with :make_visible option', requires: %i[js es_args] do
+    it 'applies a default style change when true' do
+      @session.visit('/with_js')
+      expect do
+        @session.attach_file('hidden_file', with_os_path_separators(__FILE__))
+      end.to raise_error Capybara::ElementNotFound
+      expect do
+        @session.attach_file('hidden_file', with_os_path_separators(__FILE__), make_visible: true)
+      end.not_to raise_error
+    end
+
+    it 'accepts a hash of styles to be applied' do
+      @session.visit('/with_js')
+      expect do
+        @session.attach_file('hidden_file',
+                             with_os_path_separators(__FILE__),
+                             make_visible: { opacity: 1, display: 'block' })
+      end.not_to raise_error
+    end
+
+    it 'raises an error when the file input is not made visible' do
+      @session.visit('/with_js')
+      expect do
+        @session.attach_file('hidden_file', with_os_path_separators(__FILE__), make_visible: { color: 'red' })
+      end.to raise_error(Capybara::ExpectationNotMet)
+    end
+
+    it 'resets the style when done' do
+      @session.visit('/with_js')
+      @session.attach_file('hidden_file', with_os_path_separators(__FILE__), make_visible: true)
+      expect(@session.evaluate_script('arguments[0].style.display', @session.find(:css, '#hidden_file', visible: :all))).to eq 'none'
+    end
+
+    it 'should fire change' do
+      @session.visit('/with_js')
+      @session.attach_file('hidden_file', with_os_path_separators(__FILE__), make_visible: true)
+      expect(@session).to have_css('.file_change')
+    end
+  end
+
+  context 'with a block', requires: %i[js] do
+    it 'can upload by clicking the file input' do
+      @session.attach_file(with_os_path_separators(__FILE__)) do
+        @session.find(:file_field, 'form[image]').click
+      end
+      @session.click_button('awesome')
+      expect(extract_results(@session)['image']).to end_with(File.basename(__FILE__))
+    end
+
+    it 'can upload by clicking the label' do
+      @session.attach_file(with_os_path_separators(__FILE__)) do
+        @session.find(:label, 'Hidden Image').click
+      end
+      @session.click_button('awesome')
+      expect(extract_results(@session)['hidden_image']).to end_with(File.basename(__FILE__))
+    end
+
+    it 'should fire change' do
+      @session.visit('/with_js')
+      @session.attach_file(with_os_path_separators(__FILE__)) do
+        @session.find(:label, 'Label for hidden file input').click
+      end
+      expect(@session).to have_css('.file_change')
+    end
+  end
+end