Class NumberSchema

A base class for validation state. Provides methods for chaining.

Subclass constructors must accept a single argument: the new validator.

Hierarchy (view full)

ValueSchema<number>
- NumberSchema

Index

Constructors

constructor

new NumberSchema(currentValidator): NumberSchema
Constructs the first link in a schema chain.
Parameters
- currentValidator: Validator<any, any>
Returns NumberSchema
Inherited from ValueSchema.constructor
- Defined in util/validation/SchemaBase.ts:31
new NumberSchema(currentValidator, previousSchema, operation): NumberSchema
Constructs linking to the given previous schema.
Parameters
- currentValidator: Validator<any, any>
- previousSchema: SchemaBase<any>
- operation: ((validatorA: Validator<any, unknown>, validatorB: Validator<any, any>) => Validator<number, unknown>)
  - - (validatorA, validatorB): Validator<number, unknown>
    - Parameters
      validatorA: Validator<any, unknown>
      validatorB: Validator<any, any>
      Returns Validator<number, unknown>
Returns NumberSchema
Inherited from ValueSchema.constructor
- Defined in util/validation/SchemaBase.ts:40

Properties

__type

__type: Invariant<number> = ...

Enforces T is in an invariant position. This prevents a validator with more strict rules is assigned to a less strict type, which can cause unexpected validation errors.

`Protected` `Readonly`currentValidator

currentValidator: Validator<any, any>

`Protected` `Optional` `Readonly`operation

operation?: ((validatorA: Validator<any, unknown>, validatorB: Validator<any, any>) => Validator<number, unknown>)

`Protected` `Optional` `Readonly`previousSchema

previousSchema?: SchemaBase<any>

`Static` `Readonly`base

base: NumberSchema = ...

Accessors

description

get description(): string
A short description of the validator.

Returns string
Inherited from ValueSchema.description
- Defined in util/validation/SchemaBase.ts:63

Methods

and

and<U>(nextValidator): ValueSchema<number & U>
Returns a validator that asserts if this validator and the next passes.
Type Parameters
- U
Parameters
- nextValidator: Validator<U, any>
  The validator to run after the current.
Returns ValueSchema<number & U>
Returns a new ValueSchema intersecting this validator and the next.

See
andValidators
Inherited from ValueSchema.and
- Defined in util/validation/ValueSchema.ts:75

assert

assert(input, origin?, path?): asserts input is number
Validates the given input, asserting that the input is type T. If the input is not valid, a ValidationError will be thrown.
Parameters
- input: unknown
  The input to validate.
- Optionalorigin: string
  The error origin. ErrorOrigin.API by default.
- Optionalpath: readonly string[]
  The current field path to this validator.
Returns asserts input is number
Returns the input, cast as the validated type T
Inherited from ValueSchema.assert
- Defined in util/validation/SchemaBase.ts:67

`Protected`chain

chain(nextValidator): any
Constructs a new schema with a validator chaining the current validator with the provided next in an AND operation.
Parameters
- nextValidator: Validator<any, any>
  The validator to run after the current.
Returns any
Returns a new Schema instance the same class with a new validator chaining the current validator with the given next in an AND operation.
Inherited from ValueSchema.chain
- Defined in util/validation/SchemaBase.ts:141

`Protected`clone

clone(transform): any
Clones this schema, transforming all validators with the given mutator.
Parameters
- transform: ((validator: Validator<any, unknown>) => Validator<any, unknown>)
  A transformer which takes an existing validator in the chain and returns a new one. Validators should be considered to be immutable; transform should not change the input but instead return a new validator.
  - - (validator): Validator<any, unknown>
    - Parameters
      validator: Validator<any, unknown>
      Returns Validator<any, unknown>
Returns any
Inherited from ValueSchema.clone
- Defined in util/validation/SchemaBase.ts:94

finite

finite(): NumberSchema
Creates a validator that asserts that the input number is finite.

Returns NumberSchema
- Defined in util/validation/NumberSchema.ts:162

gt

gt(min): NumberSchema
Creates a validator that asserts that the input number is greater than the provided minimum value.
Parameters
- min: number
  The minimum (exclusive) the value may be.
Returns NumberSchema
- Defined in util/validation/NumberSchema.ts:124

gte

gte(min): NumberSchema
Creates a validator that asserts that the input number is at least the provided minimum value.
Parameters
- min: number
  The minimum (inclusive) the value may be.
Returns NumberSchema
- Defined in util/validation/NumberSchema.ts:114

isValid

isValid(input): input is number
Returns true if the input is valid according to this validator.
Parameters
- input: unknown
Returns input is number
Inherited from ValueSchema.isValid
- Defined in util/validation/SchemaBase.ts:75

lt

lt(max): NumberSchema
Creates a validator that asserts that the input number is less than the provided maximum value.
Parameters
- max: number
  The maximum (exclusive) the value may be.
Returns NumberSchema
- Defined in util/validation/NumberSchema.ts:144

lte

lte(max): NumberSchema
Creates a validator that asserts that the input number is at most the provided maximum value.
Parameters
- max: number
  The maximum (inclusive) the value may be.
Returns NumberSchema
- Defined in util/validation/NumberSchema.ts:134

maybe

maybe(): ValueSchema<undefined | null | number>
Prepends this validator allowing for null or undefined.

Returns ValueSchema<undefined | null | number>
Inherited from ValueSchema.maybe
- Defined in util/validation/ValueSchema.ts:49

or

or<U>(nextValidator): ValueSchema<number | U>
Returns a validator that asserts if this validator or the next passes.

Implementation note: subclasses should not change the schema instance returned unless all chainable validators accept input type 'unknown'.
Type Parameters
- U
Parameters
- nextValidator: Validator<U, any>
  The validator to run after the current.
Returns ValueSchema<number | U>
Returns a new ValueSchema providing the union of this validator and the next.
Inherited from ValueSchema.or
- Defined in util/validation/ValueSchema.ts:89

orNull

orNull(): ValueSchema<null | number>
Prepends this validator allowing for null.

Returns ValueSchema<null | number>
Inherited from ValueSchema.orNull
- Defined in util/validation/ValueSchema.ts:56

orUndefined

orUndefined(): ValueSchema<undefined | number>
Prepends this validator allowing for undefined.

Returns ValueSchema<undefined | number>
Inherited from ValueSchema.orUndefined
- Defined in util/validation/ValueSchema.ts:63

safeInteger

safeInteger(): NumberSchema
Creates a validator that asserts that the input number is a safe integer.

Returns NumberSchema
- Defined in util/validation/NumberSchema.ts:169

`Protected`self

self(current): any
Parameters
- current: Validator<any, any>
Returns any
Inherited from ValueSchema.self
- Defined in util/validation/SchemaBase.ts:106
self(currentValidator, previousSchema, operation): any
Parameters
- currentValidator: Validator<any, any>
- previousSchema: SchemaBase<any>
- operation: ((validatorA: Validator<any, unknown>, validatorB: Validator<any, any>) => Validator<number, unknown>)
  - - (validatorA, validatorB): Validator<number, unknown>
    - Parameters
      validatorA: Validator<any, unknown>
      validatorB: Validator<any, any>
      Returns Validator<number, unknown>
Returns any
Inherited from ValueSchema.self
- Defined in util/validation/SchemaBase.ts:108

validate

validate(input, options?, path?): readonly ValidationErrorMessage[]
Validates the provided input, returning a list of error messages, or an empty array if the input passes this validator.
Parameters
- input: unknown
  The input to validate.
- Optionaloptions: ValidationOptions
  Validation options.
- Optionalpath: readonly string[]
  The current field path to this validator.
Returns readonly ValidationErrorMessage[]
Returns an array of validation failures. If options.all is not true, only the first error will be returned.
Inherited from ValueSchema.validate
- Defined in util/validation/SchemaBase.ts:79

within

within(min, max): NumberSchema
Creates a validator that asserts that the input number is at least the provided minimum and at most the provided maximum values.
Parameters
- min: number
  The minimum (inclusive) value the input may be.
- max: number
  The maximum (inclusive) value the input may be.
Returns NumberSchema
- Defined in util/validation/NumberSchema.ts:155

Class NumberSchema

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns NumberSchema

Parameters

Parameters

Returns Validator<number, unknown>

Returns NumberSchema

Properties

__type

Protected ReadonlycurrentValidator

Protected Optional Readonlyoperation

Protected Optional ReadonlypreviousSchema

Static Readonlybase

Accessors

description

Returns string

Methods

and

Type Parameters

Parameters

Returns ValueSchema<number & U>

See

assert

Parameters

Returns asserts input is number

Protectedchain

Parameters

Returns any

Protectedclone

Parameters

Parameters

Returns Validator<any, unknown>

Returns any

finite

Returns NumberSchema

gt

Parameters

Returns NumberSchema

gte

Parameters

Returns NumberSchema

isValid

Parameters

Returns input is number

lt

Parameters

Returns NumberSchema

lte

Parameters

Returns NumberSchema

maybe

Returns ValueSchema<undefined | null | number>

or

Type Parameters

Parameters

Returns ValueSchema<number | U>

orNull

Returns ValueSchema<null | number>

orUndefined

Returns ValueSchema<undefined | number>

safeInteger

Returns NumberSchema

Protectedself

Parameters

Returns any

Parameters

Parameters

Returns Validator<number, unknown>

Returns any

validate

Parameters

Returns readonly ValidationErrorMessage[]

`Protected` `Readonly`currentValidator

`Protected` `Optional` `Readonly`operation

`Protected` `Optional` `Readonly`previousSchema

`Static` `Readonly`base

`Protected`chain

`Protected`clone

`Protected`self