joi-assert
Assert values using Joi schemas
Use Spumko's Joi in assertion statements that validate and sanitize values.
Assertions throw an AssertionError with a compact, readable message if validation fails. This makes Joi schemas usable in assertions for use with frameworks like mocha.
If validation succeeds the sanitized value returned, via Joi's support for default values and unknown property stripping etc. This makes Joi schemas usable as input-assertions in the methods of user facing methods of your modules and APIs.
Usage
Get it from npm:
$ npm install joi
$ npm install joi-assertBasic assertion
// import plain Joi
var Joi = require('joi');
// import the module
var joiAssert = require('joi-assert');
// get a Joi schema
var schema = Joi.string().min(5);
// validate data and throw AssertionError on failure
joiAssert(raw, schema);
// assertion returns valid data as oneliner
var valid = joiAssert(raw, schema);Error message
// add schema description to error message
var schema = Joi.string().min(5).description('lower bound');
// additonal message per call
input = joiAssert(imput, schema, 'input check');Validate and sanitize input
// get a schema using default(), .stripUnknown etc
var schema = Joi.object({
foo: Joi.string().required(),
bar: Joi.string().optional().default('hoge')
}).object({
stripUnknown: true
});
// get valid but dirty input data
var raw = {
foo: 'abc',
nope: null
}
// pass through assertion
var data = joiAssert(raw, schema);
// data is now clean
{
foo: 'abc',
bar: 'hoge'
}Bake assertion function
// get a schema
var schema = Joi.string().min(5).max(10);
// get assertion closure
var fiveTen = joiAssert.bake(schema, 'five to ten');
// nice
fiveTen(10);
fiveTen(5);
// clean
input = fiveTen(input);
// kablam!
fiveTen(20);
// get fancy
var clean = [5, 6, 7, 8].map(fiveTen);Todo
- Improve vars argument
- Support argument as Object, Array and String
- Consider sprintf style smart args (order etc)
- Test it
- Add options to customise error message:
- Amount of concatenated reports
- Multiline message
Build
Install development dependencies:
$ npm install
$ npm install -g grunt-cliBuild and run tests using grunt:
$ grunt testSee the Gruntfile.js for additional commands.
Contributions
Pull requests with fixes are very welcome, for new features best ask via a issue first.
License
Copyright (c) 2014 Bart van der Schoor
Licensed under the MIT license.
