capybara 2.15.0 → 3.0.0

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

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 Capybara::SpecHelper.spec '#first' do
   before do
     @session.visit('/with_html')
@@ -9,8 +10,16 @@ Capybara::SpecHelper.spec '#first' do
     expect(@session.first("//input[@id='test_field']").value).to eq('monkey')
   end
 
-  it "should return nil when nothing was found" do
-    expect(@session.first('//div[@id="nosuchthing"]')).to be_nil
+  it "should raise ElementNotFound when nothing was found" do
+    expect do
+      @session.first('//div[@id="nosuchthing"]')
+    end.to raise_error Capybara::ElementNotFound
+  end
+
+  it "should return nil when nothing was found if count options allow no results" do
+    expect(@session.first('//div[@id="nosuchthing"]', minimum: 0)).to be_nil
+    expect(@session.first('//div[@id="nosuchthing"]', count: 0)).to be_nil
+    expect(@session.first('//div[@id="nosuchthing"]', between: (0..3))).to be_nil
   end
 
   it "should accept an XPath instance" do
@@ -20,9 +29,10 @@ Capybara::SpecHelper.spec '#first' do
     expect(@session.first(@xpath).value).to eq('John')
   end
 
-  it "should warn when unused parameters are passed" do
-    expect_any_instance_of(Kernel).to receive(:warn).with(/Unused parameters passed.*unused text/)
-    @session.first(:css, '.header h2', 'unused text')
+  it "should raise when unused parameters are passed" do
+    expect do
+      @session.first(:css, 'h1', 'unused text')
+    end.to raise_error ArgumentError, /Unused parameters passed.*unused text/
   end
 
   context "with css selectors" do
@@ -49,40 +59,52 @@ Capybara::SpecHelper.spec '#first' do
 
   context "with visible filter" do
     it "should only find visible nodes when true" do
-      expect(@session.first(:css, "a#invisible", visible: true)).to be_nil
+      expect do
+        @session.first(:css, "a#invisible", visible: true)
+      end.to raise_error Capybara::ElementNotFound
     end
 
     it "should find nodes regardless of whether they are invisible when false" do
-      expect(@session.first(:css, "a#invisible", visible: false)).not_to be_nil
-      expect(@session.first(:css, "a#invisible", visible: false, text: 'hidden link')).not_to be_nil
-      expect(@session.first(:css, "a#visible", visible: false)).not_to be_nil
+      expect(@session.first(:css, "a#invisible", visible: false)).to be
+      expect(@session.first(:css, "a#invisible", visible: false, text: 'hidden link')).to be
+      expect(@session.first(:css, "a#visible", visible: false)).to be
     end
 
     it "should find nodes regardless of whether they are invisible when :all" do
-      expect(@session.first(:css, "a#invisible", visible: :all)).not_to be_nil
-      expect(@session.first(:css, "a#invisible", visible: :all, text: 'hidden link')).not_to be_nil
-      expect(@session.first(:css, "a#visible", visible: :all)).not_to be_nil
+      expect(@session.first(:css, "a#invisible", visible: :all)).to be
+      expect(@session.first(:css, "a#invisible", visible: :all, text: 'hidden link')).to be
+      expect(@session.first(:css, "a#visible", visible: :all)).to be
     end
 
     it "should find only hidden nodes when :hidden" do
-      expect(@session.first(:css, "a#invisible", visible: :hidden)).not_to be_nil
-      expect(@session.first(:css, "a#invisible", visible: :hidden, text: 'hidden link')).not_to be_nil
-      expect(@session.first(:css, "a#invisible", visible: :hidden, text: 'not hidden link')).to be_nil
-      expect(@session.first(:css, "a#visible", visible: :hidden)).to be_nil
+      expect(@session.first(:css, "a#invisible", visible: :hidden)).to be
+      expect(@session.first(:css, "a#invisible", visible: :hidden, text: 'hidden link')).to be
+      expect do
+        @session.first(:css, "a#invisible", visible: :hidden, text: 'not hidden link')
+      end.to raise_error Capybara::ElementNotFound
+      expect do
+        @session.first(:css, "a#visible", visible: :hidden)
+      end.to raise_error Capybara::ElementNotFound
     end
 
     it "should find only visible nodes when :visible" do
-      expect(@session.first(:css, "a#invisible", visible: :visible)).to be_nil
-      expect(@session.first(:css, "a#invisible", visible: :visible, text: 'hidden link')).to be_nil
-      expect(@session.first(:css, "a#visible", visible: :visible)).not_to be_nil
+      expect do
+        @session.first(:css, "a#invisible", visible: :visible)
+      end.to raise_error Capybara::ElementNotFound
+      expect do
+        @session.first(:css, "a#invisible", visible: :visible, text: 'hidden link')
+      end.to raise_error Capybara::ElementNotFound
+      expect(@session.first(:css, "a#visible", visible: :visible)).to be
     end
 
     it "should default to Capybara.ignore_hidden_elements" do
       Capybara.ignore_hidden_elements = true
-      expect(@session.first(:css, "a#invisible")).to be_nil
+      expect do
+        @session.first(:css, "a#invisible")
+      end.to raise_error Capybara::ElementNotFound
       Capybara.ignore_hidden_elements = false
-      expect(@session.first(:css, "a#invisible")).not_to be_nil
-      expect(@session.first(:css, "a")).not_to be_nil
+      expect(@session.first(:css, "a#invisible")).to be
+      expect(@session.first(:css, "a")).to be
     end
   end
 
@@ -93,35 +115,40 @@ Capybara::SpecHelper.spec '#first' do
 
     it "should find the first element using the given locator" do
       @session.within(:xpath, "//div[@id='for_bar']") do
-        expect(@session.first('.//form')).not_to be_nil
+        expect(@session.first('.//form')).to be
       end
     end
   end
 
-  context "with Capybara.wait_on_first_by_default", requires: [:js] do
+  context "waiting behavior", requires: [:js] do
     before do
       @session.visit('/with_js')
     end
 
-    it "should not wait if false" do
-      Capybara.wait_on_first_by_default = false
+    it "should not wait if minimum: 0" do
       @session.click_link('clickable')
-      expect(@session.first(:css, 'a#has-been-clicked')).to be_nil
+      Capybara.using_wait_time(3) do
+        start_time = Time.now
+        expect(@session.first(:css, 'a#has-been-clicked', minimum: 0)).to be_nil
+        expect(Time.now - start_time).to be < 3
+      end
     end
 
-    it "should wait for at least one match if true" do
-      Capybara.wait_on_first_by_default = true
+    it "should wait for at least one match by default" do
       Capybara.using_wait_time(3) do
         @session.click_link('clickable')
         expect(@session.first(:css, 'a#has-been-clicked')).not_to be_nil
       end
     end
 
-    it "should return nil after waiting if no match" do
-      Capybara.wait_on_first_by_default = true
+    it "should raise an error after waiting if no match" do
+      @session.click_link('clickable')
       Capybara.using_wait_time(3) do
-        @session.click_link('clickable')
-        expect(@session.first(:css, 'a#not-a-real-link')).to be_nil
+        start_time = Time.now
+        expect do
+          @session.first(:css, 'a#not-a-real-link')
+        end.to raise_error Capybara::ElementNotFound
+        expect(Time.now - start_time).to be > 3
       end
     end
   end

data/lib/capybara/spec/session/frame/frame_title_spec.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#frame_title', requires: [:frames] do
+  before(:each) do
+    @session.visit('/within_frames')
+  end
+
+  it "should return the title in a frame" do
+    @session.within_frame("frameOne") do
+      expect(@session.driver.frame_title).to eq 'This is the title of frame one'
+    end
+  end
+
+  it "should return the title in FrameTwo" do
+    @session.within_frame("frameTwo") do
+      expect(@session.driver.frame_title).to eq 'This is the title of frame two'
+    end
+  end
+
+  it "should return the title in the main frame" do
+    expect(@session.driver.frame_title).to eq 'With Frames'
+  end
+end

data/lib/capybara/spec/session/frame/frame_url_spec.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#frame_url', requires: [:frames] do
+  before(:each) do
+    @session.visit('/within_frames')
+  end
+
+  it "should return the url in a frame" do
+    @session.within_frame("frameOne") do
+      expect(@session.driver.frame_url).to end_with '/frame_one'
+    end
+  end
+
+  it "should return the url in FrameTwo" do
+    @session.within_frame("frameTwo") do
+      expect(@session.driver.frame_url).to end_with '/frame_two'
+    end
+  end
+
+  it "should return the url in the main frame" do
+    expect(@session.driver.frame_url).to end_with('/within_frames')
+  end
+end

data/lib/capybara/spec/session/frame/switch_to_frame_spec.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 Capybara::SpecHelper.spec '#switch_to_frame', requires: [:frames] do
   before(:each) do
     @session.visit('/within_frames')
@@ -47,7 +48,7 @@ Capybara::SpecHelper.spec '#switch_to_frame', requires: [:frames] do
     end
   end
 
-  it "works if the frame is closed", requires: [:frames, :js] do
+  it "works if the frame is closed", requires: %i[frames js] do
     frame = @session.find(:frame, 'parentFrame')
     @session.switch_to_frame frame
     frame = @session.find(:frame, 'childFrame')

data/lib/capybara/spec/session/frame/within_frame_spec.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 Capybara::SpecHelper.spec '#within_frame', requires: [:frames] do
   before(:each) do
     @session.visit('/within_frames')
@@ -56,21 +57,25 @@ Capybara::SpecHelper.spec '#within_frame', requires: [:frames] do
   it "should find multiple nested frames" do
     @session.within_frame 'parentFrame' do
       @session.within_frame 'childFrame' do
-        @session.within_frame 'grandchildFrame1' do end
-        @session.within_frame 'grandchildFrame2' do end
+        @session.within_frame 'grandchildFrame1' do
+          # dummy
+        end
+        @session.within_frame 'grandchildFrame2' do
+          # dummy
+        end
       end
     end
   end
 
   it "should reset scope when changing frames" do
     @session.within(:css, '#divInMainWindow') do
-      @session.within_frame 'parentFrame' do
+      @session.within_frame 'innerParentFrame' do
         expect(@session.has_selector?(:css, "iframe#childFrame")).to be true
       end
     end
   end
 
-  it "works if the frame is closed", requires: [:frames, :js] do
+  it "works if the frame is closed", requires: %i[frames js] do
     @session.within_frame 'parentFrame' do
       @session.within_frame 'childFrame' do
         @session.click_link 'Close Window'
@@ -79,16 +84,4 @@ Capybara::SpecHelper.spec '#within_frame', requires: [:frames] do
       expect(@session).not_to have_selector(:css, '#childFrame')
     end
   end
-
-  it "should support the driver #switch_to_frame api" do
-    # This test is purely to notify driver authors to update their API.
-    # The #switch_to_frame API will be required in the next version (> 2.8) of Capybara for frames support.
-    # It should not be used as an example of code for users.
-    frame = @session.find(:frame, "frameOne")
-    expect {
-      @session.driver.switch_to_frame(frame)
-      sleep 0.5
-      @session.driver.switch_to_frame(:parent)
-    }.not_to raise_error
-  end
 end

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

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 Capybara::SpecHelper.spec '#go_back', requires: [:js] do
   it "should fetch a response from the driver from the previous page" do
     @session.visit('/')

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

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 Capybara::SpecHelper.spec '#go_forward', requires: [:js] do
   it "should fetch a response from the driver from the previous page" do
     @session.visit('/')

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

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#have_all_selectors' do
+  before do
+    @session.visit('/with_html')
+  end
+
+  it "should be true if the given selectors are on the page" do
+    expect(@session).to have_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 do
+      expect(@session).to have_all_of_selectors(:css, "p a#foo", "h2#h2three", "h2#h2one")
+    end.to raise_error ::RSpec::Expectations::ExpectationNotMetError
+  end
+
+  it "should use default selector" do
+    Capybara.default_selector = :css
+    expect(@session).to have_all_of_selectors("p a#foo", "h2#h2two", "h2#h2one")
+    expect do
+      expect(@session).to have_all_of_selectors("p a#foo", "h2#h2three", "h2#h2one")
+    end.to raise_error ::RSpec::Expectations::ExpectationNotMetError
+  end
+
+  context "should respect scopes" do
+    it "when used with `within`" do
+      @session.within "//p[@id='first']" do
+        expect(@session).to have_all_of_selectors(".//a[@id='foo']")
+        expect do
+          expect(@session).to have_all_of_selectors(".//a[@id='red']")
+        end.to raise_error ::RSpec::Expectations::ExpectationNotMetError
+      end
+    end
+
+    it "when called on elements" do
+      el = @session.find "//p[@id='first']"
+      expect(el).to have_all_of_selectors(".//a[@id='foo']")
+      expect do
+        expect(el).to have_all_of_selectors(".//a[@id='red']")
+      end.to raise_error ::RSpec::Expectations::ExpectationNotMetError
+    end
+  end
+
+  context "with options" do
+    it "should apply options to all locators" do
+      expect(@session).to have_all_of_selectors(:field, 'normal', 'additional_newline', type: :textarea)
+      expect do
+        expect(@session).to have_all_of_selectors(:field, 'normal', 'test_field', 'additional_newline', type: :textarea)
+      end.to raise_error ::RSpec::Expectations::ExpectationNotMetError
+    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')
+        expect(@session).to have_all_of_selectors(:css, "a#clickable", "a#has-been-clicked", '#drag', wait: 0.9)
+      end
+    end
+  end
+
+  it "cannot be negated" do
+    expect do
+      expect(@session).not_to have_all_of_selectors(:css, "p a#foo", "h2#h2one", "h2#h2two")
+    end.to raise_error ArgumentError
+  end
+end

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

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 Capybara::SpecHelper.spec '#has_button?' do
   before do
     @session.visit('/form')
@@ -7,7 +8,7 @@ Capybara::SpecHelper.spec '#has_button?' do
   it "should be true if the given button is on the page" do
     expect(@session).to have_button('med')
     expect(@session).to have_button('crap321')
-    expect(@session).to have_button(:'crap321')
+    expect(@session).to have_button(:crap321)
   end
 
   it "should be true for disabled buttons if disabled: true" do

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

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 Capybara::SpecHelper.spec '#has_css?' do
   before do
     @session.visit('/with_html')
@@ -36,7 +37,7 @@ Capybara::SpecHelper.spec '#has_css?' do
     end
 
     it "should be false if the content occurs more or fewer times than range" do
-      expect(@session).not_to have_css("p", between: 6..11 )
+      expect(@session).not_to have_css("p", between: 6..11)
       expect(@session).not_to have_css("p a#foo", between: 4..7)
       expect(@session).not_to have_css("p a.doesnotexist", between: 3..8)
     end
@@ -162,7 +163,7 @@ Capybara::SpecHelper.spec '#has_no_css?' do
     end
 
     it "should be true if the content occurs more or fewer times than range" do
-      expect(@session).to have_no_css("p", between: 6..11 )
+      expect(@session).to have_no_css("p", between: 6..11)
       expect(@session).to have_no_css("p a#foo", between: 4..7)
       expect(@session).to have_no_css("p a.doesnotexist", between: 3..8)
     end

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

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 Capybara::SpecHelper.spec '#has_current_path?' do
   before do
     @session.visit('/with_js')
@@ -13,6 +14,12 @@ Capybara::SpecHelper.spec '#has_current_path?' do
     expect(@session).not_to have_current_path(/monkey/)
   end
 
+  it "should not raise an error when non-http" do
+    @session.reset_session!
+    expect(@session.has_current_path?(/monkey/)).to eq false
+    expect(@session.has_current_path?("/with_js")).to eq false
+  end
+
   it "should handle non-escaped query options" do
     @session.click_link("Non-escaped query options")
     expect(@session).to have_current_path("/with_html?options[]=things")
@@ -37,34 +44,54 @@ Capybara::SpecHelper.spec '#has_current_path?' do
     expect(@session).to have_current_path('/with_js?test=test')
   end
 
-  it "should compare the full url" do
+  it "should compare the full url if url: true is used" do
     expect(@session).to have_current_path(%r{\Ahttp://[^/]*/with_js\Z}, url: true)
+    domain_port = if @session.respond_to?(:server) && @session.server
+      "#{@session.server.host}:#{@session.server.port}"
+    else
+      "www.example.com"
+    end
+    expect(@session).to have_current_path("http://#{domain_port}/with_js", url: true)
+  end
+
+  it "should not compare the full url if url: true is not passed" do
+    expect(@session).to have_current_path(%r{^/with_js\Z})
+    expect(@session).to have_current_path('/with_js')
+  end
+
+  it "should not compare the full url if url: false is passed" do
+    expect(@session).to have_current_path(%r{^/with_js\Z}, url: false)
+    expect(@session).to have_current_path('/with_js', url: false)
+  end
+
+  it "should default to full url if value is a url" do
+    url = @session.current_url
+    expect(url).to match(/with_js$/)
+    expect(@session).to have_current_path(url)
+    expect(@session).not_to have_current_path("http://www.not_example.com/with_js")
   end
 
   it "should ignore the query" do
     @session.visit('/with_js?test=test')
     expect(@session).to have_current_path('/with_js?test=test')
-    expect(@session).to have_current_path('/with_js', only_path: true)
-  end
-
-  it "should not allow url and only_path at the same time" do
-    expect {
-      expect(@session).to have_current_path('/with_js', url: true, only_path: true)
-      }. to raise_error ArgumentError
+    expect(@session).to have_current_path('/with_js', ignore_query: true)
+    uri = ::Addressable::URI.parse(@session.current_url)
+    uri.query = nil
+    expect(@session).to have_current_path(uri.to_s, ignore_query: true)
   end
 
   it "should not raise an exception if the current_url is nil" do
     allow_any_instance_of(Capybara::Session).to receive(:current_url) { nil }
 
-    # Without only_path option
-    expect {
+    # Without ignore_query option
+    expect do
       expect(@session).to have_current_path(nil)
-    }. not_to raise_exception
+    end.not_to raise_exception
 
-    # With only_path option
-    expect {
-      expect(@session).to have_current_path(nil, only_path: true)
-    }. not_to raise_exception
+    # With ignore_query option
+    expect do
+      expect(@session).to have_current_path(nil, ignore_query: true)
+    end.not_to raise_exception
   end
 end
 
@@ -96,14 +123,14 @@ Capybara::SpecHelper.spec '#has_no_current_path?' do
   it "should not raise an exception if the current_url is nil" do
     allow_any_instance_of(Capybara::Session).to receive(:current_url) { nil }
 
-    # Without only_path option
-    expect {
+    # Without ignore_query option
+    expect do
       expect(@session).not_to have_current_path('/with_js')
-    }. not_to raise_exception
+    end. not_to raise_exception
 
-    # With only_path option
-    expect {
-      expect(@session).not_to have_current_path('/with_js', only_path: true)
-    }. not_to raise_exception
+    # With ignore_query option
+    expect do
+      expect(@session).not_to have_current_path('/with_js', ignore_query: true)
+    end. not_to raise_exception
   end
 end

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

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 Capybara::SpecHelper.spec '#has_field' do
   before { @session.visit('/form') }
 
@@ -6,7 +7,7 @@ Capybara::SpecHelper.spec '#has_field' do
     expect(@session).to have_field('Dog')
     expect(@session).to have_field('form_description')
     expect(@session).to have_field('Region')
-    expect(@session).to have_field(:'Region')
+    expect(@session).to have_field(:Region)
   end
 
   it "should be false if the field is not on the page" do
@@ -269,7 +270,7 @@ Capybara::SpecHelper.spec '#has_unchecked_field?' do
 
   it "should support locator-less usage" do
     expect(@session.has_unchecked_field?(disabled: true, id: "form_disabled_unchecked_checkbox"))
-    expect(@session).to have_unchecked_field(disabled: true, id: "form_disabled_unchecked_checkbox" )
+    expect(@session).to have_unchecked_field(disabled: true, id: "form_disabled_unchecked_checkbox")
   end
 end
 
@@ -304,6 +305,6 @@ Capybara::SpecHelper.spec '#has_no_unchecked_field?' do
 
   it "should support locator-less usage" do
     expect(@session.has_no_unchecked_field?(disabled: false, id: "form_disabled_unchecked_checkbox")).to eq true
-    expect(@session).to have_no_unchecked_field(disabled: false, id: "form_disabled_unchecked_checkbox" )
+    expect(@session).to have_no_unchecked_field(disabled: false, id: "form_disabled_unchecked_checkbox")
   end
 end

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

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 Capybara::SpecHelper.spec '#has_link?' do
   before do
     @session.visit('/with_html')
@@ -14,8 +15,8 @@ Capybara::SpecHelper.spec '#has_link?' do
 
   it "should be false if the given link is not on the page" do
     expect(@session).not_to have_link('monkey')
-    expect(@session).not_to have_link('A link', href: '/non-existant-href')
-    expect(@session).not_to have_link('A link', href: /non-existant/)
+    expect(@session).not_to have_link('A link', href: '/nonexistent-href')
+    expect(@session).not_to have_link('A link', href: /nonexistent/)
   end
 end
 
@@ -32,7 +33,7 @@ Capybara::SpecHelper.spec '#has_no_link?' do
 
   it "should be true if the given link is not on the page" do
     expect(@session).to have_no_link('monkey')
-    expect(@session).to have_no_link('A link', href: '/non-existant-href')
-    expect(@session).to have_no_link('A link', href: /\/non-existant-href/)
+    expect(@session).to have_no_link('A link', href: '/nonexistent-href')
+    expect(@session).to have_no_link('A link', href: /\/nonexistent-href/)
   end
 end

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

@@ -0,0 +1,76 @@
+Capybara::SpecHelper.spec '#have_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 do
+      expect(@session).to have_none_of_selectors(:xpath, "//p", "//a")
+    end.to raise_error ::RSpec::Expectations::ExpectationNotMetError
+    expect do
+      expect(@session).to have_none_of_selectors(:css, "p a#foo")
+    end.to raise_error ::RSpec::Expectations::ExpectationNotMetError
+  end
+
+  it "should be true if none of the given locators are on the page" do
+    expect(@session).to have_none_of_selectors(:xpath, "//abbr", "//td")
+    expect(@session).to have_none_of_selectors(:css, "p a#doesnotexist", "abbr")
+  end
+
+  it "should use default selector" do
+    Capybara.default_selector = :css
+    expect(@session).to have_none_of_selectors("p a#doesnotexist", "abbr")
+    expect do
+      expect(@session).to have_none_of_selectors("abbr", "p a#foo")
+    end.to raise_error ::RSpec::Expectations::ExpectationNotMetError
+  end
+
+  context "should respect scopes" do
+    it "when used with `within`" do
+      @session.within "//p[@id='first']" do
+        expect do
+          expect(@session).to have_none_of_selectors(".//a[@id='foo']")
+        end.to raise_error ::RSpec::Expectations::ExpectationNotMetError
+        expect(@session).to have_none_of_selectors(".//a[@id='red']")
+      end
+    end
+
+    it "when called on an element" do
+      el = @session.find "//p[@id='first']"
+      expect do
+        expect(el).to have_none_of_selectors(".//a[@id='foo']")
+      end.to raise_error ::RSpec::Expectations::ExpectationNotMetError
+      expect(el).to have_none_of_selectors(".//a[@id='red']")
+    end
+  end
+
+  context "with options" do
+    it "should apply the options to all locators" do
+      expect do
+        expect(@session).to have_none_of_selectors("//p//a", text: "Redirect")
+      end.to raise_error ::RSpec::Expectations::ExpectationNotMetError
+      expect(@session).to have_none_of_selectors("//p", text: "Doesnotexist")
+    end
+
+    it "should discard all matches where the given regexp is matched" do
+      expect do
+        expect(@session).to have_none_of_selectors("//p//a", text: /re[dab]i/i, count: 1)
+      end.to raise_error ::RSpec::Expectations::ExpectationNotMetError
+      expect(@session).to have_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')
+      expect(@session).to have_none_of_selectors(:css, "#new_field", "a#has-been-clicked", wait: 0.1)
+    end
+  end
+
+  it "cannot be negated" do
+    expect do
+      expect(@session).not_to have_none_of_selectors(:css, "p a#foo", "h2#h2one", "h2#h2two")
+    end.to raise_error ArgumentError
+  end
+end