notLength

Creates a pipeline validation action that validates the length of a string or array.

const Validation = notLength<TInput, TRequirement>(requirement, message);

Generics

• TInput extends string | any[]
• TRequirement extends number

Parameters

• requirement TRequirement
• message ErrorMessage | undefined

Explanation

With notLength you can validate the length of a string or array. If the input does not match the requirement, you can use message to customize the error message.

Returns

• Validation NotLengthValidation<TInput, TRequirement>

Examples

The following examples show how notLength can be used.

String schema

Schema to validate the length of a string.

const StringSchema = string([
  notLength(8, 'The string must not be 8 characters long.'),
]);

Array schema

Schema to validate the length of an array.

const ArraySchema = array(number(), [
  notLength(10, 'The array must not contain 10 numbers.'),
]);

Related

The following APIs can be combined with notLength.

Schemas

• any,
• array,
• instance,
• special,
• string,
• tuple,
• unknown