capybara 2.5.0 → 2.18.0

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 Capybara::SpecHelper.spec '#has_xpath?' do
   before do
     @session.visit('/with_html')
@@ -27,37 +28,39 @@ Capybara::SpecHelper.spec '#has_xpath?' do
     end
   end
 
-  it "should wait for content to appear", :requires => [:js] do
-    @session.visit('/with_js')
-    @session.click_link('Click me')
-    expect(@session).to have_xpath("//input[@type='submit' and @value='New Here']")
+  it "should wait for content to appear", requires: [:js] do
+    Capybara.using_wait_time(3) do
+      @session.visit('/with_js')
+      @session.click_link('Click me') # updates page after 500ms
+      expect(@session).to have_xpath("//input[@type='submit' and @value='New Here']")
+    end
   end
 
   context "with count" do
     it "should be true if the content occurs the given number of times" do
-      expect(@session).to have_xpath("//p", :count => 3)
-      expect(@session).to have_xpath("//p//a[@id='foo']", :count => 1)
-      expect(@session).to have_xpath("//p[contains(.,'est')]", :count => 1)
-      expect(@session).to have_xpath("//p//a[@id='doesnotexist']", :count => 0)
+      expect(@session).to have_xpath("//p", count: 3)
+      expect(@session).to have_xpath("//p//a[@id='foo']", count: 1)
+      expect(@session).to have_xpath("//p[contains(.,'est')]", count: 1)
+      expect(@session).to have_xpath("//p//a[@id='doesnotexist']", count: 0)
     end
 
     it "should be false if the content occurs a different number of times than the given" do
-      expect(@session).not_to have_xpath("//p", :count => 6)
-      expect(@session).not_to have_xpath("//p//a[@id='foo']", :count => 2)
-      expect(@session).not_to have_xpath("//p[contains(.,'est')]", :count => 5)
-      expect(@session).not_to have_xpath("//p//a[@id='doesnotexist']", :count => 1)
+      expect(@session).not_to have_xpath("//p", count: 6)
+      expect(@session).not_to have_xpath("//p//a[@id='foo']", count: 2)
+      expect(@session).not_to have_xpath("//p[contains(.,'est')]", count: 5)
+      expect(@session).not_to have_xpath("//p//a[@id='doesnotexist']", count: 1)
     end
   end
 
   context "with text" do
     it "should discard all matches where the given string is not contained" do
-      expect(@session).to have_xpath("//p//a", :text => "Redirect", :count => 1)
-      expect(@session).not_to have_xpath("//p", :text => "Doesnotexist")
+      expect(@session).to have_xpath("//p//a", text: "Redirect", count: 1)
+      expect(@session).not_to have_xpath("//p", text: "Doesnotexist")
     end
 
     it "should discard all matches where the given regexp is not matched" do
-      expect(@session).to have_xpath("//p//a", :text => /re[dab]i/i, :count => 1)
-      expect(@session).not_to have_xpath("//p//a", :text => /Red$/)
+      expect(@session).to have_xpath("//p//a", text: /re[dab]i/i, count: 1)
+      expect(@session).not_to have_xpath("//p//a", text: /Red$/)
     end
   end
 end
@@ -91,7 +94,7 @@ Capybara::SpecHelper.spec '#has_no_xpath?' do
     end
   end
 
-  it "should wait for content to disappear", :requires => [:js] do
+  it "should wait for content to disappear", requires: [:js] do
     @session.visit('/with_js')
     @session.click_link('Click me')
     expect(@session).to have_no_xpath("//p[@id='change']")
@@ -99,29 +102,29 @@ Capybara::SpecHelper.spec '#has_no_xpath?' do
 
   context "with count" do
     it "should be false if the content occurs the given number of times" do
-      expect(@session).not_to have_no_xpath("//p", :count => 3)
-      expect(@session).not_to have_no_xpath("//p//a[@id='foo']", :count => 1)
-      expect(@session).not_to have_no_xpath("//p[contains(.,'est')]", :count => 1)
-      expect(@session).not_to have_no_xpath("//p//a[@id='doesnotexist']", :count => 0)
+      expect(@session).not_to have_no_xpath("//p", count: 3)
+      expect(@session).not_to have_no_xpath("//p//a[@id='foo']", count: 1)
+      expect(@session).not_to have_no_xpath("//p[contains(.,'est')]", count: 1)
+      expect(@session).not_to have_no_xpath("//p//a[@id='doesnotexist']", count: 0)
     end
 
     it "should be true if the content occurs a different number of times than the given" do
-      expect(@session).to have_no_xpath("//p", :count => 6)
-      expect(@session).to have_no_xpath("//p//a[@id='foo']", :count => 2)
-      expect(@session).to have_no_xpath("//p[contains(.,'est')]", :count => 5)
-      expect(@session).to have_no_xpath("//p//a[@id='doesnotexist']", :count => 1)
+      expect(@session).to have_no_xpath("//p", count: 6)
+      expect(@session).to have_no_xpath("//p//a[@id='foo']", count: 2)
+      expect(@session).to have_no_xpath("//p[contains(.,'est')]", count: 5)
+      expect(@session).to have_no_xpath("//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).not_to have_no_xpath("//p//a", :text => "Redirect", :count => 1)
-      expect(@session).to have_no_xpath("//p", :text => "Doesnotexist")
+      expect(@session).not_to have_no_xpath("//p//a", text: "Redirect", count: 1)
+      expect(@session).to have_no_xpath("//p", text: "Doesnotexist")
     end
 
     it "should discard all matches where the given regexp is matched" do
-      expect(@session).not_to have_no_xpath("//p//a", :text => /re[dab]i/i, :count => 1)
-      expect(@session).to have_no_xpath("//p//a", :text => /Red$/)
+      expect(@session).not_to have_no_xpath("//p//a", text: /re[dab]i/i, count: 1)
+      expect(@session).to have_no_xpath("//p//a", text: /Red$/)
     end
   end
 end

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

@@ -1,5 +1,6 @@
+# frozen_string_literal: true
 Capybara::SpecHelper.spec '#response_headers' do
-  it "should return response headers", :requires => [:response_headers] do
+  it "should return response headers", requires: [:response_headers] do
     @session.visit('/with_simple_html')
     expect(@session.response_headers['Content-Type']).to match %r(text/html)
   end

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

@@ -1,10 +1,11 @@
+# frozen_string_literal: true
 Capybara::SpecHelper.spec '#html' do
   it "should return the unmodified page body" do
     @session.visit('/')
     expect(@session.html).to include('Hello world!')
   end
 
-  it "should return the current state of the page", :requires => [:js] do
+  it "should return the current state of the page", requires: [:js] do
     @session.visit('/with_js')
     expect(@session.html).to include('I changed it')
     expect(@session.html).not_to include('This is text')
@@ -17,7 +18,7 @@ Capybara::SpecHelper.spec '#source' do
     expect(@session.source).to include('Hello world!')
   end
 
-  it "should return the current state of the page", :requires => [:js] do
+  it "should return the current state of the page", requires: [:js] do
     @session.visit('/with_js')
     expect(@session.source).to include('I changed it')
     expect(@session.source).not_to include('This is text')
@@ -30,7 +31,7 @@ Capybara::SpecHelper.spec '#body' do
     expect(@session.body).to include('Hello world!')
   end
 
-  it "should return the current state of the page", :requires => [:js] do
+  it "should return the current state of the page", requires: [:js] do
     @session.visit('/with_js')
     expect(@session.body).to include('I changed it')
     expect(@session.body).not_to include('This is text')

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 Capybara::SpecHelper.spec "node" do
   before do
     @session.visit('/with_html')
@@ -8,7 +10,7 @@ Capybara::SpecHelper.spec "node" do
     @form = @session.find(:css, '#get-form')
     expect(@form).to have_field('Middle Name')
     expect(@form).to have_no_field('Languages')
-    @form.fill_in('Middle Name', :with => 'Monkey')
+    @form.fill_in('Middle Name', with: 'Monkey')
     @form.click_button('med')
     expect(extract_results(@session)['middle_name']).to eq('Monkey')
   end
@@ -17,11 +19,19 @@ Capybara::SpecHelper.spec "node" do
     expect(@session.find(:css, '#second')).to have_no_css('h1')
   end
 
+  describe "#query_scope" do
+    it "should have a reference to the element the query was evaluated on if there is one" do
+      @node = @session.find(:css, '#first')
+      expect(@node.query_scope).to eq(@node.session.document)
+      expect(@node.find(:css, '#foo').query_scope).to eq(@node)
+    end
+  end
+
   describe "#parent" do
-    it "should have a reference to its parent if there is one" do
+    it "should be deprecated" do
       @node = @session.find(:css, '#first')
-      expect(@node.parent).to eq(@node.session.document)
-      expect(@node.find(:css, '#foo').parent).to eq(@node)
+      expect(@node).to receive(:warn).with(/^DEPRECATED:/)
+      expect(@node.parent).to eq(@node.query_scope)
     end
   end
 
@@ -86,7 +96,7 @@ Capybara::SpecHelper.spec "node" do
       expect(@session.first('//input').value).to eq('gorilla')
     end
 
-    it "should fill the field even if the caret was not at the end", :requires => [:js] do
+    it "should fill the field even if the caret was not at the end", requires: [:js] do
       @session.execute_script("var el = document.getElementById('test_field'); el.focus(); el.setSelectionRange(0, 0);")
       @session.first('//input').set('')
       expect(@session.first('//input').value).to eq('')
@@ -112,23 +122,25 @@ Capybara::SpecHelper.spec "node" do
       expect(@session.first('//textarea[@readonly]').set('changed')).to raise_error(Capybara::ReadOnlyElementError)
     end if Capybara::VERSION.to_f > 3.0
 
-    it 'should allow me to change the contents of a contenteditable element', :requires => [:js] do
-      @session.visit('/with_js')
-      @session.find(:css,'#existing_content_editable').set('WYSIWYG')
-      expect(@session.find(:css,'#existing_content_editable').text).to eq('WYSIWYG')
-    end
+    context "with a contenteditable element", requires: [:js] do
+      it 'should allow me to change the contents' do
+        @session.visit('/with_js')
+        @session.find(:css,'#existing_content_editable').set('WYSIWYG')
+        expect(@session.find(:css,'#existing_content_editable').text).to eq('WYSIWYG')
+      end
 
-    it 'should allow me to set the contents of a contenteditable element', :requires => [:js] do
-      @session.visit('/with_js')
-      @session.find(:css,'#blank_content_editable').set('WYSIWYG')
-      expect(@session.find(:css,'#blank_content_editable').text).to eq('WYSIWYG')
-    end
+      it 'should allow me to set the contents' do
+        @session.visit('/with_js')
+        @session.find(:css,'#blank_content_editable').set('WYSIWYG')
+        expect(@session.find(:css,'#blank_content_editable').text).to eq('WYSIWYG')
+      end
 
-    it 'should allow me to change the contents of a contenteditable elements child', :requires => [:js] do
-      pending "Selenium doesn't like editing nested contents"
-      @session.visit('/with_js')
-      @session.find(:css,'#existing_content_editable_child').set('WYSIWYG')
-      expect(@session.find(:css,'#existing_content_editable_child').text).to eq('WYSIWYG')
+      it 'should allow me to change the contents of a child element' do
+        @session.visit('/with_js')
+        @session.find(:css,'#existing_content_editable_child').set('WYSIWYG')
+        expect(@session.find(:css,'#existing_content_editable_child').text).to eq('WYSIWYG')
+        expect(@session.find(:css,'#existing_content_editable_child_parent').text).to eq('Some content WYSIWYG')
+      end
     end
   end
 
@@ -156,8 +168,41 @@ Capybara::SpecHelper.spec "node" do
     it "should see enabled options in disabled select as disabled" do
       @session.visit('/form')
       expect(@session.find('//select[@id="form_disabled_select"]/option')).to be_disabled
+      expect(@session.find('//select[@id="form_disabled_select"]/optgroup/option')).to be_disabled
       expect(@session.find('//select[@id="form_title"]/option[1]')).not_to be_disabled
     end
+
+    it "should see enabled options in disabled optgroup as disabled" do
+      @session.visit('/form')
+      expect(@session.find('//option', text: "A.B.1")).to be_disabled
+      expect(@session.find('//option', text: "A.2")).not_to be_disabled
+    end
+
+    context "in a disabled fieldset" do
+      # https://html.spec.whatwg.org/#the-fieldset-element
+      it "should see elements not in first legend as disabled" do
+        @session.visit('/form')
+        expect(@session.find('//input[@id="form_disabled_fieldset_child"]')).to be_disabled
+        expect(@session.find('//input[@id="form_disabled_fieldset_second_legend_child"]')).to be_disabled
+        expect(@session.find('//input[@id="form_enabled_fieldset_child"]')).not_to be_disabled
+      end
+
+      it "should see elements in first legend as enabled" do
+        @session.visit('/form')
+        expect(@session.find('//input[@id="form_disabled_fieldset_legend_child"]')).not_to be_disabled
+      end
+
+      it "should sees options not in first legend as disabled" do
+        @session.visit('/form')
+        expect(@session.find('//option', text: 'Disabled Child Option')).to be_disabled
+      end
+    end
+    it "should be boolean" do
+      @session.visit('/form')
+      expect(@session.find('//select[@id="form_disabled_select"]/option').disabled?).to be true
+      expect(@session.find('//select[@id="form_disabled_select2"]/option').disabled?).to be true
+      expect(@session.find('//select[@id="form_title"]/option[1]').disabled?).to be false
+    end
   end
 
   describe "#visible?" do
@@ -169,6 +214,13 @@ Capybara::SpecHelper.spec "node" do
       expect(@session.find('//div[@id="hidden_via_ancestor"]')).not_to be_visible
       expect(@session.find('//div[@id="hidden_attr"]')).not_to be_visible
       expect(@session.find('//a[@id="hidden_attr_via_ancestor"]')).not_to be_visible
+      expect(@session.find('//input[@id="hidden_input"]')).not_to be_visible
+    end
+
+    it "should be boolean" do
+      Capybara.ignore_hidden_elements = false
+      expect(@session.first('//a').visible?).to be true
+      expect(@session.find('//div[@id="hidden"]').visible?).to be false
     end
   end
 
@@ -179,6 +231,13 @@ Capybara::SpecHelper.spec "node" do
       expect(@session.find('//input[@id="gender_male"]')).not_to be_checked
       expect(@session.first('//h1')).not_to be_checked
     end
+
+    it "should be boolean" do
+      @session.visit('/form')
+      expect(@session.find('//input[@id="gender_female"]').checked?).to be true
+      expect(@session.find('//input[@id="gender_male"]').checked?).to be false
+      expect(@session.find('//input[@id="no_attr_value_checked"]').checked?).to be true
+    end
   end
 
   describe "#selected?" do
@@ -188,6 +247,13 @@ Capybara::SpecHelper.spec "node" do
       expect(@session.find('//option[@value="sv"]')).not_to be_selected
       expect(@session.first('//h1')).not_to be_selected
     end
+
+    it "should be boolean" do
+      @session.visit('/form')
+      expect(@session.find('//option[@value="en"]').selected?).to be true
+      expect(@session.find('//option[@value="sv"]').selected?).to be false
+      expect(@session.first('//h1').selected?).to be false
+    end
   end
 
   describe "#==" do
@@ -215,7 +281,7 @@ Capybara::SpecHelper.spec "node" do
     end
   end
 
-  describe "#trigger", :requires => [:js, :trigger] do
+  describe "#trigger", requires: [:js, :trigger] do
     it "should allow triggering of custom JS events" do
       @session.visit('/with_js')
       @session.find(:css, '#with_focus_event').trigger(:focus)
@@ -223,7 +289,7 @@ Capybara::SpecHelper.spec "node" do
     end
   end
 
-  describe '#drag_to', :requires => [:js, :drag] do
+  describe '#drag_to', requires: [:js, :drag] do
     it "should drag and drop an object" do
       @session.visit('/with_js')
       element = @session.find('//div[@id="drag"]')
@@ -231,14 +297,29 @@ Capybara::SpecHelper.spec "node" do
       element.drag_to(target)
       expect(@session.find('//div[contains(., "Dropped!")]')).not_to be_nil
     end
+
+    it "should drag and drop if scrolling is needed" do
+      @session.visit('/with_js')
+      element = @session.find('//div[@id="drag_scroll"]')
+      target = @session.find('//div[@id="drop_scroll"]')
+      element.drag_to(target)
+      expect(@session.find('//div[contains(., "Dropped!")]')).not_to be_nil
+    end
   end
 
-  describe '#hover', :requires => [:hover] do
+  describe '#hover', requires: [:hover] do
     it "should allow hovering on an element" do
       @session.visit('/with_hover')
-      expect(@session.find(:css,'.hidden_until_hover', :visible => false)).not_to be_visible
-      @session.find(:css,'.wrapper').hover
-      expect(@session.find(:css, '.hidden_until_hover', :visible => false)).to be_visible
+      expect(@session.find(:css, '.wrapper:not(.scroll_needed) .hidden_until_hover', visible: false)).not_to be_visible
+      @session.find(:css,'.wrapper:not(.scroll_needed)').hover
+      expect(@session.find(:css, '.wrapper:not(.scroll_needed) .hidden_until_hover', visible: false)).to be_visible
+    end
+
+    it "should allow hovering on an element that needs to be scrolled into view" do
+      @session.visit('/with_hover')
+      expect(@session.find(:css, '.wrapper.scroll_needed .hidden_until_hover', visible: false)).not_to be_visible
+      @session.find(:css,'.wrapper.scroll_needed').hover
+      expect(@session.find(:css, '.wrapper.scroll_needed .hidden_until_hover', visible: false)).to be_visible
     end
   end
 
@@ -247,17 +328,48 @@ Capybara::SpecHelper.spec "node" do
       @session.find(:css, '#link_placeholder').click
       expect(@session.current_url).to match(%r{/with_html$})
     end
+
+    it "should go to the same page if href is blank" do
+      @session.find(:css, '#link_blank_href').click
+      sleep 1
+      expect(@session).to have_current_path('/with_html')
+    end
+
+    it "should be able to check a checkbox" do
+      @session.visit('form')
+      cbox = @session.find(:checkbox, 'form_terms_of_use')
+      expect(cbox).not_to be_checked
+      cbox.click
+      expect(cbox).to be_checked
+    end
+
+    it "should be able to uncheck a checkbox" do
+      @session.visit('/form')
+      cbox = @session.find(:checkbox, 'form_pets_dog')
+      expect(cbox).to be_checked
+      cbox.click
+      expect(cbox).not_to be_checked
+    end
+
+    it "should be able to select a radio button" do
+      @session.visit('/form')
+      radio = @session.find(:radio_button, 'gender_male')
+      expect(radio).not_to be_checked
+      radio.click
+      expect(radio).to be_checked
+    end
   end
 
-  describe '#double_click', :requires => [:js] do
+  describe '#double_click', requires: [:js] do
     it "should double click an element" do
+      pending "selenium-webdriver/geckodriver doesn't generate double click event" if marionette?(@session)
       @session.visit('/with_js')
       @session.find(:css, '#click-test').double_click
       expect(@session.find(:css, '#has-been-double-clicked')).to be
     end
   end
 
-  describe '#right_click', :requires => [:js] do
+  describe '#right_click', requires: [:js] do
     it "should right click an element" do
       @session.visit('/with_js')
       @session.find(:css, '#click-test').right_click
@@ -273,25 +385,28 @@ Capybara::SpecHelper.spec "node" do
     end
 
     it "should send special characters" do
+      pending "selenium-webdriver/geckodriver doesn't support complex sets of characters" if marionette?(@session)
       @session.visit('/form')
       @session.find(:css, '#address1_city').send_keys('Ocean', :space, 'sie', :left, 'd')
       expect(@session.find(:css, '#address1_city').value).to eq 'Ocean side'
     end
 
     it "should allow for multiple simultaneous keys" do
+      pending "selenium-webdriver/geckodriver doesn't support complex sets of characters" if marionette?(@session)
       @session.visit('/form')
       @session.find(:css, '#address1_city').send_keys([:shift, 'o'], 'ceanside')
       expect(@session.find(:css, '#address1_city').value).to eq 'Oceanside'
     end
 
     it "should generate key events", requires: [:send_keys, :js] do
+      pending "selenium-webdriver/geckodriver doesn't support complex sets of characters" if marionette?(@session)
       @session.visit('/with_js')
       @session.find(:css, '#with-key-events').send_keys([:shift,'t'], [:shift,'w'])
       expect(@session.find(:css, '#key-events-output')).to have_text('keydown:16 keydown:84 keydown:16 keydown:87')
     end
   end
 
-  describe '#reload', :requires => [:js] do
+  describe '#reload', requires: [:js] do
     context "without automatic reload" do
       before { Capybara.automatic_reload = false }
       it "should reload the current context of the node" do
@@ -317,17 +432,25 @@ Capybara::SpecHelper.spec "node" do
         node = @session.find(:css, '#reload-me')
         @session.click_link('Reload!')
         sleep(0.3)
-        expect { node.text.to == 'has been reloaded' }.to raise_error
+        expect do
+          expect(node).to have_text('has been reloaded')
+        end.to raise_error do |error|
+          expect(error).to be_an_invalid_element_error(@session)
+        end
       end
       after { Capybara.automatic_reload = true }
     end
 
     context "with automatic reload" do
+      before do
+        Capybara.default_max_wait_time = 4
+      end
+
       it "should reload the current context of the node automatically" do
         @session.visit('/with_js')
         node = @session.find(:css, '#reload-me')
         @session.click_link('Reload!')
-        sleep(0.3)
+        sleep(1)
         expect(node.text).to eq('has been reloaded')
       end
 
@@ -335,7 +458,7 @@ Capybara::SpecHelper.spec "node" do
         @session.visit('/with_js')
         node = @session.find(:css, '#reload-me').find(:css, 'em')
         @session.click_link('Reload!')
-        sleep(0.3)
+        sleep(1)
         expect(node.text).to eq('has been reloaded')
       end
 
@@ -343,26 +466,63 @@ Capybara::SpecHelper.spec "node" do
         @session.visit('/with_js')
         node = @session.find(:css, '#reload-me')
         @session.click_link('Reload!')
-        sleep(0.3)
+        sleep(1)
         expect(node.find(:css, 'a').text).to eq('has been reloaded')
       end
 
-      it "should not reload nodes which haven't been found" do
+      it "should not reload nodes which haven't been found with reevaluateable queries" do
         @session.visit('/with_js')
         node = @session.all(:css, '#the-list li')[1]
         @session.click_link('Fetch new list!')
-        sleep(0.3)
-        expect { node.text.to == 'Foo' }.to raise_error
-        expect { node.text.to == 'Bar' }.to raise_error
+        sleep(1)
+
+        expect do
+          expect(node).to have_text('Foo')
+        end.to raise_error { |error|
+          expect(error).to be_an_invalid_element_error(@session)
+        }
+        expect do
+          expect(node).to have_text('Bar')
+        end.to raise_error { |error|
+          expect(error).to be_an_invalid_element_error(@session)
+        }
       end
 
       it "should reload nodes with options" do
         @session.visit('/with_js')
-        node = @session.find(:css, 'em', :text => "reloaded")
+        node = @session.find(:css, 'em', text: "reloaded")
         @session.click_link('Reload!')
         sleep(1)
         expect(node.text).to eq('has been reloaded')
       end
     end
   end
+
+  context "when #synchronize raises server errors" do
+    it "sets an explanatory exception as the cause of server exceptions", requires: [:server, :js] do
+      skip "This version of ruby doesn't support exception causes" unless Exception.instance_methods.include? :cause
+      quietly { @session.visit("/error") }
+      expect do
+        @session.find(:css, 'span')
+      end.to raise_error(TestApp::TestAppError) do |e|
+        expect(e.cause).to be_a Capybara::CapybaraError
+        expect(e.cause.message).to match(/Your application server raised an error/)
+      end
+    end
+
+    it "sets an explanatory exception as the cause of server exceptions with errors with initializers", requires: [:server, :js] do
+      skip "This version of ruby doesn't support exception causes" unless Exception.instance_methods.include? :cause
+      quietly { @session.visit("/other_error") }
+      expect do
+        @session.find(:css, 'span')
+      end.to raise_error(TestApp::TestAppOtherError) do |e|
+        expect(e.cause).to be_a Capybara::CapybaraError
+        expect(e.cause.message).to match(/Your application server raised an error/)
+      end
+    end
+  end
+
+  def be_an_invalid_element_error(session)
+    satisfy { |error| session.driver.invalid_element_errors.any? { |e| error.is_a? e } }
+  end
 end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+Capybara::SpecHelper.spec '#refresh' do
+  it "reload the page" do
+    @session.visit('/form')
+    expect(@session).to have_select('form_locale', selected: 'English')
+    @session.select('Swedish', from: 'form_locale')
+    expect(@session).to have_select('form_locale', selected: 'Swedish')
+    @session.refresh
+    expect(@session).to have_select('form_locale', selected: 'English')
+  end
+
+  it "raises any errors caught inside the server", requires: [:server] do
+    quietly { @session.visit("/error") }
+    expect do
+      @session.refresh
+    end.to raise_error(TestApp::TestAppError)
+  end
+
+  it "it reposts" do
+    @session.visit('/form')
+    @session.select('Sweden', from: 'form_region')
+    @session.click_button('awesome')
+    expect {
+      @session.refresh
+      sleep 2
+    }.to change{ extract_results(@session)['post_count'] }.by(1)
+  end
+end