Skip to main content

Built in Validators

Super validator only supplies a few basic validators. You can take a look into making your own or using addons for more validators.

If you have suggestions for more validators please create a issue here.

Required#

Makes a value required. This will fail if the value is equal to null or undefined.

import { required } from 'super-validator'
required()// Orrequired('Custom Error Message')

Params#

NameTypeDescription
customMessagestring, undefinedCustom message to override any validation errors.

Min#

If the value to validate is a number it will check to make sure it is equal to or greater than x. If the value is a string it will ensure the length of the string is at least x characters long.

Params#

NameTypeDescription
minValuenumberThe minimum value if the input is a number or the minimum length if a string is the value
customMessagestring, undefinedCustom message to override any validation errors.
import { min } from 'super-validator'
min(5)// Ormin(5, 'Custom Error Message')

Notes#

  • If the value is undefined or null this will not return a error. You should use required as well as this if you want to check if its not included.

Max#

If the value to validate is a number it will check to make sure it is less than or equal to x. If the value is a string it will ensure the length of the string is not longer than x.

Params#

NameTypeDescription
maxValuenumberThe maximum value the input can be if the value is a number or the maximum length if a string is the value
customMessagestring, undefinedCustom message to override any validation errors.
import { max } from 'super-validator'
max(5)// Ormax(5, 'Custom Error Message')

Notes#

  • If the value is undefined or null this will not return a error. You should use required as well as this if you want to check if its not included.

TypeOf#

If the value to validate is a number it will check to make sure it is less than or equal to x. If the value is a string it will ensure the length of the string is not longer than x.

Params#

NameTypeDescription
typestringThe type the value should be. If the value has a type of anything else it will return a error.
customMessagestring, undefinedCustom message to override any validation errors.
import { typeOf } from 'super-validator'
typeOf('string')// OrtypeOf('string', 'Custom Error Message')

Equals#

Checks if the value is equal to another this can be used with both strict and non strict checks.

Params#

NameTypeDescriptionDefault
toMatchunknownThe object to match to the value provided.
strictbooleanIf we should use strict equals or not. (This should be true in most cases.)true
customMessagestring, undefinedCustom message to override any validation errors.
import { equal } from 'super-validator'
equal(true)// Orequal('test')// Orequal(6)// Orequal(null, false)// OrtypeOf('test', true, 'Custom Error Message')