Table of contents
class Validator<T> implements Validatable<T> {}

Constructor

Constructs a new instance of the Validator class

Parameters
NameDescription

validationFn

ValidatorFn<T>

validateUsingKnownGoodVersionFn

  | undefined
  | ValidatorUsingKnownGoodVersionFn<T, T>

Properties

validateUsingKnownGoodVersionFn

readonly validateUsingKnownGoodVersionFn?:
  | undefined
  | ValidatorUsingKnownGoodVersionFn<T, T>

validationFn

readonly validationFn: ValidatorFn<T>

Methods

check()

Refine this validation with an additional check that doesn't change the resulting value.

check(name: string, checkFn: (value: T) => void): Validator<T>
Example
const numberLessThan10Validator = T.number.check((value) => {
  if (value >= 10) {
    throw new ValidationError(`Expected number less than 10, got ${value}`)
  }
})
Parameters
NameDescription

name

string

checkFn

(value: T) => void
Returns
Validator<T>

isValid()

Checks that the passed value is of the correct type.

isValid(value: unknown): value is T
Parameters
NameDescription

value

unknown
Returns
value is T

nullable()

Returns a new validator that also accepts null or undefined. The resulting value will always be null.

nullable(): Validator<null | T>

optional()

Returns a new validator that also accepts null or undefined. The resulting value will always be null.

optional(): Validator<T | undefined>

refine()

Refine this validation to a new type. The passed-in validation function should throw an error if the value can't be converted to the new type, or return the new type otherwise.

refine<U>(otherValidationFn: (value: T) => U): Validator<U>
Parameters
NameDescription

otherValidationFn

(value: T) => U
Returns
Validator<U>

validate()

Asserts that the passed value is of the correct type and returns it. The returned value is guaranteed to be referentially equal to the passed value.

validate(value: unknown): T
Parameters
NameDescription

value

unknown
Returns
T

validateUsingKnownGoodVersion()

validateUsingKnownGoodVersion(knownGoodValue: T, newValue: unknown): T
Parameters
NameDescription

knownGoodValue

T

newValue

unknown
Returns
T

UnionValidator