Creates a new ArrayShape instance.
The array of positioned element shapes.
The shape of rest elements or null if there are no rest elements.
Optional options: IssueOptions | MessageThe issue options or the issue message.
Protected _applyApplies 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.
The input value to coerce.
The coerced value, or NEVER if coercion isn't possible.
Protected _applyThe 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 _optionsThe type constraint options or the type issue message.
Protected _typeReturns issues associated with an invalid input value type.
The dictionary of shape annotations.
Readonly headThe array of positioned element shapes.
Readonly inputsThe array of unique input types and values that are accepted by the shape.
Readonly istrue 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.
The array of operations that are applied to the shape output.
Readonly restThe shape of rest elements or null if there are no rest elements.
Static Readonly messagesThe mapping from an issue type to a corresponding issue message.
Protected _applySynchronously parses the input.
The shape input to parse.
Parsing options.
The globally unique number that identifies the parsing process.
null if input matches the output, Ok that wraps the output, or an array of captured issues.
Protected _applyAsynchronously parses the input.
The shape input to parse.
Parsing options.
The globally unique number that identifies the parsing process.
null if input matches the output, Ok that wraps the output, or an array of captured issues.
Protected _cloneClones the shape.
Protected _coerceCoerces a value to an array.
The value to coerce.
An array, or NEVER if coercion isn't possible.
Protected _getProtected _isAdds an asynchronous operation to the shape.
The param that is passed to the operation when it is applied.
The callback that asynchronously applies an operation to the shape output value.
Optional options: ParameterizedOperationOptions<Param>The operation options.
The clone of the shape.
Adds an asynchronous operation to the shape.
The callback that asynchronously applies an operation to the shape output value.
Optional options: OperationOptionsThe operation options.
The clone of the shape.
Adds a synchronous operation to the shape.
The param that is passed to the operation when it is applied.
The callback that synchronously applies an operation to the shape output value.
Optional options: ParameterizedOperationOptions<Param>The operation options.
The clone of the shape.
Adds a synchronous operation to the shape.
The callback that synchronously applies an operation to the shape output value.
Optional options: OperationOptionsThe operation options.
The clone of the shape.
Allows an input value, so it is passed directly to the output.
The allowed value.
The allowed value.
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.
The param that is passed to the operation when it is applied.
The callback that alters the shape output. Throw a ValidationError to notify that the alteration cannot be successfully completed.
The operation options.
The clone of the shape.
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.
The callback that alters the shape output. Throw a ValidationError to notify that the alteration cannot be successfully completed.
Optional options: OperationOptionsThe operation options.
The clone of the shape.
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.
The param that is passed to the operation when it is applied.
The callback that alters the shape output. Throw a ValidationError to notify that the alteration cannot be successfully completed.
The operation options.
The clone of the shape.
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.
The callback that alters the shape output. Throw a ValidationError to notify that the alteration cannot be successfully completed.
Optional options: OperationOptionsThe operation options.
The clone of the shape.
Adds annotations to the shape.
Annotations to add.
The clone of the shape with the updated annotations.
Returns a sub-shape that describes a value associated with the given property name, or null if there's no such
sub-shape.
The key for which the sub-shape must be retrieved.
The sub-shape or null if there's no such key in the shape.
Returns a shape that adds a brand to the output type.
The brand value.
A shape with the branded output type.
Returns undefined if parsing fails.
Returns the fallback value if parsing fails.
The fallback value.
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.
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.
The param that is passed to the operation when it is applied.
The callback that checks that a value satisfies a requirement and returns issues if it doesn't.
The operation options.
The clone of the shape.
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.
The callback that checks that a value satisfies a requirement and returns issues if it doesn't.
Optional options: OperationOptionsThe operation options.
The clone of the shape.
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.
The param that is passed to the operation when it is applied.
The callback that checks that a value satisfies a requirement and returns issues if it doesn't.
The operation options.
The clone of the shape.
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.
The callback that checks that a value satisfies a requirement and returns issues if it doesn't.
Optional options: OperationOptionsThe operation options.
The clone of the shape.
Enables an input value coercion.
The clone of the shape.
Synchronously converts the output value of the shape.
If you want to don't want to change the base type, consider using Shape.alter.
The value returned from the callback that converts the output value of this shape.
The callback that converts the input value. Throw a ValidationError to notify that the conversion cannot be successfully completed.
The shape output value.
Parsing options.
The ConvertShape instance.
Asynchronously converts the output value of the shape.
If you want to don't want to change the base type, consider using Shape.alterAsync.
The value returned from the callback that converts the output value of this shape.
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.
The shape output value.
Parsing options.
The ConvertShape instance.
Excludes value from both input and output.
The denied value.
The excluded value.
Optional options: IssueOptions | MessageThe issue options or the issue message.
Checks that the input doesn't match the shape.
The shape to which the output must not conform.
The shape to which the output must not conform.
Optional options: IssueOptions | MessageThe issue options or the issue message.
Prevents an input and output from being undefined.
Optional options: IssueOptions | MessageThe issue options or the issue message.
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.
The shape to which the output must not conform.
The shape to which the output must not conform.
Optional options: IssueOptions | MessageThe issue options or the issue message.
Replaces null input value with an null output value.
Replaces null input value with a default output value.
The value that is used as the replacement for null.
The value that should be used if an input value is null.
Passes null and undefined input values directly to the output without parsing.
Replaces null and undefined input value with a default output value.
The value that is used as the replacement for undefined and null.
Optional defaultValue: DefaultValueThe value that should be used if an input value is undefined or null.
Replaces undefined input value with an undefined output value.
Replaces undefined input value with a default output value.
The value that is used as the replacement for undefined.
The value that should be used if an input value is undefined.
Synchronously parses the value.
The value to parse.
Optional options: ParseOptionsParsing options.
The value that conforms the output type of the shape.
Error if the shape doesn't support the sync parsing, see Shape.isAsync.
ValidationError if any issues occur during parsing.
Asynchronously parses the value.
The value to parse.
Optional options: ParseOptionsParsing options.
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.
Synchronously parses the value and returns undefined if parsing fails.
The value to parse.
The value that conforms the output type of the shape.
Error if the shape doesn't support the sync parsing, see Shape.isAsync.
Synchronously parses the value and returns the default value if parsing fails.
The default value that is returned if parsing fails.
The value to parse.
The default value that is returned if parsing fails.
Optional options: ApplyOptionsParsing options.
The value that conforms the output type of the shape.
Error if the shape doesn't support the sync parsing, see Shape.isAsync.
Asynchronously parses the value and returns undefined value if parsing fails.
The value to parse.
The value that conforms the output type of the shape.
Asynchronously parses the value and returns the default value if parsing fails.
The default value that is returned if parsing fails.
The value to parse.
The default value that is returned if parsing fails.
Optional options: ApplyOptionsParsing options.
The value that conforms the output type of the shape.
Adds a synchronous operation that refines the shape output type with the narrowing predicate.
The narrowed output value.
The param that is passed to the operation when it is applied.
The predicate that returns true if the value conforms the required type, or false otherwise.
The operation options or the issue message.
The shape with the narrowed output.
Adds a synchronous operation that refines the shape output type with the narrowing predicate.
The narrowed output value.
The predicate that returns true if the value conforms the required type, or false otherwise.
Optional options: Message | RefineOptionsThe operation options or the issue message.
The shape with the narrowed output.
Adds a synchronous operation that checks that the output value conforms the predicate.
The param that is passed to the operation when it is applied.
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.
The clone of the shape.
Adds a synchronous operation that checks that the output value conforms the predicate.
The predicate that returns truthy result if the value is valid, or returns falsy result otherwise.
Optional options: Message | RefineOptionsThe operation options or the issue message.
The clone of the shape.
Adds an asynchronous operation that checks that the output value conforms the predicate.
The param that is passed to the operation when it is applied.
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.
The clone of the shape.
Adds an asynchronous operation that checks that the output value conforms the predicate.
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 | RefineOptionsThe operation options or the issue message.
The clone of the shape.
Replaces an input value with an output value.
The input value to replace.
The output value that is returned if an inputValue is received.
Returns an array shape that has rest elements constrained by the given shape.
Note: This method returns a shape without any operations.
The shape of rest elements.
The shape of rest elements, or null if there are no rest elements.
The new array shape.
Pipes the output of this shape to the input of another shape.
The output value.
The shape that validates the output if this shape.
The value to parse.
Optional options: ApplyOptionsParsing options.
The Ok instance if parsing has succeeded or Err if parsing has failed.
Error if the shape doesn't support the sync parsing, see Shape.isAsync.
The value to parse.
Optional options: ApplyOptionsParsing options.
The Ok instance if parsing has succeeded or Err if parsing has failed.
Requires an array to contain at least one element that conforms the given shape.
The shape of the required element or its literal value.
Optional options: IssueOptions | MessageThe issue options or the issue message.
The clone of the shape.
Constrains the array length.
The minimum array length.
Optional options: IssueOptions | MessageThe issue options or the issue message.
The clone of the shape.
Constrains the maximum array length.
The maximum array length.
Optional options: IssueOptions | MessageThe issue options or the issue message.
The clone of the shape.
Constrains the minimum array length.
The minimum array length.
Optional options: IssueOptions | MessageThe issue options or the issue message.
The clone of the shape.
Constrains the array length to be at least one element.
Optional options: IssueOptions | MessageThe issue options or the issue message.
The clone of the shape.
true if this shapes coerces input values to the required type during parsing, or false otherwise.
The shape of an array or a tuple value.
ArrayShape<[], null>[][]ArrayShape<[], Shape<A, B>>A[]B[]ArrayShape<[Shape<A, B>, Shape<X, Y>], null>[A, X][B, Y]ArrayShape<[Shape<A, B>], Shape<X, Y>>[A, ...X[]][B, ...Y[]]