Tsvalidate NPM

tsvalidate

Allows validating properties of objects and (multi-)nested objects via predefined decorators.

Installation

npm install tsvalidate

Usage

Import either the validator and specific decorators,

import {Validator, AlphaNumeric, MaxLen, IsInt, IsNotEmpty, InArray, IsDecimal, HexColor, IValidatorError}
  from "tsvalidate";

or use an alias for all exports.

import * as V from "tsvalidate";

Upon defining classes add any of the predefined decorators to their properties, then call the validate method passing the object:

import * as V from "tsvalidate";

export class Engine {

  @V.IsInt()
  horsepower: number;
}

export class Car {
    constructor() {
      this.engine = new Engine();      
    }

    @V.IsNotEmpty()
    model: string;

    @V.InArray(['Tesla', 'BMW', 'Mercedes', 'Volkswagen', 'Audi', 'Ford', 'Toyota'])
    make: string;

    @V.IsNotEmpty()
    @V.MinLen(17)
    @V.MaxLen(17)
    @V.AlphaNumeric()
    vehicleIdentificationNumber: string;

    @V.IsDecimal()
    fuelCapacity: number;

    @V.AlphaNumeric()
    @V.HexColor()
    color: string;

    @V.ValidateNested()
    engine: Engine;
}

let car = new Car();
car.model = 'Gallardo';         // Should succeed.
car.make =  'Lamborghini';       // Should fail.
car.vin = 'VWV1234XX99......';  // AlphaNumeric should fail.
car.fuelCapacity = 35;          // Should ?.
car.color = 'red';              // Should fail.
car.engine.horsepower = 513.5;  // Should fail.

let validator = new V.Validator();
let errors: V.IValidatorError = validator.validate(car);
if (errors.length > 0) {
  for (let i in errors)
    console.log(errors[i].message);
}

Errors

Returned errors use the supplied IValidatorError interface:

export interface IValidatorError {
  /**
   * Name of the target class that was validated.
   */
  target: string;
  /**
   * Target's property on which validation is applied.
   */
  property: string;
  /**
   * Error's type.
   */
  type: string;
  /**
   * Error's message.
   */
  message: string;
  /**
   * Value of that target's property, that didn't pass a validation.
   */
  value?: any;
  /**
   * That which the target's property was validated against.
   */
  comparison?: any;
}

Decorators

Currently, the following decorators are supported:

Validation decorators

Decorator	Description
Common validation decorators
`@IsDefined()`	Checks if value is defined (!== undefined).
`@Equals(comparison: any)`	Checks if value equals ("===") comparison.
`@IsEmpty()`	Checks if given value is empty (=== '', === null, === undefined).
`@IsNotEmpty()`	Checks if given value is not empty (!== '', !== null, !== undefined).
`@IsIn(values: any[])`	Checks if value is in a array of allowed values.
`@NotInArray(values: any[])`	Checks if value is not in a array of disallowed values.
Type validation decorators
`@ValidateType(type?: Object)`	Checks if a value is of the declared type. Any as parameter passed type has precedence over the declarated type. To check array items, pass an array of objects (e.g. number: pass [Number]).
`@IsInt()`	Checks if the value is an integer number.
`@IsFloat()`	Checks if the value is a float number.
`@IsDecimal()`	Checks if the value is a decimal number.
String and number validation decorators
`@MaxLen(value: number)`	Checks if the string or the number is no longer than the defined character length.
`@MinLen(value: number)`	Checks if the string or the number is not shorter than the defined character length.
`@Contains(value: string`\|`number)`	Checks if the string or the number contains the defined value.
String validation decorators
`@IsDate()`	Checks if the string is a date. mm-dd-(yy)yy or mm.dd.(yy)yy
`@ISO8601Date()`	Checks if the string is a date abiding ISO8601.
`@IsEmail()`	Checks if the string is an email address.
`@IsIP([4, 6]?: number)`	Checks if the string is an IP address. Optional check of specific protocol version.
`@IsMAC()`	Checks if the string is a MAC address. ff:ff:ff:ff:ff:ff
`@Alpha()`	Checks if the string consists entirely of letters (ignoring whitespace).
`@AlphaNumeric()`	Checks if the string is alphanumeric (ignoring whitespace).
`@Hexadecimal()`	Checks if the string is a hexadecimal number.
`@HexColor()`	Checks if the string is a hex color. #FF#FF#FF or FFFFFF
`@MaxByteLen(value: number)`	Checks if the string is no longer than the defined byte length.
`@MinByteLen(value: number)`	Checks if the string is not shorter than the defined byte length.
`@DateBefore(value: string)`	Checks if the string is a date prior to the defined date.
`@DateAfter(value: string)`	Checks if the string is a date past the defined date.
`@Uppercase()`	Checks if the string's letters are all uppercase.
`@Lowercase()`	Checks if the string's letters are all lowercase.
Number validation decorators
`@MaxValue(value: number)`	Checks if the number is no bigger than the defined cardinality.
`@MinValue(value: number)`	Checks if the number is not smaller than the defined cardinality.
`@MultipleOf(value: number)`	Checks if the number is a multiple of the defined integer.
Object validation decorators
`@ValidateNested()`	Checks all properties of the given object for decorators and handles all applicable.