capybara 3.32.2

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

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#ancestor' do
+  before do
+    @session.visit('/with_html')
+  end
+
+  after do
+    Capybara::Selector.remove(:monkey)
+  end
+
+  it 'should find the ancestor element using the given locator' do
+    el = @session.find(:css, '#first_image')
+    expect(el.ancestor('//p')).to have_text('Lorem ipsum dolor')
+    expect(el.ancestor('//a')[:'aria-label']).to eq('Go to simple')
+  end
+
+  it 'should find the ancestor element using the given locator and options' do
+    el = @session.find(:css, '#child')
+    expect(el.ancestor('//div', text: "Ancestor\nAncestor\nAncestor")[:id]).to eq('ancestor3')
+  end
+
+  it 'should find the closest ancestor' do
+    el = @session.find(:css, '#child')
+    expect(el.ancestor('.//div', order: :reverse, match: :first)[:id]).to eq('ancestor1')
+  end
+
+  it 'should raise an error if there are multiple matches' do
+    el = @session.find(:css, '#child')
+    expect { el.ancestor('//div') }.to raise_error(Capybara::Ambiguous)
+    expect { el.ancestor('//div', text: 'Ancestor') }.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, '#first_image')
+      expect(el.ancestor(:css, 'p')).to have_text('Lorem ipsum dolor')
+      expect(el.ancestor(:css, 'a')[:'aria-label']).to eq('Go to simple')
+    end
+
+    it 'should support pseudo selectors' do
+      el = @session.find(:css, '#button_img')
+      expect(el.ancestor(:css, 'button:disabled')[:id]).to eq('ancestor_button')
+    end
+  end
+
+  context 'with xpath selectors' do
+    it 'should find the first element using the given locator' do
+      el = @session.find(:css, '#first_image')
+      expect(el.ancestor(:xpath, '//p')).to have_text('Lorem ipsum dolor')
+      expect(el.ancestor(:xpath, '//a')[:'aria-label']).to eq('Go to simple')
+    end
+  end
+
+  context 'with custom selector' do
+    it 'should use the custom selector' do
+      Capybara.add_selector(:level) do
+        xpath { |num| ".//*[@id='ancestor#{num}']" }
+      end
+      el = @session.find(:css, '#child')
+      expect(el.ancestor(:level, 1)[:id]).to eq 'ancestor1'
+      expect(el.ancestor(:level, 3)[:id]).to eq 'ancestor3'
+    end
+  end
+
+  it 'should raise ElementNotFound with a useful default message if nothing was found' do
+    el = @session.find(:css, '#child')
+    expect do
+      el.ancestor(:xpath, '//div[@id="nosuchthing"]')
+    end.to raise_error(Capybara::ElementNotFound, 'Unable to find xpath "//div[@id=\\"nosuchthing\\"]" that is an ancestor of visible css "#child"')
+  end
+
+  context 'within a scope' do
+    it 'should limit the ancestors to inside the scope' do
+      @session.within(:css, '#ancestor2') do
+        el = @session.find(:css, '#child')
+        expect(el.ancestor(:css, 'div', text: 'Ancestor')[:id]).to eq('ancestor1')
+      end
+    end
+  end
+
+  it 'should raise if selector type is unknown' do
+    el = @session.find(:css, '#child')
+    expect do
+      el.ancestor(:unknown, '//h1')
+    end.to raise_error(ArgumentError)
+  end
+end

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

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#assert_all_of_selectors' do
+  before do
+    @session.visit('/with_html')
+  end
+
+  it 'should be true if the given selectors are on the page' do
+    @session.assert_all_of_selectors(:css, 'p a#foo', 'h2#h2one', 'h2#h2two')
+  end
+
+  it 'should be false if any of the given selectors are not on the page' do
+    expect { @session.assert_all_of_selectors(:css, 'p a#foo', 'h2#h2three', 'h2#h2one') }.to raise_error(Capybara::ElementNotFound)
+  end
+
+  it 'should use default selector' do
+    Capybara.default_selector = :css
+    expect { @session.assert_all_of_selectors('p a#foo', 'h2#h2three', 'h2#h2one') }.to raise_error(Capybara::ElementNotFound)
+    @session.assert_all_of_selectors('p a#foo', 'h2#h2two', 'h2#h2one')
+  end
+
+  it 'should support filter block' do
+    expect { @session.assert_all_of_selectors(:css, 'h2#h2one', 'h2#h2two') { |n| n[:id] == 'h2one' } }.to raise_error(Capybara::ElementNotFound, /custom filter block/)
+  end
+
+  context 'should respect scopes' do
+    it 'when used with `within`' do
+      @session.within "//p[@id='first']" do
+        @session.assert_all_of_selectors(".//a[@id='foo']")
+        expect { @session.assert_all_of_selectors(".//a[@id='red']") }.to raise_error(Capybara::ElementNotFound)
+      end
+    end
+
+    it 'when called on elements' do
+      el = @session.find "//p[@id='first']"
+      el.assert_all_of_selectors(".//a[@id='foo']")
+      expect { el.assert_all_of_selectors(".//a[@id='red']") }.to raise_error(Capybara::ElementNotFound)
+    end
+  end
+
+  context 'with options' do
+    it 'should apply options to all locators' do
+      @session.assert_all_of_selectors(:field, 'normal', 'additional_newline', type: :textarea)
+      expect { @session.assert_all_of_selectors(:field, 'normal', 'test_field', 'additional_newline', type: :textarea) }.to raise_error(Capybara::ElementNotFound)
+    end
+  end
+
+  context 'with wait', requires: [:js] do
+    it 'should not raise error if all the elements appear before given wait duration' do
+      Capybara.using_wait_time(0.1) do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.assert_all_of_selectors(:css, 'a#clickable', 'a#has-been-clicked', '#drag', wait: 1.5)
+      end
+    end
+  end
+end
+
+Capybara::SpecHelper.spec '#assert_none_of_selectors' do
+  before do
+    @session.visit('/with_html')
+  end
+
+  it 'should be false if any of the given locators are on the page' do
+    expect { @session.assert_none_of_selectors(:xpath, '//p', '//a') }.to raise_error(Capybara::ElementNotFound)
+    expect { @session.assert_none_of_selectors(:xpath, '//abbr', '//a') }.to raise_error(Capybara::ElementNotFound)
+    expect { @session.assert_none_of_selectors(:css, 'p a#foo') }.to raise_error(Capybara::ElementNotFound)
+  end
+
+  it 'should be true if none of the given locators are on the page' do
+    @session.assert_none_of_selectors(:xpath, '//abbr', '//td')
+    @session.assert_none_of_selectors(:css, 'p a#doesnotexist', 'abbr')
+  end
+
+  it 'should use default selector' do
+    Capybara.default_selector = :css
+    @session.assert_none_of_selectors('p a#doesnotexist', 'abbr')
+    expect { @session.assert_none_of_selectors('abbr', 'p a#foo') }.to raise_error(Capybara::ElementNotFound)
+  end
+
+  context 'should respect scopes' do
+    it 'when used with `within`' do
+      @session.within "//p[@id='first']" do
+        expect { @session.assert_none_of_selectors(".//a[@id='foo']") }.to raise_error(Capybara::ElementNotFound)
+        @session.assert_none_of_selectors(".//a[@id='red']")
+      end
+    end
+
+    it 'when called on an element' do
+      el = @session.find "//p[@id='first']"
+      expect { el.assert_none_of_selectors(".//a[@id='foo']") }.to raise_error(Capybara::ElementNotFound)
+      el.assert_none_of_selectors(".//a[@id='red']")
+    end
+  end
+
+  context 'with options' do
+    it 'should apply the options to all locators' do
+      expect { @session.assert_none_of_selectors('//p//a', text: 'Redirect') }.to raise_error(Capybara::ElementNotFound)
+      @session.assert_none_of_selectors('//p', text: 'Doesnotexist')
+    end
+
+    it 'should discard all matches where the given regexp is matched' do
+      expect { @session.assert_none_of_selectors('//p//a', text: /re[dab]i/i, count: 1) }.to raise_error(Capybara::ElementNotFound)
+      @session.assert_none_of_selectors('//p//a', text: /Red$/)
+    end
+  end
+
+  context 'with wait', requires: [:js] do
+    it 'should not find elements if they appear after given wait duration' do
+      @session.visit('/with_js')
+      @session.click_link('Click me')
+      @session.assert_none_of_selectors(:css, '#new_field', 'a#has-been-clicked', wait: 0.1)
+    end
+  end
+end
+
+Capybara::SpecHelper.spec '#assert_any_of_selectors' do
+  before do
+    @session.visit('/with_html')
+  end
+
+  it 'should be true if any of the given selectors are on the page' do
+    @session.assert_any_of_selectors(:css, 'a#foo', 'h2#h2three')
+    @session.assert_any_of_selectors(:css, 'h2#h2three', 'a#foo')
+  end
+
+  it 'should be false if none of the given selectors are on the page' do
+    expect { @session.assert_any_of_selectors(:css, 'h2#h2three', 'h4#h4four') }.to raise_error(Capybara::ElementNotFound)
+  end
+
+  it 'should use default selector' do
+    Capybara.default_selector = :css
+    expect { @session.assert_any_of_selectors('h2#h2three', 'h5#h5five') }.to raise_error(Capybara::ElementNotFound)
+    @session.assert_any_of_selectors('p a#foo', 'h2#h2two', 'h2#h2one')
+  end
+
+  it 'should support filter block' do
+    expect { @session.assert_any_of_selectors(:css, 'h2#h2one', 'h2#h2two') { |_n| false } }.to raise_error(Capybara::ElementNotFound, /custom filter block/)
+  end
+end

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

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#assert_current_path' do
+  before do
+    @session.visit('/with_js')
+  end
+
+  it 'should not raise if the page has the given current path' do
+    expect { @session.assert_current_path('/with_js') }.not_to raise_error
+  end
+
+  it 'should allow regexp matches' do
+    expect { @session.assert_current_path(/w[a-z]{3}_js/) }.not_to raise_error
+  end
+
+  it 'should wait for current_path', requires: [:js] do
+    @session.click_link('Change page')
+    expect { @session.assert_current_path('/with_html') }.not_to raise_error
+  end
+
+  it 'should raise if the page has not the given current_path' do
+    expect { @session.assert_current_path('/with_html') }.to raise_error(Capybara::ExpectationNotMet, 'expected "/with_js" to equal "/with_html"')
+  end
+
+  it 'should check query options' do
+    @session.visit('/with_js?test=test')
+    expect { @session.assert_current_path('/with_js?test=test') }.not_to raise_error
+  end
+
+  it 'should compare the full url' do
+    expect { @session.assert_current_path(%r{\Ahttp://[^/]*/with_js\Z}, url: true) }.not_to raise_error
+  end
+
+  it 'should ignore the query' do
+    @session.visit('/with_js?test=test')
+    expect { @session.assert_current_path('/with_js', ignore_query: true) }.not_to raise_error
+  end
+
+  it 'should not cause an exception when current_url is nil' do
+    allow(@session).to receive(:current_url).and_return(nil)
+    allow(@session.page).to receive(:current_url).and_return(nil) if @session.respond_to? :page
+
+    expect { @session.assert_current_path(nil) }.not_to raise_error
+  end
+end
+
+Capybara::SpecHelper.spec '#assert_no_current_path?' do
+  before do
+    @session.visit('/with_js')
+  end
+
+  it 'should raise if the page has the given current_path' do
+    expect { @session.assert_no_current_path('/with_js') }.to raise_error(Capybara::ExpectationNotMet)
+  end
+
+  it 'should allow regexp matches' do
+    expect { @session.assert_no_current_path(/monkey/) }.not_to raise_error
+  end
+
+  it 'should wait for current_path to disappear', requires: [:js] do
+    @session.click_link('Change page')
+    expect { @session.assert_no_current_path('/with_js') }.not_to raise_error
+  end
+
+  it 'should not raise if the page has not the given current_path' do
+    expect { @session.assert_no_current_path('/with_html') }.not_to raise_error
+  end
+
+  it 'should not cause an exception when current_url is nil' do
+    allow(@session).to receive(:current_url).and_return(nil)
+    allow(@session.page).to receive(:current_url).and_return(nil) if @session.respond_to? :page
+
+    expect { @session.assert_no_current_path('/with_html') }.not_to raise_error
+  end
+end

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

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#assert_selector' do
+  before do
+    @session.visit('/with_html')
+  end
+
+  it 'should be true if the given selector is on the page' do
+    @session.assert_selector(:xpath, '//p')
+    @session.assert_selector(:css, 'p a#foo')
+    @session.assert_selector("//p[contains(.,'est')]")
+  end
+
+  it 'should be false if the given selector is not on the page' do
+    expect { @session.assert_selector(:xpath, '//abbr') }.to raise_error(Capybara::ElementNotFound)
+    expect { @session.assert_selector(:css, 'p a#doesnotexist') }.to raise_error(Capybara::ElementNotFound)
+    expect { @session.assert_selector("//p[contains(.,'thisstringisnotonpage')]") }.to raise_error(Capybara::ElementNotFound)
+  end
+
+  it 'should use default selector' do
+    Capybara.default_selector = :css
+    expect { @session.assert_selector('p a#doesnotexist') }.to raise_error(Capybara::ElementNotFound)
+    @session.assert_selector('p a#foo')
+  end
+
+  it 'should respect scopes' do
+    @session.within "//p[@id='first']" do
+      @session.assert_selector(".//a[@id='foo']")
+      expect { @session.assert_selector(".//a[@id='red']") }.to raise_error(Capybara::ElementNotFound)
+    end
+  end
+
+  context 'with count' do
+    it 'should be true if the content is on the page the given number of times' do
+      @session.assert_selector('//p', count: 3)
+      @session.assert_selector("//p//a[@id='foo']", count: 1)
+      @session.assert_selector("//p[contains(.,'est')]", count: 1)
+    end
+
+    it 'should be false if the content is on the page the given number of times' do
+      expect { @session.assert_selector('//p', count: 6) }.to raise_error(Capybara::ElementNotFound)
+      expect { @session.assert_selector("//p//a[@id='foo']", count: 2) }.to raise_error(Capybara::ElementNotFound)
+      expect { @session.assert_selector("//p[contains(.,'est')]", count: 5) }.to raise_error(Capybara::ElementNotFound)
+    end
+
+    it "should be false if the content isn't on the page at all" do
+      expect { @session.assert_selector('//abbr', count: 2) }.to raise_error(Capybara::ElementNotFound)
+      expect { @session.assert_selector("//p//a[@id='doesnotexist']", count: 1) }.to raise_error(Capybara::ElementNotFound)
+    end
+  end
+
+  context 'with text' do
+    it 'should discard all matches where the given string is not contained' do
+      @session.assert_selector('//p//a', text: 'Redirect', count: 1)
+      expect { @session.assert_selector('//p', text: 'Doesnotexist') }.to raise_error(Capybara::ElementNotFound)
+    end
+
+    it 'should discard all matches where the given regexp is not matched' do
+      @session.assert_selector('//p//a', text: /re[dab]i/i, count: 1)
+      expect { @session.assert_selector('//p//a', text: /Red$/) }.to raise_error(Capybara::ElementNotFound)
+    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.1) do
+        @session.visit('/with_js')
+        @session.click_link('Click me')
+        @session.assert_selector(:css, 'a#has-been-clicked', text: 'Has been clicked', wait: 2)
+      end
+    end
+  end
+end
+
+Capybara::SpecHelper.spec '#assert_no_selector' do
+  before do
+    @session.visit('/with_html')
+  end
+
+  it 'should be false if the given selector is on the page' do
+    expect { @session.assert_no_selector(:xpath, '//p') }.to raise_error(Capybara::ElementNotFound)
+    expect { @session.assert_no_selector(:css, 'p a#foo') }.to raise_error(Capybara::ElementNotFound)
+    expect { @session.assert_no_selector("//p[contains(.,'est')]") }.to raise_error(Capybara::ElementNotFound)
+  end
+
+  it 'should be true if the given selector is not on the page' do
+    @session.assert_no_selector(:xpath, '//abbr')
+    @session.assert_no_selector(:css, 'p a#doesnotexist')
+    @session.assert_no_selector("//p[contains(.,'thisstringisnotonpage')]")
+  end
+
+  it 'should use default selector' do
+    Capybara.default_selector = :css
+    @session.assert_no_selector('p a#doesnotexist')
+    expect { @session.assert_no_selector('p a#foo') }.to raise_error(Capybara::ElementNotFound)
+  end
+
+  it 'should respect scopes' do
+    @session.within "//p[@id='first']" do
+      expect { @session.assert_no_selector(".//a[@id='foo']") }.to raise_error(Capybara::ElementNotFound)
+      @session.assert_no_selector(".//a[@id='red']")
+    end
+  end
+
+  context 'with count' do
+    it 'should be false if the content is on the page the given number of times' do
+      expect { @session.assert_no_selector('//p', count: 3) }.to raise_error(Capybara::ElementNotFound)
+      expect { @session.assert_no_selector("//p//a[@id='foo']", count: 1) }.to raise_error(Capybara::ElementNotFound)
+      expect { @session.assert_no_selector("//p[contains(.,'est')]", count: 1) }.to raise_error(Capybara::ElementNotFound)
+    end
+
+    it 'should be true if the content is on the page the wrong number of times' do
+      @session.assert_no_selector('//p', count: 6)
+      @session.assert_no_selector("//p//a[@id='foo']", count: 2)
+      @session.assert_no_selector("//p[contains(.,'est')]", count: 5)
+    end
+
+    it "should be true if the content isn't on the page at all" do
+      @session.assert_no_selector('//abbr', count: 2)
+      @session.assert_no_selector("//p//a[@id='doesnotexist']", count: 1)
+    end
+  end
+
+  context 'with text' do
+    it 'should discard all matches where the given string is contained' do
+      expect { @session.assert_no_selector('//p//a', text: 'Redirect', count: 1) }.to raise_error(Capybara::ElementNotFound)
+      @session.assert_no_selector('//p', text: 'Doesnotexist')
+    end
+
+    it 'should discard all matches where the given regexp is matched' do
+      expect { @session.assert_no_selector('//p//a', text: /re[dab]i/i, count: 1) }.to raise_error(Capybara::ElementNotFound)
+      @session.assert_no_selector('//p//a', text: /Red$/)
+    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.assert_no_selector(:css, 'a#has-been-clicked', text: 'Has been clicked', wait: 0.1)
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#assert_matches_style', requires: [:css] do
+  it 'should not raise if the elements style contains the given properties' do
+    @session.visit('/with_html')
+    expect do
+      @session.find(:css, '#first').assert_matches_style(display: 'block')
+    end.not_to raise_error
+  end
+
+  it "should raise error if the elements style doesn't contain the given properties" do
+    @session.visit('/with_html')
+    expect do
+      @session.find(:css, '#first').assert_matches_style(display: 'inline')
+    end.to raise_error(Capybara::ExpectationNotMet, 'Expected node to have styles {"display"=>"inline"}. Actual styles were {"display"=>"block"}')
+  end
+
+  it 'should wait for style', requires: %i[css js] do
+    @session.visit('/with_js')
+    el = @session.find(:css, '#change')
+    @session.click_link('Change size')
+    expect do
+      el.assert_matches_style({ 'font-size': '50px' }, wait: 3)
+    end.not_to raise_error
+  end
+end