Add spec for have and has? shortcuts

Author: ElMassimo

CHANGELOG.md

@@ -1,6 +1,7 @@
 ## Upcoming Changes
 
 *   Add `has?` alias for `has_selector?`.
+*   Delegate `have` to the RSpec collection matcher when passing an Integer.
 
 ## Capybara Test Helpers 1.0.0 (2020-11-17) ##
 

Gemfile

@@ -21,6 +21,9 @@ group :test do
   gem 'simplecov', '< 0.18'
   gem 'webdrivers'
 
+  # Test delegation to built-in matchers
+  gem 'rspec-collection_matchers'
+
   # Generator
   gem 'generator_spec', require: false
   gem 'rails', require: false

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    capybara_test_helpers (1.0.0)
+    capybara_test_helpers (1.0.1)
       activesupport
       capybara
 
@@ -181,6 +181,8 @@ GEM
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)
       rspec-mocks (~> 3.9.0)
+    rspec-collection_matchers (1.2.0)
+      rspec-expectations (>= 2.99.0.beta1)
     rspec-core (3.9.3)
       rspec-support (~> 3.9.3)
     rspec-expectations (3.9.3)
@@ -267,6 +269,7 @@ DEPENDENCIES
   rainbow
   rake (~> 12.0)
   rspec (~> 3.0)
+  rspec-collection_matchers
   rspec-rails
   rubocop
   selenium-webdriver (~> 3)

examples/rails_app/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ../..
   specs:
-    capybara_test_helpers (1.0.0)
+    capybara_test_helpers (1.0.1)
       activesupport
       capybara
 

lib/capybara_test_helpers/assertions.rb

@@ -93,7 +93,14 @@ def invert_expectation
     CapybaraTestHelpers.define_helper_method(self, method_name, target: :page, assertion: true, inject_test_helper: false)
   end
 
-  alias have have_selector
+  # Public: Allows to call have_selector with a shorter syntax.
+  def have(*args, **kwargs, &filter)
+    if args.first.is_a?(Integer)
+      ::RSpec::CollectionMatchers::Have.new(*args, **kwargs)
+    else
+      have_selector(*args, **kwargs, &filter)
+    end
+  end
 
   # Public: Allows to check on any input value asynchronously.
   def have_value(expected_value, **options)

lib/capybara_test_helpers/version.rb

@@ -2,5 +2,5 @@
 
 # Easily write fluent Page Objects for Capybara in Ruby.
 module CapybaraTestHelpers
-  VERSION = '1.0.0'
+  VERSION = '1.0.1'
 end

spec/capybara_test_helpers/matchers_spec.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+RSpec.feature 'matchers', test_helpers: [:form_page] do
+  describe 'has? and have' do
+    before do
+      form_page.visit_page
+    end
+
+    given(:form) { form_page.get_form }
+
+    it 'should not fail when using matchers' do
+      expect(form.has?(:middle_name_input)).to eq true
+      expect(form.has?(:middle_name_input, disabled: true)).to eq false
+    end
+
+    it 'should allow using have instead of have_selector' do
+      form.should.have(:middle_name_input)
+      expect {
+        form.should.have(:middle_name_input, disabled: true)
+      }.to raise_error(RSpec::Expectations::ExpectationNotMetError, /Expected disabled true but it wasn't/)
+    end
+
+    it 'should be able to use the RSpec matcher' do
+      expect { expect([1,2,3]).to form.have(3).items }.to raise_error(NameError)
+
+      require 'rspec/collection_matchers'
+      expect([1,2,3]).to form.have(3).items
+      expect([1,2,3]).not_to form.have(2).items
+    end
+  end
+end

test_helpers/form_page_test_helper.rb

@@ -24,6 +24,9 @@ class FormPageTestHelper < BaseTestHelper
 
     # Buttons Spec
     submit_button: [:button, type: 'submit'],
+
+    # Matchers Spec
+    middle_name_input: [:field, 'Middle Name', disabled: false],
   }.freeze
 
 # Getters: A convenient way to get related data or nested elements.