capybara 3.39.2 → 3.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0945d8fedaab75fa31a90d12105de7318d78c20a46955a1b78ae88dc791f6a5a'
-  data.tar.gz: 9a59ca68ff9d44ef28597603ed275ebef28c79c8b6fb76ffdc26daaee68ab383
+  metadata.gz: e0537a83e6809595a8e15b9c450f4f4b0976c5ebf1327cc0611ae20a05b3574b
+  data.tar.gz: c3035e7a05874cc93ab27c6aea26e529dea4c3b63bd5d3281deaaf34c45a91b0
 SHA512:
-  metadata.gz: dbb58a338e2408140ce5e6a44bc141fc44833952c10f611996f5a217c9a0ad00f8d6344a1c16b0bf53000801f9e1d45ef3848cb0fa886dabe68c6d766a42372a
-  data.tar.gz: db985c0c947ff348c80008fd4c90232a0ad4dcd38dbe8694b157ecfb512c099d6e9bc08177d8a115e1db17cca35c68903e10662da0fdd14c4f1a2ab671932b16
+  metadata.gz: 48c7bc5cbfc8e3324ea09d937a207299ad91ffc2e255dbbb7ed13265e4541c3672271ccb2f19b3902588d5c649cb6f561b7c483e7b815b824ccf37df8bbb5075
+  data.tar.gz: 5b3a9cc9a6ba6ed67a54ef381c00ed9cc94027d26bdfc98ba1c509a097c9dc123d39bd72a6a5728e5b5b4e503202e475889d22cf47c07ce88eb7afedf604ed83

data/History.md

@@ -1,3 +1,25 @@
+#Version 3.40.0
+Release date: 2024-01-26
+
+### Changned
+
+* Dropped support for Ruby 2.7, 3.0+ is now required
+* Dropped support for Selenium < 4.8
+* Use the new headless option on chromedriver with registered selenium driver [Neil Carvalho]
+
+### Added
+
+* `Capybara::Result#to_ary` to support multiple assignment [Sean Doyle]
+* `has_element?` and related matchers [Sean Doyle]
+*  Rack 3 support
+
+### Fixed
+
+* Forward save_screenshot options to selenium - Issue 2738
+* Rack test - don't auto submit forms with multiple inputs [Mitchell Henke]
+* Table row selector matches cell values in order - Issue 2686 [Jeff Parr]
+* Table row selector fixes for first column - Issue 2685 [Jeff Par]
+
 # Version 3.39.2
 Release date: 2023-06-10
 

data/README.md

@@ -1,11 +1,8 @@
 # Capybara
 
-[![Build Status](https://secure.travis-ci.org/teamcapybara/capybara.svg)](https://travis-ci.org/teamcapybara/capybara)
-[![Build Status](https://ci.appveyor.com/api/projects/status/github/teamcapybara/capybara?svg=true)](https://ci.appveyor.com/api/projects/github/teamcapybara/capybara)
+[![Build Status](https://github.com/teamcapybara/capybara/actions/workflows/build.yml/badge.svg)](https://github.com/teamcapybara/capybara/actions/workflows/build.yml)
 [![Code Climate](https://codeclimate.com/github/teamcapybara/capybara.svg)](https://codeclimate.com/github/teamcapybara/capybara)
 [![Coverage Status](https://coveralls.io/repos/github/teamcapybara/capybara/badge.svg?branch=master)](https://coveralls.io/github/teamcapybara/capybara?branch=master)
-[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/jnicklas/capybara?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
-[![SemVer](https://api.dependabot.com/badges/compatibility_score?dependency-name=capybara&package-manager=bundler&version-scheme=semver)](https://dependabot.com/compatibility-score.html?dependency-name=capybara&package-manager=bundler&version-scheme=semver)
 
 Capybara helps you test web applications by simulating how a real user would
 interact with your app. It is agnostic about the driver running your tests and
@@ -18,8 +15,7 @@ If you and/or your company find value in Capybara and would like to contribute f
 <a href="https://www.patreon.com/capybara">Patreon</a>
 
 
-**Need help?** Ask on the mailing list (please do not open an issue on
-GitHub): http://groups.google.com/group/ruby-capybara
+**Need help?** Ask on the discussions (please do not open an issue): https://github.com/orgs/teamcapybara/discussions/categories/q-a
 
 ## Table of contents
 
@@ -34,7 +30,6 @@ GitHub): http://groups.google.com/group/ruby-capybara
     - [Selecting the Driver](#selecting-the-driver)
     - [RackTest](#racktest)
     - [Selenium](#selenium)
-    - [Apparition](#apparition)
 - [The DSL](#the-dsl)
     - [Navigating](#navigating)
     - [Clicking links and buttons](#clicking-links-and-buttons)
@@ -46,6 +41,10 @@ GitHub): http://groups.google.com/group/ruby-capybara
     - [Scripting](#scripting)
     - [Modals](#modals)
     - [Debugging](#debugging)
+- [Selectors](#selectors)
+    - [Name](#selectors-name)
+    - [Locator](#selectors-locator)
+    - [Filters](#selectors-filters)
 - [Matching](#matching)
     - [Exactness](#exactness)
     - [Strategy](#strategy)
@@ -74,7 +73,7 @@ GitHub): http://groups.google.com/group/ruby-capybara
 
 ## <a name="setup"></a>Setup
 
-Capybara requires Ruby 2.7.0 or later. To install, add this line to your
+Capybara requires Ruby 3.0.0 or later. To install, add this line to your
 `Gemfile` and run `bundle install`:
 
 ```ruby
@@ -145,13 +144,13 @@ Load RSpec 3.5+ support by adding the following line (typically to your
 require 'capybara/rspec'
 ```
 
-If you are using Rails, put your Capybara specs in `spec/features` or `spec/system` (only works
-if [you have it configured in
-RSpec](https://relishapp.com/rspec/rspec-rails/v/4-0/docs/directory-structure))
-and if you have your Capybara specs in a different directory, then tag the
-example groups with `type: :feature` or `type: :system` depending on which type of test you're writing.
+If you are using Rails, put your Capybara specs in `spec/features` or `spec/system` (only works if
+[you have it configured in RSpec](https://rspec.info/features/6-0/rspec-rails/directory-structure/))
+and if you have your Capybara specs in a different directory, then tag the example groups with
+`type: :feature` or `type: :system` depending on which type of test you're writing.
 
-If you are using Rails system specs please see [their documentation](https://relishapp.com/rspec/rspec-rails/docs/system-specs/system-spec#system-specs-driven-by-selenium-chrome-headless) for selecting the driver you wish to use.
+If you are using Rails system specs please see [their documentation](https://rspec.info/features/6-0/rspec-rails/system-specs/system-specs)
+for selecting the driver you wish to use.
 
 If you are not using Rails, tag all the example groups in which you want to use
 Capybara with `type: :feature`.
@@ -183,7 +182,7 @@ to one specific driver. For example:
 ```ruby
 describe 'some stuff which requires js', js: true do
   it 'will use the default js driver'
-  it 'will switch to one specific driver', driver: :apparition
+  it 'will switch to one specific driver', driver: :selenium
 end
 ```
 
@@ -353,7 +352,7 @@ You can also change the driver temporarily (typically in the Before/setup and
 After/teardown blocks):
 
 ```ruby
-Capybara.current_driver = :apparition # temporarily select different driver
+Capybara.current_driver = :selenium # temporarily select different driver
 # tests here
 Capybara.use_default_driver       # switch back to default driver
 ```
@@ -409,15 +408,6 @@ to the browsers.  See the section on adding and configuring drivers.
 same transaction as your tests, causing data not to be shared between your test
 and test server, see [Transactions and database setup](#transactions-and-database-setup) below.
 
-### <a name="apparition"></a>Apparition
-
-The [apparition driver](https://github.com/twalpole/apparition) is a new driver that allows you to run tests using Chrome in a headless
-or headed configuration. It attempts to provide backwards compatibility with the [Poltergeist driver API](https://github.com/teampoltergeist/poltergeist)
-and [capybara-webkit API](https://github.com/thoughtbot/capybara-webkit) while allowing for the use of modern JS/CSS. It
-uses CDP to communicate with Chrome, thereby obviating the need for chromedriver. This driver is being developed by the
-current developer of Capybara and will attempt to keep up to date with new Capybara releases. It will probably be moved into the
-teamcapybara repo once it reaches v1.0.
-
 ## <a name="the-dsl"></a>The DSL
 
 *A complete reference is available at
@@ -632,10 +622,10 @@ JS
 
 In drivers which support it, you can accept, dismiss and respond to alerts, confirms, and prompts.
 
-You can accept or dismiss alert messages by wrapping the code that produces an alert in a block:
+You can accept alert messages by wrapping the code that produces an alert in a block:
 
 ```ruby
-accept_alert do
+accept_alert 'optional text or regex' do
   click_link('Show Alert')
 end
 ```
@@ -643,7 +633,13 @@ end
 You can accept or dismiss a confirmation by wrapping it in a block, as well:
 
 ```ruby
-dismiss_confirm do
+accept_confirm 'optional text' do
+  click_link('Show Confirm')
+end
+```
+
+```ruby
+dismiss_confirm 'optional text' do
   click_link('Show Confirm')
 end
 ```
@@ -651,7 +647,13 @@ end
 You can accept or dismiss prompts as well, and also provide text to fill in for the response:
 
 ```ruby
-accept_prompt(with: 'Linus Torvalds') do
+accept_prompt('optional text', with: 'Linus Torvalds') do
+  click_link('Show Prompt About Linux')
+end
+```
+
+```ruby
+dismiss_prompt('optional text') do
   click_link('Show Prompt About Linux')
 end
 ```
@@ -701,6 +703,148 @@ Screenshots are saved to `Capybara.save_path`, relative to the app directory.
 If you have required `capybara/rails`, `Capybara.save_path` will default to
 `tmp/capybara`.
 
+## <a name="selectors"></a>Selectors
+
+Helpers and matchers that accept Selectors share a common method signature that
+includes:
+
+1. a positional Name argument
+2. a positional Locator argument
+3. keyword Filter arguments
+4. a predicate Filter block argument
+
+These arguments are usually optional in one way or another.
+
+### <a name="selectors-name"></a>Name
+
+The name argument determines the Selector to use. The argument is optional when
+a helper explicitly conveys the selector name (for example, [`find_field`][]
+uses `:field`, [`find_link`][] uses `:link`, etc):
+
+```ruby
+page.html # => '<a href="/">Home</a>'
+
+page.find(:link) == page.find_link
+
+page.html # => '<input>'
+
+page.find(:field) == page.find_field
+```
+
+### <a name="selectors-locator"></a>Locator
+
+The locator argument usually represents information that can most meaningfully
+distinguish an element that matches the selector from an element that does not:
+
+```ruby
+page.html # => '<div id="greeting">Hello world</div>'
+
+page.find(:css, 'div').text     # => 'Hello world'
+page.find(:xpath, './/div').text # => 'Hello world'
+```
+
+General purpose finder methods like [`find`][] and [`all`][] can accept the
+locator as their first positional argument when the method can infer the default
+value from the [`Capybara.default_selector`][] configuration:
+
+```ruby
+page.html # => '<div id="greeting">Hello world</div>'
+
+Capybara.default_selector = :css
+
+page.find('div').text     # => 'Hello world'
+
+Capybara.default_selector = :xpath
+
+page.find('.//div').text # => 'Hello world'
+```
+
+The locator argument's semantics are context-specific, and depend on the
+selector. The types of arguments are varied. Some selectors support `String` or
+`Regexp` arguments, while others like `:table_row` support `Array<String>` and
+`Hash<String, String>`:
+
+```ruby
+page.html # => '<label for="greeting">Greeting</label>
+                <input id="greeting" name="content">'
+
+# find by the <input> element's [id] attribute
+page.find(:id, 'greeting') == page.find_by_id('greeting') # => true
+
+# find by the <input> element's [id] attribute
+page.find(:field, 'greeting') == page.find_field('greeting') # => true
+
+# find by the <input> element's [name] attribute
+page.find(:field, 'content') == page.find_field('content') # => true
+
+# find by the <label> element's text
+page.find(:field, 'Greeting') == page.find_field('Greeting') # => true
+
+page.html # => '<table>
+                  <tr>
+                    <th>A</th>
+                    <th>B</th>
+                  </tr>
+                  <tr>
+                    <td>1</td>
+                    <td>2</td>
+                  </tr>
+                </table>'
+
+# find by <td> content
+page.find(:table_row, ['1', '2']) == page.find(:css, 'tr:last-of-type') # => true
+
+# find by <th> content paired with corresponding <td> content
+page.find(:table_row, 'A' => '1') == page.find(:table_row, 'B' => '2') # => true
+```
+
+### <a name="selectors-filters"></a> Filters
+
+All filters are optional. The supported set of keys is a mixture of both global
+and context-specific filters.The supported types of values depend on the
+context:
+
+```ruby
+page.html # => '<a href="/">Home</a>'
+
+# find by the [href] attribute
+page.find_link(href: '/') == page.find_link(text: 'Home') # => true
+
+page.html # => '<div id="element" data-attribute="value">Content</div>'
+
+# find by the [id] attribute
+page.find(id: 'element') == page.find(text: 'Content') # => true
+
+# find by the [data-attribute] attribute
+page.find(:element, 'data-attribute': /value/) == page.find(text: 'Content') # => true
+
+page.html # => '<input type="checkbox">'
+
+# find by the absence of the [checked] attribute
+page.find_field(checked: false) == page.find_field(unchecked: true) # => true
+```
+
+The predicate block is always optional. When there are results for a selector
+query, the block is called with each item in the result set. When the block
+evaluates to true, the item is included from the result set. Otherwise, the item
+is excluded:
+
+```ruby
+page.html # => '<input role="switch" type="checkbox" checked>'
+
+switch = page.find_field { |input| input["role"] == "switch" }
+field = page.find_field(checked: true)
+
+switch == field # => true
+```
+
+[`find`]: https://rubydoc.info/github/teamcapybara/capybara/master/Capybara/Node/Finders:find
+[`all`]: https://rubydoc.info/github/teamcapybara/capybara/master/Capybara/Node/Finders:all
+[`Capybara.default_selector`]: https://rubydoc.info/github/teamcapybara/capybara/master/Capybara%2Econfigure
+[`find_by_id`]: https://rubydoc.info/github/teamcapybara/capybara/master/Capybara/Node/Finders:find_by_id
+[`find_field`]: https://rubydoc.info/github/teamcapybara/capybara/master/Capybara/Node/Finders:find_field
+[`find_link`]: https://rubydoc.info/github/teamcapybara/capybara/master/Capybara/Node/Finders:find_link
+
 ## <a name="matching"></a>Matching
 
 It is possible to customize how Capybara finds elements. At your disposal

data/lib/capybara/helpers.rb

@@ -78,7 +78,7 @@ module Capybara
       new_trace = trace.grep_v(filter) if new_trace.empty?
       new_trace = trace.dup if new_trace.empty?
 
-      new_trace.first.split(/:in /, 2).first
+      new_trace.first.split(':in ', 2).first
     end
 
     def warn(message, uplevel: 1)

data/lib/capybara/minitest/spec.rb

@@ -95,6 +95,18 @@ module Capybara
       # @!method wont_have_field
       #   See {Capybara::Node::Matchers#has_no_field?}
 
+      ##
+      # Expectation that there is element
+      #
+      # @!method must_have_element
+      #   See {Capybara::Node::Matchers#has_element?}
+
+      ##
+      # Expectation that there is no element
+      #
+      # @!method wont_have_element
+      #   See {Capybara::Node::Matchers#has_no_element?}
+
       ##
       # Expectation that there is link
       #
@@ -230,15 +242,15 @@ module Capybara
          %W[refute_matches_#{assertion} wont_match_#{assertion}]]
       end).each do |(meth, new_name)|
         class_eval <<-ASSERTION, __FILE__, __LINE__ + 1
-          def #{new_name} *args, **kw_args, &block
-            ::Minitest::Expectation.new(self, ::Minitest::Spec.current).#{new_name}(*args, **kw_args, &block)
+          def #{new_name}(...)
+            ::Minitest::Expectation.new(self, ::Minitest::Spec.current).#{new_name}(...)
           end
         ASSERTION
 
         ::Minitest::Expectation.class_eval <<-ASSERTION, __FILE__, __LINE__ + 1
-          def #{new_name} *args, **kw_args, &block
+          def #{new_name}(...)
             raise "Calling ##{new_name} outside of test." unless ctx
-            ctx.#{meth}(target, *args, **kw_args, &block)
+            ctx.#{meth}(target, ...)
           end
         ASSERTION
       end

data/lib/capybara/minitest.rb

@@ -190,6 +190,19 @@ module Capybara
       # @!method assert_no_css
       #   See {Capybara::Node::Matchers#has_no_css?}
 
+      ##
+      # Assert that provided element exists
+      #
+      # @!method assert_element
+      #   See {Capybara::Node::Matchers#has_element?}
+
+      ##
+      # Assert that provided element does not exist
+      #
+      # @!method assert_no_element
+      # @!method refute_element
+      #   See {Capybara::Node::Matchers#has_no_element?}
+
       ##
       # Assert that provided link exists
       #
@@ -281,7 +294,7 @@ module Capybara
       # @!method assert_no_table
       #   See {Capybara::Node::Matchers#has_no_table?}
 
-      %w[xpath css link button field select table].each do |selector_type|
+      %w[xpath css element link button field select table].each do |selector_type|
         define_method "assert_#{selector_type}" do |*args, &optional_filter_block|
           subject, args = determine_subject(args)
           locator, options = extract_locator(args)

data/lib/capybara/node/matchers.rb

@@ -322,6 +322,31 @@ module Capybara
         has_no_selector?(:css, path, **options, &optional_filter_block)
       end
 
+      ##
+      #
+      # Checks if the page or current node has a element with the given
+      # local name.
+      #
+      # @param [String] locator           The local name of a element to check for
+      # @option options [String, Regexp]  The attributes values of matching elements
+      # @return [Boolean]                 Whether it exists
+      #
+      def has_element?(locator = nil, **options, &optional_filter_block)
+        has_selector?(:element, locator, **options, &optional_filter_block)
+      end
+
+      ##
+      #
+      # Checks if the page or current node has no element with the given
+      # local name.
+      #
+      # @param (see #has_element?)
+      # @return [Boolean]            Whether it doesn't exist
+      #
+      def has_no_element?(locator = nil, **options, &optional_filter_block)
+        has_no_selector?(:element, locator, **options, &optional_filter_block)
+      end
+
       ##
       #
       # Checks if the page or current node has a link with the given

data/lib/capybara/node/whitespace_normalizer.rb

@@ -16,16 +16,16 @@ module Capybara
       PARAGRAPH_SEPERATOR = "\u2029"
 
       # All spaces except for NBSP
-      BREAKING_SPACES = "[[:space:]&&[^#{NON_BREAKING_SPACE}]]"
+      BREAKING_SPACES = "[[:space:]&&[^#{NON_BREAKING_SPACE}]]".freeze
 
       # Whitespace we want to substitute with plain spaces
-      SQUEEZED_SPACES = " \n\f\t\v#{LINE_SEPERATOR}#{PARAGRAPH_SEPERATOR}"
+      SQUEEZED_SPACES = " \n\f\t\v#{LINE_SEPERATOR}#{PARAGRAPH_SEPERATOR}".freeze
 
       # Any whitespace at the front of text
-      LEADING_SPACES = /\A#{BREAKING_SPACES}+/.freeze
+      LEADING_SPACES = /\A#{BREAKING_SPACES}+/
 
       # Any whitespace at the end of text
-      TRAILING_SPACES = /#{BREAKING_SPACES}+\z/.freeze
+      TRAILING_SPACES = /#{BREAKING_SPACES}+\z/
 
       # "Invisible" space character
       ZERO_WIDTH_SPACE = "\u200b"
@@ -40,7 +40,7 @@ module Capybara
       REMOVED_CHARACTERS = [ZERO_WIDTH_SPACE, LEFT_TO_RIGHT_MARK, RIGHT_TO_LEFT_MARK].join
 
       # Matches multiple empty lines
-      EMPTY_LINES = /[\ \n]*\n[\ \n]*/.freeze
+      EMPTY_LINES = /[\ \n]*\n[\ \n]*/
 
       ##
       #

data/lib/capybara/queries/selector_query.rb

@@ -70,7 +70,8 @@ module Capybara
           desc << 'non-visible ' if visible == :hidden
         end
 
-        desc << "#{label} #{locator.inspect}"
+        desc << label.to_s
+        desc << " #{locator.inspect}" unless locator.nil?
 
         if show_for[:any]
           desc << " with#{' exact' if exact_text == true} text #{options[:text].inspect}" if options[:text]

data/lib/capybara/rack_test/browser.rb

@@ -35,12 +35,13 @@ class Capybara::RackTest::Browser
     path = request_path if path.nil? || path.empty?
     uri = build_uri(path)
     uri.query = '' if method.to_s.casecmp('get').zero?
+    env = { 'HTTP_REFERER' => referer_url }
+    env['CONTENT_TYPE'] = content_type if content_type
     process_and_follow_redirects(
       method,
       uri.to_s,
       attributes,
-      'HTTP_REFERER' => referer_url,
-      'CONTENT_TYPE' => content_type
+      env
     )
   end
 

data/lib/capybara/rack_test/node.rb

@@ -125,19 +125,12 @@ class Capybara::RackTest::Node < Capybara::Driver::Node
     alias_method "unchecked_#{meth_name}", meth_name
     private "unchecked_#{meth_name}" # rubocop:disable Style/AccessModifierDeclarations
 
-    if RUBY_VERSION >= '2.7'
-      class_eval <<~METHOD, __FILE__, __LINE__ + 1
-        def #{meth_name}(...)
-          stale_check
-          method(:"unchecked_#{meth_name}").call(...)
-        end
-      METHOD
-    else
-      define_method meth_name do |*args|
+    class_eval <<~METHOD, __FILE__, __LINE__ + 1
+      def #{meth_name}(...)
         stale_check
-        send("unchecked_#{meth_name}", *args)
+        method(:"unchecked_#{meth_name}").call(...)
       end
-    end
+    METHOD
   end
 
 protected
@@ -232,7 +225,7 @@ private
       native.remove
     else
       value.to_s.tap do |set_value|
-        if set_value.end_with?("\n") && form&.css('input, textarea')&.count
+        if set_value.end_with?("\n") && form&.css('input, textarea')&.count == 1
           native['value'] = set_value.to_s.chop
           Capybara::RackTest::Form.new(driver, form).submit(self)
         else

data/lib/capybara/registration_container.rb

@@ -16,10 +16,10 @@ module Capybara
       @registered[name] = value
     end
 
-    def method_missing(method_name, *args, **options, &block)
+    def method_missing(method_name, ...)
       if @registered.respond_to?(method_name)
         Capybara::Helpers.warn "DEPRECATED: Calling '#{method_name}' on the drivers/servers container is deprecated without replacement"
-        return @registered.public_send(method_name, *args, **options, &block)
+        return @registered.public_send(method_name, ...)
       end
       super
     end

data/lib/capybara/registrations/drivers.rb

@@ -32,7 +32,7 @@ Capybara.register_driver :selenium_chrome_headless do |app|
   version = Capybara::Selenium::Driver.load_selenium
   options_key = Capybara::Selenium::Driver::CAPS_VERSION.satisfied_by?(version) ? :capabilities : :options
   browser_options = Selenium::WebDriver::Chrome::Options.new.tap do |opts|
-    opts.add_argument('--headless')
+    opts.add_argument('--headless=new')
     opts.add_argument('--disable-gpu') if Gem.win_platform?
     # Workaround https://bugs.chromium.org/p/chromedriver/issues/detail?id=2650&q=load&sort=-id&colspec=ID%20Status%20Pri%20Owner%20Summary
     opts.add_argument('--disable-site-isolation-trials')

data/lib/capybara/registrations/servers.rb

@@ -27,19 +27,20 @@ Capybara.register_server :puma do |app, port, host, **options| # rubocop:disable
     require 'rack/handler/puma'
   rescue LoadError
     raise LoadError, 'Capybara is unable to load `puma` for its server, please add `puma` to your project or specify a different server via something like `Capybara.server = :webrick`.'
-  else
-    unless Rack::Handler::Puma.respond_to?(:config)
-      raise LoadError, 'Capybara requires `puma` version 3.8.0 or higher, please upgrade `puma` or register and specify your own server block'
-    end
+  end
+  puma_rack_handler = defined?(Rackup::Handler::Puma) ? Rackup::Handler::Puma : Rack::Handler::Puma
+
+  unless puma_rack_handler.respond_to?(:config)
+    raise LoadError, 'Capybara requires `puma` version 3.8.0 or higher, please upgrade `puma` or register and specify your own server block'
   end
 
   # If we just run the Puma Rack handler it installs signal handlers which prevent us from being able to interrupt tests.
   # Therefore construct and run the Server instance ourselves.
-  # Rack::Handler::Puma.run(app, { Host: host, Port: port, Threads: "0:4", workers: 0, daemon: false }.merge(options))
+  # puma_rack_handler.run(app, { Host: host, Port: port, Threads: "0:4", workers: 0, daemon: false }.merge(options))
   default_options = { Host: host, Port: port, Threads: '0:4', workers: 0, daemon: false }
   options = default_options.merge(options)
 
-  conf = Rack::Handler::Puma.config(app, options)
+  conf = puma_rack_handler.config(app, options)
   conf.clamp
 
   puma_ver = Gem::Version.new(Puma::Const::PUMA_VERSION)
@@ -51,7 +52,7 @@ Capybara.register_server :puma do |app, port, host, **options| # rubocop:disable
   conf.options[:log_writer] = logger
 
   logger.log 'Capybara starting Puma...'
-  logger.log "* Version #{Puma::Const::PUMA_VERSION} , codename: #{Puma::Const::CODE_NAME}"
+  logger.log "* Version #{Puma::Const::PUMA_VERSION}, codename: #{Puma::Const::CODE_NAME}"
   logger.log "* Min threads: #{conf.options[:min_threads]}, max threads: #{conf.options[:max_threads]}"
 
   Puma::Server.new(

data/lib/capybara/result.rb

@@ -34,7 +34,7 @@ module Capybara
       @allow_reload = false
     end
 
-    def_delegators :full_results, :size, :length, :last, :values_at, :inspect, :sample
+    def_delegators :full_results, :size, :length, :last, :values_at, :inspect, :sample, :to_ary
 
     alias index find_index
 
@@ -116,7 +116,7 @@ module Capybara
         message << ' but there were no matches'
       else
         message << ", found #{count} #{Capybara::Helpers.declension('match', 'matches', count)}: " \
-                << full_results.map(&:text).map(&:inspect).join(', ')
+                << full_results.map { |r| r.text.inspect }.join(', ')
       end
       unless rest.empty?
         elements = rest.map { |el| el.text rescue '<<ERROR>>' }.map(&:inspect).join(', ') # rubocop:disable Style/RescueModifier

data/lib/capybara/rspec/matchers/have_selector.rb

@@ -22,9 +22,7 @@ module Capybara
           el.assert_no_selector(*@args, **session_query_options, &@filter_block)
         end
 
-        def description
-          "have #{query.description}"
-        end
+        def description = "have #{query.description}"
 
         def query
           @query ||= Capybara::Queries::SelectorQuery.new(*session_query_args, **session_query_options, &@filter_block)
@@ -40,9 +38,7 @@ module Capybara
           raise ArgumentError, 'The have_all_selectors matcher does not support use with not_to/should_not'
         end
 
-        def description
-          'have all selectors'
-        end
+        def description = 'have all selectors'
       end
 
       class HaveNoSelectors < WrappedElementMatcher
@@ -54,9 +50,7 @@ module Capybara
           raise ArgumentError, 'The have_none_of_selectors matcher does not support use with not_to/should_not'
         end
 
-        def description
-          'have no selectors'
-        end
+        def description = 'have no selectors'
       end
 
       class HaveAnySelectors < WrappedElementMatcher
@@ -68,9 +62,7 @@ module Capybara
           el.assert_none_of_selectors(*@args, **session_query_options, &@filter_block)
         end
 
-        def description
-          'have any selectors'
-        end
+        def description = 'have any selectors'
       end
     end
   end