validum
is a simple fluent validation library that allows you to validate anything by creating a chain of validations like this:
const user = {
name: 'Test McTestFace',
username: 'test',
age: 17,
}
const result = validation
.of(user)
.property('name')
.alphanumeric()
.maxLength(10)
.withMessage('Who has a name that long?')
.withCode('ERR-100')
.andProperty('age')
.greaterThanOrEqual(18)
.withMessage('Only adults allowed!')
.result()
This will return a result
object that contains different methods to retrieve the validation errors, the original input and some utility methods to combine different results. For example, calling errors()
on the previous result will return this array:
[
{
message: 'name must contain only alphanumeric characters',
code: undefined,
property: 'name',
},
{
message: 'Who has a name that long?',
code: 'ERR-100',
property: 'name',
},
{
message: 'Only adults allowed!',
code: undefined,
property: 'age',
},
]
Thanks to TypeScript every property name, even though they're strings, are type safe. For example, the following will yield an error:
const result = validation
.of(user)
.property('namee') // Error: Argument of type '"namee"' is not assignable to...
...
You can also combine different results to get one array with all the different validation errors instead of creating one big validation. For example:
const address = {
street: 'Fake Street',
number: -1,
}
const user = {
name: 'Test McTestFace',
username: 'test',
age: 17,
}
const result = validation
.of(user)
// ...(same as before)
.result()
const addressResult = validation
.of(address)
.property('street')
.minLength(5)
.andProperty('number')
.positive()
.result()
const combinedResult = result.combineWith(addressResult)
If we call errors()
on combinedResult
now it will return:
[
// ...(same as before)
{
message: 'number must be positive',
code: undefined,
property: 'number',
},
]
npm install validum
# or if you use yarn
yarn add validum
Head to the wiki page.
validum
uses yarn
as the default package manager, so for building the project it's recommended that you use the same; using npm
is still an option, though, but yarn
is recommended for a more predictable build. That being said:
git clone https://github.com/sleepyfran/validum.git
cd validum
yarn install
After building you can execute the tests by simply running yarn test
.
Yes! If you want a feature to be added, feel free to open an issue and we'll discuss the possibility there.
Take a look at the current issues or open your own so we can discuss how the implementation would go.