Composable message-based validation
$ npm install not-valid --save
import{validate}from"not-valid";// Use createValidator to specify a rule and the message given for breaking that ruleconstmustContainA=createValidator<string>(v=>v.indexOf("A")!==-1,"Value must contain the letter 'a'");// pass in array of validation functions and a value to validatevalidate([mustContainA],"cheese");// [ "Value must contain the letter 'a'" ] - returns error messages// can use a factory pattern for your validation methods to make things niceconstmustContain=(requirement: any)=>{returncreateValidator<string|Array<any>>(v=>v.indexOf(requirement)!==-1,`Value must contain '${requirement}'`);};constlengthWithinBounds=(min: number,max: number)=>{returncreateValidator<string>(v=>v.length<min||v.length>max,`Value must have length between ${min} and ${max}`);};// you can pass in multiple validatorsvalidate([mustContain("Z"),lengthWithinBounds(2,6)],"Too long a string, they say!");// [ "Value must contain 'Z'", "Value must have length between 2 and 6" ]A number of validation functions come bundled with this package. You can use them like so:
import{validators}from"not-valid";validate([validators.validLength({min: 6,max: 12})],"Good value");The validators included are as follows:
requiredStringrequiredNumbervalidLengthvalidEmailvalidAlphaNumericvalidOptionvalidPhoneNumbervalidNINumbervalidUKDrivingLicencevalidSortCodevalidBankAccountNumbervalidVATNumber
A validation function must take in a value value, and return Result.Pass if value is valid, or Result.Fail(message) is value is invalid. They can also return Result.Stop, which will silently stop the validation cycle (no more errors).
This can be done with the helper method createValidator in not-valid:
import{createValidator}from"not-valid";constmustContainA=createValidator<string>(v=>v.indexOf("A")!==-1,"Value must contain the letter 'a'");You can use factory patterns around this to make it nicer:
constmustContain=(requirement: any)=>{returncreateValidator<string|Array<any>>(v=>v.indexOf(requirement)!==-1,`Value must contain '${requirement}'`);};All validators (except for validators that explicitly check for "required") should treat empty string, null and undefined as valid. This is because we can combine validators with "required" validators in order to enforce something being valid and not empty, but also allows us to accept nothing being entered if desired.
The third parameter of validate is an object containing options.
interfaceValidationOptions{sequential?: boolean;}Default: true
The validation will break on the first error, therefore only returning a single validation error.
validate([something,another],5,{sequential: false});If something fails validation, another will not be called.
Made with 💖 by NewOrbit in Oxfordshire, and licensed under the MIT Licence