Class NumberShape

The shape of a number value.

Hierarchy (view full)

CoercibleShape<number>
- NumberShape

Index

Constructors

constructor

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

Properties

`Protected` _applyCoerce

_applyCoerce: ((input) => number) = coerceToNever

Applies coercion rules to the given value. Call this method in Shape._apply and Shape._applyAsync to coerce the input.

Override CoercibleShape._coerce and Shape._getInputs methods to implement custom type coercion.

Type declaration

- (input): number
- Parameters
  - input: unknown
    The input value to coerce.
  Returns number

Returns

The coerced value, or NEVER if coercion isn't possible.

`Protected` _applyOperations

_applyOperations: ApplyOperationsCallback

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.

`Protected` _typeIssueFactory

_typeIssueFactory: ((input, options) => Issue)

Returns issues associated with an invalid input value type.

Type declaration

- (input, options): Issue
- Parameters
  - input: unknown
  - options: ApplyOptions
  Returns Issue

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.

operations

operations: readonly Operation[] = []

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

See

`Static` `Readonly` messages

messages: Messages = defaultMessages

The mapping from an issue type to a corresponding issue message.

Methods

`Protected` _apply

_apply(input, options, nonce): Result<number>
Synchronously parses the input.
Parameters
- input: any
  The shape input to parse.
- options: ApplyOptions
  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 CoercibleShape._apply

`Protected` _applyAsync

_applyAsync(input, options, nonce): Promise<Result<number>>
Asynchronously parses the input.
Parameters
- input: unknown
  The shape input to parse.
- options: ApplyOptions
  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 CoercibleShape._applyAsync

`Protected` _clone

_clone(): this
Clones the shape.

Returns this
See
Advanced shapes

Inherited from CoercibleShape._clone

`Protected` _coerce

_coerce(input): number
Coerces an input value to another type.

Override this method along with Shape._getInputs to implement custom type coercion.
Parameters
- input: unknown
  The input value to coerce.
Returns number
The coerced value, or NEVER if coercion isn't possible.

Inherited from CoercibleShape._coerce

`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 CoercibleShape._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 CoercibleShape._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 CoercibleShape.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.
- Optional options: ParameterizedOperationOptions<Param>
  The operation options.
Returns this
The clone of the shape.

See
Operations

Inherited from CoercibleShape.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.
- Optional options: OperationOptions
  The operation options.
Returns this
The clone of the shape.

See
Operations

Inherited from CoercibleShape.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.
- Optional options: ParameterizedOperationOptions<Param>
  The operation options.
Returns this
The clone of the shape.

See
Operations

Inherited from CoercibleShape.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.
- Optional options: OperationOptions
  The operation options.
Returns this
The clone of the shape.

See
Operations

Inherited from CoercibleShape.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 CoercibleShape.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 CoercibleShape.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.
- Optional options: OperationOptions
  The operation options.
Returns this
The clone of the shape.
See
Inherited from CoercibleShape.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 CoercibleShape.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.
- Optional options: OperationOptions
  The operation options.
Returns this
The clone of the shape.
See
Inherited from CoercibleShape.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 CoercibleShape.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 CoercibleShape.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 CoercibleShape.brand

catch

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

Returns CatchShape<NumberShape, undefined>
Inherited from CoercibleShape.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, issues, options) => 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 CoercibleShape.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 CoercibleShape.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.
- Optional options: OperationOptions
  The operation options.
Returns this
The clone of the shape.
See
Inherited from CoercibleShape.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 CoercibleShape.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.
- Optional options: OperationOptions
  The operation options.
Returns this
The clone of the shape.
See
Inherited from CoercibleShape.checkAsync

coerce

coerce(): this
Enables an input value coercion.

Returns this
The clone of the shape.

Inherited from CoercibleShape.coerce

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, options) => 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: ApplyOptions
      Returns ConvertedValue
Returns Shape<number, ConvertedValue>
The ConvertShape instance.
See
- Shape.convertAsync
- Shape.alter
Inherited from CoercibleShape.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, options) => 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: ApplyOptions
      Returns PromiseLike<ConvertedValue>
Returns Shape<number, ConvertedValue>
The ConvertShape instance.
See
- Shape.convert
- Shape.alterAsync
Inherited from CoercibleShape.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.
- Optional options: IssueOptions | Message
  The issue options or the issue message.
Returns DenyShape<NumberShape, DeniedValue>
Inherited from CoercibleShape.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.
- Optional options: IssueOptions | Message
  The issue options or the issue message.
Returns ExcludeShape<NumberShape, ExcludedShape>
Inherited from CoercibleShape.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
- Optional options: IssueOptions | Message
  The issue options or the issue message.
Returns DenyShape<NumberShape, undefined>
Inherited from CoercibleShape.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.
- Optional options: IssueOptions | Message
  The issue options or the issue message.
Returns NotShape<NumberShape, ExcludedShape>
Inherited from CoercibleShape.not

nullable

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

Returns AllowShape<NumberShape, null>
Inherited from CoercibleShape.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 CoercibleShape.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 CoercibleShape.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
- Optional defaultValue: 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 CoercibleShape.nullish

optional

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

Returns AllowShape<NumberShape, undefined>
Inherited from CoercibleShape.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 CoercibleShape.optional

parse

parse(input, options?): number
Synchronously parses the value.
Parameters
- input: unknown
  The value to parse.
- Optional options: 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 CoercibleShape.parse

parseAsync

parseAsync(input, options?): Promisify<number>
Asynchronously parses the value.
Parameters
- input: unknown
  The value to parse.
- Optional options: 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 CoercibleShape.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 CoercibleShape.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.
- Optional options: ApplyOptions
  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 CoercibleShape.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 CoercibleShape.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.
- Optional options: ApplyOptions
  Parsing options.
Returns Promisify<number | DefaultValue>
The value that conforms the output type of the shape.

Inherited from CoercibleShape.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 CoercibleShape.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.
- Optional options: Message | RefineOptions
  The operation options or the issue message.
Returns RefineShape<NumberShape, RefinedValue>
The shape with the narrowed output.
See
Inherited from CoercibleShape.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.
- Optional options: Message | ParameterizedRefineOptions<Param>
  The operation options or the issue message.
Returns this
The clone of the shape.
See
Inherited from CoercibleShape.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.
- Optional options: Message | RefineOptions
  The operation options or the issue message.
Returns this
The clone of the shape.
See
Inherited from CoercibleShape.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.
- Optional options: Message | ParameterizedRefineOptions<Param>
  The operation options or the issue message.
Returns this
The clone of the shape.
See
Inherited from CoercibleShape.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.
- Optional options: Message | RefineOptions
  The operation options or the issue message.
Returns this
The clone of the shape.
See
Inherited from CoercibleShape.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 CoercibleShape.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 CoercibleShape.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.
- Optional options: ApplyOptions
  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 CoercibleShape.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.
- Optional options: ApplyOptions
  Parsing options.
Returns Promise<Err | Ok<number>>
The Ok instance if parsing has succeeded or Err if parsing has failed.

Inherited from CoercibleShape.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.
- Optional options: 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
- Optional options: 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.
- Optional options: 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.
- Optional options: 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
- Optional options: 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.
- Optional options: 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.
- Optional options: 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.
- Optional options: 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.
- Optional options: 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.
- Optional options: 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
- Optional options: 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
- Optional options: 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
- Optional options: 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
- Optional options: 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
- Optional options: IssueOptions | Message
  The issue options or the issue message.
Returns this
The clone of the shape.

Plugin
plugin/number-essentials

Accessors

isCoercing

get isCoercing(): boolean
true if this shapes coerces input values to the required type during parsing, or false otherwise.

Returns boolean
Inherited from CoercibleShape.isCoercing

Class NumberShape

Hierarchy (view full)

Index

Constructors

Properties

Methods

Plugin Methods

Accessors

Constructors

constructor

Parameters

Returns NumberShape

Properties

Protected _applyCoerce

Type declaration

Parameters

Returns number

Returns

Protected _applyOperations

Protected _typeIssueFactory

Type declaration

Parameters

Returns Issue

annotations

See

Readonly inputs

Readonly isAsync

operations

See

Static Readonly messages

Methods

Protected _apply

Parameters

Returns Result<number>

See

Protected _applyAsync

Parameters

Returns Promise<Result<number>>

See

Protected _clone

Returns this

See

Protected _coerce

Parameters

Returns number

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

`Protected` _applyCoerce

`Protected` _applyOperations

`Protected` _typeIssueFactory

`Readonly` inputs

`Readonly` isAsync

`Static` `Readonly` messages

`Protected` _apply

`Protected` _applyAsync

`Protected` _clone

`Protected` _coerce

`Protected` _getInputs

`Protected` _isAsync