@De-Formed Validations offers a robust and unopinionated API to customize form and data validations. With only a handful of properties to learn, @de-formed maintains its own internal state with simple function calls so that you can design your architecture the way you want to.
- Modular, Composable, and Scalable
- Unopinionated and Customizable to the Moon 🚀
- Lightweight and Fast
- Easy to Use, Easy to Test
yarn add @de-formed/node-validations
npm i @de-formed/node-validations
Validation Schemas are created by defining an object with keys that hold an array of validation rules. Each validation rule consists of the error message to provide if the rule fails, and a function that returns true or false.
// PersonValidation.js
import { Validation } from '@de-formed/node-validations';
export const PersonValidation = () => {
return Validation({
firstName: [
{
error: 'First Name is required.',
validation: ({ firstName }) => firstName.length > 0,
},
{
error: 'First Name cannot be longer than 20 characters.',
validation: ({ firstName }) => firstName.length <= 20,
},
],
lastName: [
{
error: 'Last Name is required.',
validation: ({ lastName }) => lastName.length > 0,
},
{
error: 'Last Name cannot be longer than 20 characters.',
validation: ({ lastName }) => lastName.length <= 20,
},
{
error: 'Must be Ross if fist name is Bob.',
validation: ({ firstName, lastName }) => {
return firstName === 'Bob' ? lastName === 'Ross' : true;
},
},
],
});
};import { PersonValidation } from './PersonValidation';
import { Request, Response } from 'express';
const v = PersonValidation();
app.post('/person', (req: Request, res: Response) =>
v.validateAll(req.body) ? res.status(201) : res.json(v.validationState),
);Visit the wiki to get a step by step walkthrough of how to customize De-Formed to the moon 🚀
API documentation.
More examples and CodeSandboxes.
This project is licensed under the terms of the MIT license.