capybara 2.5.0 → 2.18.0

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 Capybara::SpecHelper.spec "#choose" do
   before do
     @session.visit('/form')
@@ -23,7 +24,7 @@ Capybara::SpecHelper.spec "#choose" do
 
   context "with a locator that doesn't exist" do
     it "should raise an error" do
-      msg = "Unable to find radio button \"does not exist\""
+      msg = "Unable to find visible radio button \"does not exist\" that is not disabled"
       expect do
         @session.choose('does not exist')
       end.to raise_error(Capybara::ElementNotFound, msg)
@@ -40,29 +41,54 @@ Capybara::SpecHelper.spec "#choose" do
 
   context "with :exact option" do
     it "should accept partial matches when false" do
-      @session.choose("Mal", :exact => false)
+      @session.choose("Mal", exact:  false)
       @session.click_button('awesome')
       expect(extract_results(@session)['gender']).to eq('male')
     end
 
     it "should not accept partial matches when true" do
       expect do
-        @session.choose("Mal", :exact => true)
+        @session.choose("Mal", exact:  true)
       end.to raise_error(Capybara::ElementNotFound)
     end
   end
 
   context "with `option` option" do
     it "can check radio buttons by their value" do
-      @session.choose('form[gender]', :option => "male")
+      @session.choose('form[gender]', option: "male")
       @session.click_button('awesome')
       expect(extract_results(@session)['gender']).to eq("male")
     end
 
     it "should raise an error if option not found" do
       expect do
-        @session.choose('form[gender]', :option => "hermaphrodite")
+        @session.choose('form[gender]', option: "hermaphrodite")
       end.to raise_error(Capybara::ElementNotFound)
     end
   end
+
+  context "with hidden radio buttons" 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 select by clicking the link if available" do
+        @session.choose("party_democrat")
+        @session.click_button('awesome')
+        expect(extract_results(@session)['party']).to eq('democrat')
+      end
+
+      it "should raise error if not allowed to click label" do
+        expect{@session.choose("party_democrat", allow_label_click: false)}.to raise_error(Capybara::ElementNotFound, 'Unable to find visible radio button "party_democrat" that is not disabled')
+      end
+    end
+  end
+
+  it "should return the chosen radio button" do
+    el = @session.find(:radio_button, 'gender_male')
+    expect(@session.choose("gender_male")).to eq el
+  end
 end

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

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 Capybara::SpecHelper.spec '#click_button' do
   before do
     @session.visit('/form')
   end
 
-  it "should wait for asynchronous load", :requires => [:js] do
+  it "should wait for asynchronous load", requires: [:js] do
     @session.visit('/with_js')
     @session.click_link('Click me')
     @session.click_button('New Here')
@@ -337,9 +338,22 @@ Capybara::SpecHelper.spec '#click_button' do
       expect(extract_results(@session)['first_name']).to eq('John')
     end
   end
+
+  context "with descendant image alt given on a button defined by <button> tag" do
+    it "should submit the associated form" do
+      @session.click_button('A horse eating hay')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it "should work with partial matches" do
+      @session.click_button('se eating h')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+  end
+
   context "with a locator that doesn't exist" do
     it "should raise an error" do
-      msg = "Unable to find button \"does not exist\""
+      msg = "Unable to find visible button \"does not exist\""
       expect do
         @session.click_button('does not exist')
       end.to raise_error(Capybara::ElementNotFound, msg)
@@ -412,12 +426,9 @@ Capybara::SpecHelper.spec '#click_button' do
     @session.visit('/form')
     @session.fill_in('address1_city', :with =>'Paris')
     @session.fill_in('address1_street', :with =>'CDG')
-    @session.fill_in('address1_street', :with =>'CDG')
-    @session.select("France", :from => 'address1_country')
 
-    @session.fill_in('address2_city', :with => 'Mikolaiv')
-    @session.fill_in('address2_street', :with => 'PGS')
-    @session.select("Ukraine", :from => 'address2_country')
+    @session.fill_in('address2_city', with: 'Mikolaiv')
+    @session.fill_in('address2_street', with: 'PGS')
 
     @session.click_button "awesome"
 
@@ -435,13 +446,13 @@ Capybara::SpecHelper.spec '#click_button' do
 
   context "with :exact option" do
     it "should accept partial matches when false" do
-      @session.click_button('What an Awesome', :exact => false)
+      @session.click_button('What an Awesome', exact:  false)
       expect(extract_results(@session)['first_name']).to eq('John')
     end
 
     it "should not accept partial matches when true" do
       expect do
-        @session.click_button('What an Awesome', :exact => true)
+        @session.click_button('What an Awesome', exact:  true)
       end.to raise_error(Capybara::ElementNotFound)
     end
   end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 Capybara::SpecHelper.spec '#click_link_or_button' do
   it "should click on a link" do
     @session.visit('/with_html')
@@ -23,7 +24,7 @@ Capybara::SpecHelper.spec '#click_link_or_button' do
     expect(extract_results(@session)['first_name']).to eq('John')
   end
 
-  it "should wait for asynchronous load", :requires => [:js] do
+  it "should wait for asynchronous load", requires: [:js] do
     @session.visit('/with_js')
     @session.click_link('Click me')
     @session.click_link_or_button('Has been clicked')
@@ -39,7 +40,7 @@ Capybara::SpecHelper.spec '#click_link_or_button' do
     context "when `true`" do
       it "clicks on approximately matching link" do
         @session.visit('/with_html')
-        @session.click_link_or_button('abore', :exact => false)
+        @session.click_link_or_button('abore', exact:  false)
         expect(@session).to have_content('Bar')
       end
 
@@ -53,18 +54,18 @@ Capybara::SpecHelper.spec '#click_link_or_button' do
     context "when `false`" do
       it "does not click on link which matches approximately" do
         @session.visit('/with_html')
-        msg = "Unable to find link or button \"abore\""
+        msg = "Unable to find visible link or button \"abore\""
         expect do
-          @session.click_link_or_button('abore', :exact => true)
+          @session.click_link_or_button('abore', exact:  true)
         end.to raise_error(Capybara::ElementNotFound, msg)
       end
 
       it "does not click on approximately matching button" do
         @session.visit('/form')
-        msg = "Unable to find link or button \"awe\""
+        msg = "Unable to find visible link or button \"awe\""
 
         expect do
-          @session.click_link_or_button('awe', :exact => true)
+          @session.click_link_or_button('awe', exact:  true)
         end.to raise_error(Capybara::ElementNotFound, msg)
       end
     end
@@ -73,7 +74,7 @@ Capybara::SpecHelper.spec '#click_link_or_button' do
   context "with a locator that doesn't exist" do
     it "should raise an error" do
       @session.visit('/with_html')
-      msg = "Unable to find link or button \"does not exist\""
+      msg = "Unable to find visible link or button \"does not exist\""
       expect do
         @session.click_link_or_button('does not exist')
       end.to raise_error(Capybara::ElementNotFound, msg)
@@ -84,7 +85,7 @@ Capybara::SpecHelper.spec '#click_link_or_button' do
     it "ignores disabled buttons when false" do
       @session.visit('/form')
       expect do
-        @session.click_link_or_button('Disabled button', :disabled => false)
+        @session.click_link_or_button('Disabled button', disabled: false)
       end.to raise_error(Capybara::ElementNotFound)
     end
 
@@ -104,9 +105,14 @@ Capybara::SpecHelper.spec '#click_link_or_button' do
     it "does nothing when button is disabled" do
       @session.visit('/form')
       expect do
-        @session.click_link_or_button('Disabled button', :disabled => false)
+        @session.click_link_or_button('Disabled button', disabled: false)
       end.to raise_error(Capybara::ElementNotFound)
     end
+  end
 
+  it "should return the element clicked" do
+    @session.visit('/with_html')
+    link = @session.find(:link, 'Blank Anchor')
+    expect(@session.click_link_or_button('Blank Anchor')).to eq link
   end
 end

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

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 Capybara::SpecHelper.spec '#click_link' do
   before do
     @session.visit('/with_html')
   end
 
-  it "should wait for asynchronous load", :requires => [:js] do
+  it "should wait for asynchronous load", requires: [:js] do
     @session.visit('/with_js')
     @session.click_link('Click me')
     @session.click_link('Has been clicked')
@@ -14,7 +15,7 @@ Capybara::SpecHelper.spec '#click_link' do
     expect(@session).to have_content('Another World')
   end
 
-  it "raises any errors caught inside the server", :requires => [:server] do
+  it "raises any errors caught inside the server", requires: [:server] do
     quietly { @session.visit("/error") }
     expect do
       @session.click_link('foo')
@@ -66,7 +67,7 @@ Capybara::SpecHelper.spec '#click_link' do
 
   context "with a locator that doesn't exist" do
     it "should raise an error" do
-      msg = "Unable to find link \"does not exist\""
+      msg = "Unable to find visible link \"does not exist\""
       expect do
         @session.click_link('does not exist')
       end.to raise_error(Capybara::ElementNotFound, msg)
@@ -75,34 +76,45 @@ Capybara::SpecHelper.spec '#click_link' do
 
   context "with :href option given" do
     it "should find links with valid href" do
-      @session.click_link('labore', :href => '/with_simple_html')
+      @session.click_link('labore', href: '/with_simple_html')
       expect(@session).to have_content('Bar')
     end
 
     it "should raise error if link wasn't found" do
-      expect { @session.click_link('labore', :href => 'invalid_href') }.to raise_error(Capybara::ElementNotFound)
+      expect { @session.click_link('labore', href: 'invalid_href') }.to raise_error(Capybara::ElementNotFound)
     end
   end
 
   context "with a regex :href option given"  do
     it "should find a link matching an all-matching regex pattern" do
-      @session.click_link('labore', :href => /.+/)
+      @session.click_link('labore', href: /.+/)
       expect(@session).to have_content('Bar')
     end
 
     it "should find a link matching an exact regex pattern" do
-      @session.click_link('labore', :href => /\/with_simple_html/)
+      @session.click_link('labore', href: /\/with_simple_html/)
       expect(@session).to have_content('Bar')
     end
 
     it "should find a link matching a partial regex pattern" do
-      @session.click_link('labore', :href => /\/with_simple/)
+      @session.click_link('labore', href: /\/with_simple/)
       expect(@session).to have_content('Bar')
     end
 
     it "should raise an error if no link's href matched the pattern" do
-      expect { @session.click_link('labore', :href => /invalid_pattern/) }.to raise_error(Capybara::ElementNotFound)
-      expect { @session.click_link('labore', :href => /.+d+/) }.to raise_error(Capybara::ElementNotFound)
+      expect { @session.click_link('labore', href: /invalid_pattern/) }.to raise_error(Capybara::ElementNotFound)
+      expect { @session.click_link('labore', href: /.+d+/) }.to raise_error(Capybara::ElementNotFound)
+    end
+
+    context 'href: nil' do
+      it "should not raise an error on links with no href attribute" do
+        expect { @session.click_link('No Href', href: nil) }.not_to raise_error
+      end
+
+      it "should raise an error if href attribute exists" do
+        expect { @session.click_link('Blank Href', href: nil) }.to raise_error(Capybara::ElementNotFound)
+        expect { @session.click_link('Normal Anchor', href: nil) }.to raise_error(Capybara::ElementNotFound)
+      end
     end
   end
 
@@ -134,7 +146,7 @@ Capybara::SpecHelper.spec '#click_link' do
   end
 
   it "should do nothing on anchor links" do
-    @session.fill_in("test_field", :with => 'blah')
+    @session.fill_in("test_field", with: 'blah')
     @session.click_link('Normal Anchor')
     expect(@session.find_field("test_field").value).to eq('blah')
     @session.click_link('Blank Anchor')
@@ -144,7 +156,7 @@ Capybara::SpecHelper.spec '#click_link' do
   end
 
   it "should do nothing on URL+anchor links for the same page" do
-    @session.fill_in("test_field", :with => 'blah')
+    @session.fill_in("test_field", with: 'blah')
     @session.click_link('Anchor on same page')
     expect(@session.find_field("test_field").value).to eq('blah')
   end
@@ -160,7 +172,7 @@ Capybara::SpecHelper.spec '#click_link' do
     expect(@session).to have_content('Bar')
   end
 
-  it "raise an error with links with no href" do
+  it "should raise an error with links with no href" do
     expect do
       @session.click_link('No Href')
     end.to raise_error(Capybara::ElementNotFound)
@@ -168,14 +180,26 @@ Capybara::SpecHelper.spec '#click_link' do
 
   context "with :exact option" do
     it "should accept partial matches when false" do
-      @session.click_link('abo', :exact => false)
+      @session.click_link('abo', exact:  false)
       expect(@session).to have_content('Bar')
     end
 
     it "should not accept partial matches when true" do
       expect do
-        @session.click_link('abo', :exact => true)
+        @session.click_link('abo', exact:  true)
       end.to raise_error(Capybara::ElementNotFound)
     end
   end
+
+  context "without locator" do
+    it "uses options" do
+      @session.click_link(href: '/foo')
+      expect(@session).to have_content('Another World')
+    end
+  end
+
+  it "should return element clicked" do
+    el = @session.find(:link, 'Normal Anchor')
+    expect(@session.click_link('Normal Anchor')).to eq el
+  end
 end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 Capybara::SpecHelper.spec '#current_scope' do
   before do
     @session.visit('/with_scope')
@@ -26,4 +27,4 @@ Capybara::SpecHelper.spec '#current_scope' do
       end
     end
   end
-end
+end

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

@@ -1,8 +1,9 @@
+# frozen_string_literal: true
 require "capybara/spec/test_app"
 
 Capybara::SpecHelper.spec '#current_url, #current_path, #current_host' do
   before :all do
-    @servers = 2.times.map { Capybara::Server.new(TestApp.clone).boot }
+    @servers = 2.times.map { Capybara::Server.new(TestApp.new).boot }
     # sanity check
     expect(@servers[0].port).not_to eq(@servers[1].port)
     expect(@servers.map { |s| s.port }).not_to include 80
@@ -84,15 +85,23 @@ Capybara::SpecHelper.spec '#current_url, #current_path, #current_host' do
     should_be_on 0, "/landed"
   end
 
-  it "is affected by pushState", :requires => [:js] do
+  it "is affected by pushState", requires: [:js] do
     @session.visit("/with_js")
     @session.execute_script("window.history.pushState({}, '', '/pushed')")
     expect(@session.current_path).to eq("/pushed")
   end
 
-  it "is affected by replaceState", :requires => [:js] do
+  it "is affected by replaceState", requires: [:js] do
     @session.visit("/with_js")
     @session.execute_script("window.history.replaceState({}, '', '/replaced')")
     expect(@session.current_path).to eq("/replaced")
   end
+
+  it "doesn't raise exception on a nil current_url" do
+    skip "Only makes sense when there is a real driver" unless @session.respond_to?(:driver)
+    allow(@session.driver).to receive(:current_url) { nil }
+    @session.visit("/")
+    expect { @session.current_url }.not_to raise_exception
+    expect { @session.current_path }.not_to raise_exception
+  end
 end

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

@@ -1,4 +1,5 @@
-Capybara::SpecHelper.spec '#dismiss_confirm', :requires => [:modals] do
+# frozen_string_literal: true
+Capybara::SpecHelper.spec '#dismiss_confirm', requires: [:modals] do
   before do
     @session.visit('/with_js')
   end
@@ -9,14 +10,14 @@ Capybara::SpecHelper.spec '#dismiss_confirm', :requires => [:modals] do
     end
     expect(@session).to have_xpath("//a[@id='open-confirm' and @confirmed='false']")
   end
-  
+
   it "should dismiss the confirm if the message matches" do
     @session.dismiss_confirm 'Confirm opened' do
       @session.click_link('Open confirm')
     end
     expect(@session).to have_xpath("//a[@id='open-confirm' and @confirmed='false']")
   end
-  
+
   it "should not dismiss the confirm if the message doesn't match" do
     expect do
       @session.dismiss_confirm 'Incorrect Text' do
@@ -24,7 +25,7 @@ Capybara::SpecHelper.spec '#dismiss_confirm', :requires => [:modals] do
       end
     end.to raise_error(Capybara::ModalNotFound)
   end
-    
+
 
   it "should return the message presented" do
     message = @session.dismiss_confirm do
@@ -32,4 +33,4 @@ Capybara::SpecHelper.spec '#dismiss_confirm', :requires => [:modals] do
     end
     expect(message).to eq('Confirm opened')
   end
-end
+end

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

@@ -1,4 +1,5 @@
-Capybara::SpecHelper.spec '#dismiss_prompt', :requires => [:modals] do
+# frozen_string_literal: true
+Capybara::SpecHelper.spec '#dismiss_prompt', requires: [:modals] do
   before do
     @session.visit('/with_js')
   end
@@ -9,11 +10,11 @@ Capybara::SpecHelper.spec '#dismiss_prompt', :requires => [:modals] do
     end
     expect(@session).to have_xpath("//a[@id='open-prompt' and @response='dismissed']")
   end
-  
+
   it "should return the message presented" do
     message = @session.dismiss_prompt do
       @session.click_link('Open prompt')
     end
     expect(message).to eq('Prompt opened')
   end
-end
+end

data/lib/capybara/spec/session/element/assert_match_selector.rb

@@ -0,0 +1,36 @@
+Capybara::SpecHelper.spec '#assert_matches_selector' do
+  before do
+    @session.visit('/with_html')
+    @element = @session.find(:css, 'span', text: '42')
+  end
+
+  it "should be true if the given selector matches the element" do
+    expect(@element.assert_matches_selector(:css, '.number')).to be true
+  end
+
+  it "should be false if the given selector does not match the element" do
+    expect { @element.assert_matches_selector(:css, '.not_number') }.to raise_error(Capybara::ElementNotFound)
+  end
+
+  it "should not be callable on the session" do
+    expect { @session.assert_matches_selector(:css, '.number') }.to raise_error(NoMethodError)
+  end
+
+  it "should wait for match to occur", requires: [:js] do
+    @session.visit('/with_js')
+    input = @session.find(:css, '#disable-on-click')
+
+    expect(input.assert_matches_selector(:css, 'input:enabled')).to be true
+    input.click
+    expect(input.assert_matches_selector(:css, 'input:disabled')).to be true
+  end
+
+  it "should not accept count options" do
+    expect { @element.assert_matches_selector(:css, '.number', count: 1) }.to raise_error(ArgumentError)
+  end
+
+  it "should accept a filter block" do
+    @element.assert_matches_selector(:css, 'span') { |el| el[:class] == "number" }
+    @element.assert_not_matches_selector(:css,'span') { |el| el[:class] == "not_number" }
+  end
+end

data/lib/capybara/spec/session/element/match_css_spec.rb

@@ -0,0 +1,23 @@
+Capybara::SpecHelper.spec '#match_css?' do
+  before do
+    @session.visit('/with_html')
+    @element = @session.find(:css, 'span', text: '42')
+  end
+
+  it "should be true if the given selector matches the element" do
+    expect(@element).to match_css("span")
+    expect(@element).to match_css("span.number")
+  end
+
+  it "should be false if the given selector does not match" do
+    expect(@element).not_to match_css("div")
+    expect(@element).not_to match_css("p a#doesnotexist")
+    expect(@element).not_to match_css("p.nosuchclass")
+  end
+
+  it "should accept an optional filter block" do
+    # This would be better done with
+    expect(@element).to match_css('span') { |el| el[:class] == "number" }
+    expect(@element).not_to match_css('span') { |el| el[:class] == "not_number" }
+  end
+end

data/lib/capybara/spec/session/element/match_xpath_spec.rb

@@ -0,0 +1,23 @@
+Capybara::SpecHelper.spec '#match_xpath?' do
+  before do
+    @session.visit('/with_html')
+    @element = @session.find(:css, 'span.number')
+  end
+
+  it "should be true if the given selector is on the page" do
+    expect(@element).to match_xpath("//span")
+    expect(@element).to match_xpath("//span[@class='number']")
+  end
+
+  it "should be false if the given selector is not on the page" do
+    expect(@element).not_to match_xpath("//abbr")
+    expect(@element).not_to match_xpath("//div")
+    expect(@element).not_to match_xpath("//span[@class='not_a_number']")
+  end
+
+  it "should use xpath even if default selector is CSS" do
+    Capybara.default_selector = :css
+    expect(@element).not_to have_xpath("//span[@class='not_a_number']")
+    expect(@element).not_to have_xpath("//div[@class='number']")
+  end
+end

data/lib/capybara/spec/session/element/matches_selector_spec.rb

@@ -0,0 +1,106 @@
+Capybara::SpecHelper.spec '#match_selector?' do
+  before do
+    @session.visit('/with_html')
+    @element = @session.find('//span', text: '42')
+  end
+
+  it "should be true if the element matches the given selector" do
+    expect(@element).to match_selector(:xpath, "//span")
+    expect(@element).to match_selector(:css, 'span.number')
+    expect(@element.matches_selector?(:css, 'span.number')).to be true
+  end
+
+  it "should be false if the element does not match the given selector" do
+    expect(@element).not_to match_selector(:xpath, "//div")
+    expect(@element).not_to match_selector(:css, "span.not_a_number")
+    expect(@element.matches_selector?(:css, "span.not_a_number")).to be false
+  end
+
+  it "should use default selector" do
+    Capybara.default_selector = :css
+    expect(@element).not_to match_selector("span.not_a_number")
+    expect(@element).to match_selector("span.number")
+  end
+
+  context "with text" do
+    it "should discard all matches where the given string is not contained" do
+      expect(@element).to match_selector("//span", text: "42")
+      expect(@element).not_to match_selector("//span", text: "Doesnotexist")
+    end
+  end
+
+  it "should have css sugar" do
+    expect(@element.matches_css?('span.number')).to be true
+    expect(@element.matches_css?('span.not_a_number')).to be false
+    expect(@element.matches_css?('span.number', text: "42")).to be true
+    expect(@element.matches_css?('span.number', text: "Nope")).to be false
+  end
+
+  it "should have xpath sugar" do
+    expect(@element.matches_xpath?("//span")).to be true
+    expect(@element.matches_xpath?("//div")).to be false
+    expect(@element.matches_xpath?("//span", text: '42')).to be true
+    expect(@element.matches_xpath?("//span", text: 'Nope')).to be false
+  end
+
+  it 'should accept selector filters' do
+    @session.visit('/form')
+    cbox = @session.find(:css, '#form_pets_dog')
+    expect(cbox.matches_selector?(:checkbox, id: 'form_pets_dog', option: 'dog', name: 'form[pets][]', checked: true)).to be true
+  end
+
+  it 'should accept a custom filter block' do
+    @session.visit('/form')
+    cbox = @session.find(:css, '#form_pets_dog')
+    expect(cbox).to match_selector(:checkbox){ |node| node[:id] == "form_pets_dog"}
+    expect(cbox).not_to match_selector(:checkbox){ |node| node[:id] != "form_pets_dog"}
+    expect(cbox.matches_selector?(:checkbox){ |node| node[:id] == "form_pets_dog"}).to be true
+    expect(cbox.matches_selector?(:checkbox){ |node| node[:id] != "form_pets_dog"}).to be false
+  end
+end
+
+Capybara::SpecHelper.spec '#not_matches_selector?' do
+  before do
+    @session.visit('/with_html')
+    @element = @session.find(:css, "span", text: 42)
+  end
+
+  it "should be false if the given selector matches the element" do
+    expect(@element).not_to not_match_selector(:xpath, "//span")
+    expect(@element).not_to not_match_selector(:css, "span.number")
+    expect(@element.not_matches_selector?(:css, "span.number")).to be false
+  end
+
+  it "should be true if the given selector does not match the element" do
+    expect(@element).to not_match_selector(:xpath, "//abbr")
+    expect(@element).to not_match_selector(:css, "p a#doesnotexist")
+    expect(@element.not_matches_selector?(:css, "p a#doesnotexist")).to be true
+  end
+
+  it "should use default selector" do
+    Capybara.default_selector = :css
+    expect(@element).to not_match_selector("p a#doesnotexist")
+    expect(@element).not_to not_match_selector("span.number")
+  end
+
+  context "with text" do
+    it "should discard all matches where the given string is contained" do
+      expect(@element).not_to not_match_selector(:css, "span.number", text: "42")
+      expect(@element).to not_match_selector(:css, "span.number", text: "Doesnotexist")
+    end
+  end
+
+  it "should have CSS sugar" do
+    expect(@element.not_matches_css?("span.number")).to be false
+    expect(@element.not_matches_css?("p a#doesnotexist")).to be true
+    expect(@element.not_matches_css?("span.number", text: "42")).to be false
+    expect(@element.not_matches_css?("span.number", text: "Doesnotexist")).to be true
+  end
+
+  it "should have xpath sugar" do
+    expect(@element.not_matches_xpath?("//span")).to be false
+    expect(@element.not_matches_xpath?("//div")).to be true
+    expect(@element.not_matches_xpath?("//span", text: "42")).to be false
+    expect(@element.not_matches_xpath?("//span", text: "Doesnotexist")).to be true
+  end
+end if Gem::Version.new(RSpec::Expectations::Version::STRING) >= Gem::Version.new('3.1')