feat: add option to stop validation at first error

README.md

@@ -135,6 +135,7 @@ export interface ValidatorOptions {
   };
 
   forbidUnknownValues?: boolean;
+  stopAtFirstError?: boolean;
 }
 ```
 

src/validation/ValidationExecutor.ts

@@ -238,6 +238,12 @@ export class ValidationExecutor {
     metadatas.forEach(metadata => {
       this.metadataStorage.getTargetValidatorConstraints(metadata.constraintCls).forEach(customConstraintMetadata => {
         if (customConstraintMetadata.async && this.ignoreAsyncValidations) return;
+        if (
+          this.validatorOptions &&
+          this.validatorOptions.stopAtFirstError &&
+          Object.keys(error.constraints || {}).length > 0
+        )
+          return;
 
         const validationArguments: ValidationArguments = {
           targetName: object.constructor ? (object.constructor as any).name : undefined,

src/validation/ValidatorOptions.ts

@@ -59,4 +59,9 @@ export interface ValidatorOptions {
    * Settings true will cause fail validation of unknown objects.
    */
   forbidUnknownValues?: boolean;
+
+  /**
+   * When set to true, validation of the given property will stop after encountering the first error. Defaults to false.
+   */
+  stopAtFirstError?: boolean;
 }

test/functional/validation-options.spec.ts

@@ -1086,4 +1086,24 @@ describe('context', () => {
       expect(errors[1].contexts['contains']).toEqual({ bye: 'now' });
     });
   });
+
+  it('should stop at first error.', () => {
+    class MyClass {
+      @IsDefined({
+        message: 'isDefined',
+      })
+      @Contains('hello', {
+        message: 'String is not valid. You string must contain a hello word',
+      })
+      sameProperty: string;
+    }
+
+    const model = new MyClass();
+    return validator.validate(model, { stopAtFirstError: true }).then(errors => {
+      console.log();
+      expect(errors.length).toEqual(1);
+      expect(Object.keys(errors[0].constraints).length).toBe(1);
+      expect(errors[0].constraints['isDefined']).toBe('isDefined');
+    });
+  });
 });