Correctly handle record_errors scenario

lib/json_matchers/matcher.rb

@@ -9,11 +9,29 @@ def initialize(schema_path, options = {})
     end
 
     def matches?(response)
-      JSON::Validator.validate!(
-        schema_path.to_s,
-        Payload.new(response).to_s,
-        options,
-      )
+      # validate! will not raise and will always return true if you configure the validator
+      # to record errors, so we must instead inspect fully_validate's errors response
+      if options[:record_errors]
+        errors = JSON::Validator.fully_validate(
+          schema_path.to_s,
+          Payload.new(response).to_s,
+          options
+        )
+
+        # errors is an array, but it will always only return a single item
+        if errors.any?
+          @validation_failure_message = errors.first
+          false
+        else
+          true
+        end
+      else
+        JSON::Validator.validate!(
+          schema_path.to_s,
+          Payload.new(response).to_s,
+          options
+        )
+      end
     rescue JSON::Schema::ValidationError => ex
       @validation_failure_message = ex.message
       false

spec/json_matchers/match_response_schema_spec.rb

@@ -165,6 +165,29 @@
         config.options.delete(:strict)
       end
     end
+
+    context "when options specify to record errors" do
+      around do |example|
+        JsonMatchers.configure do |config|
+          config.options[:record_errors] = true
+        end
+
+        example.run
+
+        JsonMatchers.configure do |config|
+          config.options.delete(:record_errors)
+        end
+      end
+
+      it "fails when the body is missing a required property" do
+        create_schema("foo_schema", {
+          "type" => "object",
+          "required" => ["foo"],
+        })
+
+        expect(response_for({})).not_to match_response_schema("foo_schema")
+      end
+    end
   end
 
   def raise_formatted_error(error_message)