Class NumberShape

The shape of a number value.

Hierarchy (view full)

Shape<number>
- NumberShape

Constructors

constructor

new NumberShape(options?): NumberShape
Creates a new NumberShape instance.
Parameters
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns NumberShape
Overrides Shape.constructor

Properties

`Protected`_options

_options: undefined | IssueOptions | Message

The type issue options or the type issue message.

annotations

annotations: Dict<any> = {}

The dictionary of shape annotations.

See

Shape.annotate

`Readonly`inputs

inputs: readonly unknown[]

The array of unique input types and values that are accepted by the shape.

`Readonly`isAsync

isAsync: boolean

true if the shape allows only Shape.parseAsync and throws an error if Shape.parse is called, or false if the shape can be used in both sync and async contexts.

isCoercing

isCoercing: boolean = false

true if this shape coerces input values to the required type during parsing, or false otherwise.

operations

operations: readonly Operation[] = []

The array of operations that are applied to the shape output.

See

Methods

`Protected`_apply

_apply(input, options, _nonce): Result<number>
Synchronously parses the input.
Parameters
- input: any
  The shape input to parse.
- options: ParseOptions
  Parsing options.
- _nonce: number
  The globally unique number that identifies the parsing process.
Returns Result<number>
null if input matches the output, Ok that wraps the output, or an array of captured issues.

See
Advanced shapes

Overrides Shape._apply

`Protected`_applyAsync

_applyAsync(input, options, nonce): Promise<Result<number>>
Asynchronously parses the input.
Parameters
- input: unknown
  The shape input to parse.
- options: ParseOptions
  Parsing options.
- nonce: number
  The globally unique number that identifies the parsing process.
Returns Promise<Result<number>>
null if input matches the output, Ok that wraps the output, or an array of captured issues.

See
Advanced shapes

Inherited from Shape._applyAsync

`Protected`_applyOperations

_applyOperations(input, output, options, issues): Result | Promise<Result>
The callback that applies Shape.operations to the shape output value.

This method returns a promise if there are async Shape.operations.

If the shape overrides only Shape._apply and doesn't override Shape._applyAsync then it's only safe to call this method as the last statement in Shape._apply. Otherwise, it may return an unexpected promise.

If the shape overrides both Shape._apply and Shape._applyAsync then this method would always synchronously return a Result inside Shape._apply.
Parameters
- input: unknown
- output: unknown
- options: ParseOptions
- issues: null | Issue[]
Returns Result | Promise<Result>
Inherited from Shape._applyOperations

`Protected`_clone

_clone(): this
Clones the shape.

Returns this
See
Advanced shapes

Inherited from Shape._clone

`Protected`_getInputs

_getInputs(): readonly unknown[]
Returns input types and literal values that this shape can accept as an input.

Returns readonly unknown[]
See
Advanced shapes

Overrides Shape._getInputs

`Protected`_isAsync

_isAsync(): boolean
Must return true if the shape must be used in async context only, otherwise the shape can be used in both sync and async contexts. Override this method to implement a custom shape.

Returns boolean
See
Advanced shapes

Inherited from Shape._isAsync

accepts

accepts(input): boolean
Returns true if the shape accepts given input type or value, or false otherwise.
Parameters
- input: unknown
  The type or value that must be checked.
Returns boolean
Inherited from Shape.accepts

addAsyncOperation

addAsyncOperation<Param>(cb, options?): this
Adds an asynchronous operation to the shape.
Type Parameters
- Param
  The param that is passed to the operation when it is applied.
Parameters
- cb: OperationCallback<PromiseLike<Result<number>>, number, Param>
  The callback that asynchronously applies an operation to the shape output value.
- Optionaloptions: ParameterizedOperationOptions<Param>
  The operation options.
Returns this
The clone of the shape.

See
Operations

Inherited from Shape.addAsyncOperation
addAsyncOperation(cb, options?): this
Adds an asynchronous operation to the shape.
Parameters
- cb: OperationCallback<PromiseLike<Result<number>>, number>
  The callback that asynchronously applies an operation to the shape output value.
- Optionaloptions: OperationOptions
  The operation options.
Returns this
The clone of the shape.

See
Operations

Inherited from Shape.addAsyncOperation

addOperation

addOperation<Param>(cb, options?): this
Adds a synchronous operation to the shape.
Type Parameters
- Param
  The param that is passed to the operation when it is applied.
Parameters
- cb: OperationCallback<Result<number>, number, Param>
  The callback that synchronously applies an operation to the shape output value.
- Optionaloptions: ParameterizedOperationOptions<Param>
  The operation options.
Returns this
The clone of the shape.

See
Operations

Inherited from Shape.addOperation
addOperation(cb, options?): this
Adds a synchronous operation to the shape.
Parameters
- cb: OperationCallback<Result<number>, number>
  The callback that synchronously applies an operation to the shape output value.
- Optionaloptions: OperationOptions
  The operation options.
Returns this
The clone of the shape.

See
Operations

Inherited from Shape.addOperation

allow

allow<AllowedValue>(value): AllowShape<NumberShape, AllowedValue>
Allows an input value, so it is passed directly to the output.
Type Parameters
- AllowedValue extends Any
  The allowed value.
Parameters
- value: AllowedValue
  The allowed value.
Returns AllowShape<NumberShape, AllowedValue>
Inherited from Shape.allow

alter

alter<Param>(cb, options): this
Adds a synchronous operation that alters the output value without changing its type.

If you want to change the base type, consider using Shape.convert.
Type Parameters
- Param
  The param that is passed to the operation when it is applied.
Parameters
- cb: OperationCallback<number, number, Param>
  The callback that alters the shape output. Throw a ValidationError to notify that the alteration cannot be successfully completed.
- options: ParameterizedOperationOptions<Param>
  The operation options.
Returns this
The clone of the shape.
See
Inherited from Shape.alter
alter(cb, options?): this
Adds a synchronous operation that alters the output value without changing its type.

If you want to change the base type, consider using Shape.convert.
Parameters
- cb: OperationCallback<number, number>
  The callback that alters the shape output. Throw a ValidationError to notify that the alteration cannot be successfully completed.
- Optionaloptions: OperationOptions
  The operation options.
Returns this
The clone of the shape.
See
Inherited from Shape.alter

alterAsync

alterAsync<Param>(cb, options): this
Adds an asynchronous operation that alters the output value without changing its type.

If you want to change the base type, consider using Shape.convertAsync.
Type Parameters
- Param
  The param that is passed to the operation when it is applied.
Parameters
- cb: OperationCallback<PromiseLike<number>, number, Param>
  The callback that alters the shape output. Throw a ValidationError to notify that the alteration cannot be successfully completed.
- options: ParameterizedOperationOptions<Param>
  The operation options.
Returns this
The clone of the shape.
See
Inherited from Shape.alterAsync
alterAsync(cb, options?): this
Adds an asynchronous operation that alters the output value without changing its type.

If you want to change the base type, consider using Shape.convertAsync.
Parameters
- cb: OperationCallback<PromiseLike<number>, number>
  The callback that alters the shape output. Throw a ValidationError to notify that the alteration cannot be successfully completed.
- Optionaloptions: OperationOptions
  The operation options.
Returns this
The clone of the shape.
See
Inherited from Shape.alterAsync

annotate

annotate(annotations): this
Adds annotations to the shape.
Parameters
- annotations: ReadonlyDict<any>
  Annotations to add.
Returns this
The clone of the shape with the updated annotations.

See
Shape.annotations

Inherited from Shape.annotate

at

at(_key): null | AnyShape
Returns a sub-shape that describes a value associated with the given property name, or null if there's no such sub-shape.
Parameters
- _key: unknown
  The key for which the sub-shape must be retrieved.
Returns null | AnyShape
The sub-shape or null if there's no such key in the shape.

Inherited from Shape.at

brand

brand<Brand>(): RefineShape<NumberShape, Branded<number, Brand>>
Returns a shape that adds a brand to the output type.
Type Parameters
- Brand extends string | number | symbol
  The brand value.
Returns RefineShape<NumberShape, Branded<number, Brand>>
A shape with the branded output type.

Inherited from Shape.brand

catch

catch(): CatchShape<NumberShape, undefined>
Returns undefined if parsing fails.

Returns CatchShape<NumberShape, undefined>
Inherited from Shape.catch
catch<FallbackValue>(fallback): CatchShape<NumberShape, FallbackValue>
Returns the fallback value if parsing fails.
Type Parameters
- FallbackValue extends Any
  The fallback value.
Parameters
- fallback: FallbackValue | ((input: any, issues: Issue[], options: ParseOptions) => FallbackValue)
  The value or a callback that returns a value that is returned if parsing has failed. A callback receives an input value, an array of raised issues, and parsing options.
Returns CatchShape<NumberShape, FallbackValue>
Inherited from Shape.catch

check

check<Param>(cb, options): this
Adds a synchronous operation that checks that the shape output satisfies a requirement.

The callback must return null or undefined if value is valid, or an issue or an array of issues if value is invalid. If a callback returns an empty array, it is considered that no issues have occurred.
Type Parameters
- Param
  The param that is passed to the operation when it is applied.
Parameters
- cb: OperationCallback<CheckResult, number, Param>
  The callback that checks that a value satisfies a requirement and returns issues if it doesn't.
- options: ParameterizedOperationOptions<Param>
  The operation options.
Returns this
The clone of the shape.
See
Inherited from Shape.check
check(cb, options?): this
Adds a synchronous operation that checks that the shape output satisfies a requirement.

The callback must return null or undefined if value is valid, or an issue or an array of issues if value is invalid. If a callback returns an empty array, it is considered that no issues have occurred.
Parameters
- cb: OperationCallback<CheckResult, number>
  The callback that checks that a value satisfies a requirement and returns issues if it doesn't.
- Optionaloptions: OperationOptions
  The operation options.
Returns this
The clone of the shape.
See
Inherited from Shape.check

checkAsync

checkAsync<Param>(cb, options): this
Adds an asynchronous operation that checks that the shape output satisfies a requirement.

The callback must return a promise that is resolved with null or undefined if value is valid, or an issue or an array of issues if value is invalid. If promise resolves with an empty array, it is considered that no issues have occurred.
Type Parameters
- Param
  The param that is passed to the operation when it is applied.
Parameters
- cb: OperationCallback<PromiseLike<CheckResult>, number, Param>
  The callback that checks that a value satisfies a requirement and returns issues if it doesn't.
- options: ParameterizedOperationOptions<Param>
  The operation options.
Returns this
The clone of the shape.
See
Inherited from Shape.checkAsync
checkAsync(cb, options?): this
Adds an asynchronous operation that checks that the shape output satisfies a requirement.

The callback must return a promise that is resolved with null or undefined if value is valid, or an issue or an array of issues if value is invalid. If promise resolves with an empty array, it is considered that no issues have occurred.
Parameters
- cb: OperationCallback<PromiseLike<CheckResult>, number>
  The callback that checks that a value satisfies a requirement and returns issues if it doesn't.
- Optionaloptions: OperationOptions
  The operation options.
Returns this
The clone of the shape.
See
Inherited from Shape.checkAsync

coerce

coerce(): this
Enables an input value coercion.

Returns this
The clone of the shape.

convert

convert<ConvertedValue>(cb): Shape<number, ConvertedValue>
Synchronously converts the output value of the shape.

If you want to don't want to change the base type, consider using Shape.alter.
Type Parameters
- ConvertedValue
  The value returned from the callback that converts the output value of this shape.
Parameters
- cb: ((value: number, options: ParseOptions) => ConvertedValue)
  The callback that converts the input value. Throw a ValidationError to notify that the conversion cannot be successfully completed.
  - - (value, options): ConvertedValue
    - Parameters
      value: number
      options: ParseOptions
      Returns ConvertedValue
Returns Shape<number, ConvertedValue>
The ConvertShape instance.
See
- Shape.convertAsync
- Shape.alter
Inherited from Shape.convert

convertAsync

convertAsync<ConvertedValue>(cb): Shape<number, ConvertedValue>
Asynchronously converts the output value of the shape.

If you want to don't want to change the base type, consider using Shape.alterAsync.
Type Parameters
- ConvertedValue
  The value returned from the callback that converts the output value of this shape.
Parameters
- cb: ((value: number, options: ParseOptions) => PromiseLike<ConvertedValue>)
  The callback that converts the input value asynchronously. The returned promise can be rejected with a ValidationError to notify that the conversion cannot be successfully completed.
  - - (value, options): PromiseLike<ConvertedValue>
    - Parameters
      value: number
      options: ParseOptions
      Returns PromiseLike<ConvertedValue>
Returns Shape<number, ConvertedValue>
The ConvertShape instance.
See
- Shape.convert
- Shape.alterAsync
Inherited from Shape.convertAsync

deny

deny<DeniedValue>(value, options?): DenyShape<NumberShape, DeniedValue>
Excludes value from both input and output.
Type Parameters
- DeniedValue extends number
  The denied value.
Parameters
- value: DeniedValue
  The excluded value.
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns DenyShape<NumberShape, DeniedValue>
Inherited from Shape.deny

exclude

exclude<ExcludedShape>(shape, options?): ExcludeShape<NumberShape, ExcludedShape>
Checks that the input doesn't match the shape.
Type Parameters
- ExcludedShape extends AnyShape
  The shape to which the output must not conform.
Parameters
- shape: ExcludedShape
  The shape to which the output must not conform.
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns ExcludeShape<NumberShape, ExcludedShape>
Inherited from Shape.exclude

nan

nan(): AllowShape<NumberShape, number>
Allows NaN as an input and output value.

Returns AllowShape<NumberShape, number>
nan<T>(defaultValue): ReplaceShape<NumberShape, number, T>
Replaces an input NaN value with a default output value.
Type Parameters
- T extends Any
Parameters
- defaultValue: T
  The value that is used instead of NaN in the output.
Returns ReplaceShape<NumberShape, number, T>

nonOptional

nonOptional(options?): DenyShape<NumberShape, undefined>
Prevents an input and output from being undefined.
Parameters
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns DenyShape<NumberShape, undefined>
Inherited from Shape.nonOptional

not

not<ExcludedShape>(shape, options?): NotShape<NumberShape, ExcludedShape>
Checks that the input doesn't match the shape.

This method works exactly as Shape.exclude at runtime, but it doesn't perform the exclusion on the type level.
Type Parameters
- ExcludedShape extends AnyShape
  The shape to which the output must not conform.
Parameters
- shape: ExcludedShape
  The shape to which the output must not conform.
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns NotShape<NumberShape, ExcludedShape>
Inherited from Shape.not

nullable

nullable(): AllowShape<NumberShape, null>
Replaces null input value with an null output value.

Returns AllowShape<NumberShape, null>
Inherited from Shape.nullable
nullable<DefaultValue>(defaultValue): ReplaceShape<NumberShape, null, DefaultValue>
Replaces null input value with a default output value.
Type Parameters
- DefaultValue extends Any
  The value that is used as the replacement for null.
Parameters
- defaultValue: DefaultValue
  The value that should be used if an input value is null.
Returns ReplaceShape<NumberShape, null, DefaultValue>
Inherited from Shape.nullable

nullish

nullish(): AllowShape<AllowShape<NumberShape, null>, undefined>
Passes null and undefined input values directly to the output without parsing.

Returns AllowShape<AllowShape<NumberShape, null>, undefined>
Inherited from Shape.nullish
nullish<DefaultValue>(defaultValue?): ReplaceShape<ReplaceShape<NumberShape, null, DefaultValue>, undefined, DefaultValue>
Replaces null and undefined input value with a default output value.
Type Parameters
- DefaultValue extends Any
  The value that is used as the replacement for undefined and null.
Parameters
- OptionaldefaultValue: DefaultValue
  The value that should be used if an input value is undefined or null.
Returns ReplaceShape<ReplaceShape<NumberShape, null, DefaultValue>, undefined, DefaultValue>
Inherited from Shape.nullish

optional

optional(): AllowShape<NumberShape, undefined>
Replaces undefined input value with an undefined output value.

Returns AllowShape<NumberShape, undefined>
Inherited from Shape.optional
optional<DefaultValue>(defaultValue): ReplaceShape<NumberShape, undefined, DefaultValue>
Replaces undefined input value with a default output value.
Type Parameters
- DefaultValue extends Any
  The value that is used as the replacement for undefined.
Parameters
- defaultValue: DefaultValue
  The value that should be used if an input value is undefined.
Returns ReplaceShape<NumberShape, undefined, DefaultValue>
Inherited from Shape.optional

parse

parse(input, options?): number
Synchronously parses the value.
Parameters
- input: unknown
  The value to parse.
- Optionaloptions: ParseOptions
  Parsing options.
Returns number
The value that conforms the output type of the shape.

Throws
Error if the shape doesn't support the sync parsing, see Shape.isAsync.

Throws
ValidationError if any issues occur during parsing.

Inherited from Shape.parse

parseAsync

parseAsync(input, options?): Promisify<number>
Asynchronously parses the value.
Parameters
- input: unknown
  The value to parse.
- Optionaloptions: ParseOptions
  Parsing options.
Returns Promisify<number>
The promise that resolves with the value that conforms the output type of the shape, or rejects with a ValidationError if any issues occur during parsing.

Inherited from Shape.parseAsync

parseOrDefault

parseOrDefault(input): undefined | number
Synchronously parses the value and returns undefined if parsing fails.
Parameters
- input: unknown
  The value to parse.
Returns undefined | number
The value that conforms the output type of the shape.

Throws
Error if the shape doesn't support the sync parsing, see Shape.isAsync.

Inherited from Shape.parseOrDefault
parseOrDefault<DefaultValue>(input, defaultValue, options?): number | DefaultValue
Synchronously parses the value and returns the default value if parsing fails.
Type Parameters
- DefaultValue
  The default value that is returned if parsing fails.
Parameters
- input: unknown
  The value to parse.
- defaultValue: DefaultValue
  The default value that is returned if parsing fails.
- Optionaloptions: ParseOptions
  Parsing options.
Returns number | DefaultValue
The value that conforms the output type of the shape.

Throws
Error if the shape doesn't support the sync parsing, see Shape.isAsync.

Inherited from Shape.parseOrDefault

parseOrDefaultAsync

parseOrDefaultAsync(input): Promisify<undefined | number>
Asynchronously parses the value and returns undefined value if parsing fails.
Parameters
- input: unknown
  The value to parse.
Returns Promisify<undefined | number>
The value that conforms the output type of the shape.

Inherited from Shape.parseOrDefaultAsync
parseOrDefaultAsync<DefaultValue>(input, defaultValue, options?): Promisify<number | DefaultValue>
Asynchronously parses the value and returns the default value if parsing fails.
Type Parameters
- DefaultValue
  The default value that is returned if parsing fails.
Parameters
- input: unknown
  The value to parse.
- defaultValue: DefaultValue
  The default value that is returned if parsing fails.
- Optionaloptions: ParseOptions
  Parsing options.
Returns Promisify<number | DefaultValue>
The value that conforms the output type of the shape.

Inherited from Shape.parseOrDefaultAsync

refine

refine<RefinedValue, Param>(cb, options): RefineShape<NumberShape, RefinedValue>
Adds a synchronous operation that refines the shape output type with the narrowing predicate.
Type Parameters
- RefinedValue extends number
  The narrowed output value.
- Param
  The param that is passed to the operation when it is applied.
Parameters
- cb: RefinePredicate<number, RefinedValue, Param>
  The predicate that returns true if the value conforms the required type, or false otherwise.
- options: Message | ParameterizedRefineOptions<Param>
  The operation options or the issue message.
Returns RefineShape<NumberShape, RefinedValue>
The shape with the narrowed output.
See
Inherited from Shape.refine
refine<RefinedValue>(cb, options?): RefineShape<NumberShape, RefinedValue>
Adds a synchronous operation that refines the shape output type with the narrowing predicate.
Type Parameters
- RefinedValue extends number
  The narrowed output value.
Parameters
- cb: RefinePredicate<number, RefinedValue>
  The predicate that returns true if the value conforms the required type, or false otherwise.
- Optionaloptions: Message | RefineOptions
  The operation options or the issue message.
Returns RefineShape<NumberShape, RefinedValue>
The shape with the narrowed output.
See
Inherited from Shape.refine
refine<Param>(cb, options?): this
Adds a synchronous operation that checks that the output value conforms the predicate.
Type Parameters
- Param
  The param that is passed to the operation when it is applied.
Parameters
- cb: OperationCallback<unknown, number, Param>
  The predicate that returns truthy result if the value is valid, or returns falsy result otherwise.
- Optionaloptions: Message | ParameterizedRefineOptions<Param>
  The operation options or the issue message.
Returns this
The clone of the shape.
See
Inherited from Shape.refine
refine(cb, options?): this
Adds a synchronous operation that checks that the output value conforms the predicate.
Parameters
- cb: OperationCallback<unknown, number>
  The predicate that returns truthy result if the value is valid, or returns falsy result otherwise.
- Optionaloptions: Message | RefineOptions
  The operation options or the issue message.
Returns this
The clone of the shape.
See
Inherited from Shape.refine

refineAsync

refineAsync<Param>(cb, options?): this
Adds an asynchronous operation that checks that the output value conforms the predicate.
Type Parameters
- Param
  The param that is passed to the operation when it is applied.
Parameters
- cb: OperationCallback<PromiseLike<unknown>, number, Param>
  The predicate that returns a promise that resolves with a truthy result if the value is valid, or a falsy result otherwise.
- Optionaloptions: Message | ParameterizedRefineOptions<Param>
  The operation options or the issue message.
Returns this
The clone of the shape.
See
Inherited from Shape.refineAsync
refineAsync(cb, options?): this
Adds an asynchronous operation that checks that the output value conforms the predicate.
Parameters
- cb: OperationCallback<PromiseLike<unknown>, number>
  The predicate that returns a promise that resolves with a truthy result if the value is valid, or a falsy result otherwise.
- Optionaloptions: Message | RefineOptions
  The operation options or the issue message.
Returns this
The clone of the shape.
See
Inherited from Shape.refineAsync

replace

replace<InputValue, OutputValue>(inputValue, outputValue): ReplaceShape<NumberShape, InputValue, OutputValue>
Replaces an input value with an output value.
Type Parameters
- InputValue extends Any
  The input value to replace.
- OutputValue extends Any
  The output value that is used as the replacement for an input value.
Parameters
- inputValue: InputValue
  The input value to replace.
- outputValue: OutputValue
  The output value that is returned if an inputValue is received.
Returns ReplaceShape<NumberShape, InputValue, OutputValue>
Inherited from Shape.replace

to

to<OutputShape>(shape): PipeShape<NumberShape, OutputShape>
Pipes the output of this shape to the input of another shape.
Type Parameters
- OutputShape extends AnyShape
  The output value.
Parameters
- shape: OutputShape
  The shape that validates the output if this shape.
Returns PipeShape<NumberShape, OutputShape>
Inherited from Shape.to

try

try(input, options?): Err | Ok<number>
Synchronously parses the value and returns Ok or Err object that wraps the result.
Parameters
- input: unknown
  The value to parse.
- Optionaloptions: ParseOptions
  Parsing options.
Returns Err | Ok<number>
The Ok instance if parsing has succeeded or Err if parsing has failed.

Throws
Error if the shape doesn't support the sync parsing, see Shape.isAsync.

Inherited from Shape.try

tryAsync

tryAsync(input, options?): Promise<Err | Ok<number>>
Asynchronously parses the value and returns Ok or Err object that wraps the result.
Parameters
- input: unknown
  The value to parse.
- Optionaloptions: ParseOptions
  Parsing options.
Returns Promise<Err | Ok<number>>
The Ok instance if parsing has succeeded or Err if parsing has failed.

Inherited from Shape.tryAsync

Plugin Methods

between

between(minValue, maxValue, options?): this
Constrains the number to be between the inclusive minimum and maximum.
Parameters
- minValue: number
  The inclusive minimum value.
- maxValue: number
  The inclusive maximum value.
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

finite

finite(options?): this
Constrains the number to be a finite number.
Parameters
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

gt

gt(value, options?): this
Constrains the number to be greater than the value.
Parameters
- value: number
  The exclusive minimum value.
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

gte

gte(value, options?): this
Constrains the number to be greater than or equal to the value.
Parameters
- value: number
  The inclusive minimum value.
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

int

int(options?): this
Constrains the number to be an integer.
Parameters
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

lt

lt(value, options?): this
Constrains the number to be less than the value.
Parameters
- value: number
  The exclusive maximum value.
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

lte

lte(value, options?): this
Constrains the number to be less than or equal to the value.
Parameters
- value: number
  The inclusive maximum value.
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

max

max(value, options?): this
Constrains the number to be less than or equal to the value.
Parameters
- value: number
  The inclusive maximum value.
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Alias
NumberShape.lte

Plugin
plugin/number-essentials

min

min(value, options?): this
Constrains the number to be greater than or equal to the value.
Parameters
- value: number
  The inclusive minimum value.
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Alias
NumberShape.gte

Plugin
plugin/number-essentials

multipleOf

multipleOf(divisor, options?): this
Constrains the number to be a multiple of the divisor.
Parameters
- divisor: number
  The positive number by which the input should be divisible without a remainder.
- Optionaloptions: Message | MultipleOfOptions
  The check options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

negative

negative(options?): this
Constrains the number to be less than zero.
Parameters
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

nonNegative

nonNegative(options?): this
Constrains the number to be greater or equal to zero.
Parameters
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

nonPositive

nonPositive(options?): this
Constrains the number to be less or equal to zero.
Parameters
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

positive

positive(options?): this
Constrains the number to be greater than zero.
Parameters
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

safe

safe(options?): this
Number must be between Number.MIN_SAFE_INTEGER and Number.MAX_SAFE_INTEGER.
Parameters
- Optionaloptions: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

Class NumberShape

Hierarchy (view full)

Index

Constructors

Properties

Methods

Plugin Methods

Constructors

constructor

Parameters

Returns NumberShape

Properties

Protected_options

annotations

See

Readonlyinputs

ReadonlyisAsync

isCoercing

operations

See

Methods

Protected_apply

Parameters

Returns Result<number>

See

Protected_applyAsync

Parameters

Returns Promise<Result<number>>

See

Protected_applyOperations

Parameters

Returns Result | Promise<Result>

Protected_clone

Returns this

See

Protected_getInputs

Returns readonly unknown[]

See

Protected_isAsync

Returns boolean

See

accepts

Parameters

Returns boolean

addAsyncOperation

Type Parameters

Parameters

Returns this

See

Parameters

Returns this

See

addOperation

Type Parameters

Parameters

Returns this

See

Parameters

Returns this

See

allow

Type Parameters

Parameters

Returns AllowShape<NumberShape, AllowedValue>

alter

Type Parameters

Parameters

Returns this

See

Parameters

Returns this

See

alterAsync

Type Parameters

Parameters

Returns this

See

Parameters

Returns this

See

`Protected`_options

`Readonly`inputs

`Readonly`isAsync

`Protected`_apply

`Protected`_applyAsync

`Protected`_applyOperations

`Protected`_clone

`Protected`_getInputs

`Protected`_isAsync