0.0.6 • Published 5 years ago
typescript-class-validator v0.0.6
Typescript runtime class validation
A library for runtime param validations using typescript decorators
that works with class-validator
library.
Useful when you need to validate parameter data coming from untyped source(i.e http body, and etc...) or when you need to perform complex validations on the input params.
Using the param validation decorator you can declare your validation on the type annotation and leave the validation work to class-validator
Install
npm install --save typescript-class-validator
Examples
import { Validator, Validate } from 'typescript-class-validator';
import { IsDate, IsNotEmpty, MaxDate, IsEmail, Length } from 'class-validator';
class DataDto {
@IsNotEmpty()
@IsEmail()
email: string;
@Length(10, 200)
@IsNotEmpty()
description: string;
@IsDate()
@IsNotEmpty()
@MaxDate(new Date())
birthDate: Date;
}
class TestClass {
@Validate()
methodName(@Validator() data: DataDto) {
}
@Validate()
serverControllerEndpoint(@Validator(DataDto, 'body') req: Request) {
}
}
const instance = new TestClass();
// Will throw class-validator errors on runtime
instance.methodName({
birthDate: new Date(),
description: '123',
email: 'fakemail'
});
instance.serverControllerEndpoint({
body: {
birthDate: new Date(),
description: '123',
email: 'fakemail'
}
});
Catching the Validation errors
In order to catch the validation errors you need to check if the errors is instanceof ValidatorError
;
import { ValidatorError } from 'typescript-class-validator';
try {
// ... code
} catch (error) {
if (error instanceof ValidatorError) {
// here you have access to the validationErrors object that
// will contain array of `class-validator` error objects.
console.log(error.validationErrors);
}
}