A schema validation and filtering framework
npm install conformA schema validation and filtering framework for node.js
It's a fork of revalidator which
extends him with ability to modify source object - apply default values, casts,
filters to source objects (see castSource, applyDefaultValue at
options, filter section) and other
features such as additionalProperties option.
Currently conform with default options fully backward compatible with
revalidator 0.1.5 (except browsers support which should be ok but don't well
tested cause no convenient way to do that with vows testing framework which
is currently used).
conform is simple and succinct: conform.validate(obj, schema): js
var conform = require('conform');
console.dir(conform.validate(someObject, {
properties: {
url: {
description: 'the url the object should be stored at',
type: 'string',
pattern: '^/[^#%&*{}\\:<>?\/+]+$',
required: true
},
challenge: {
description: 'a means of protecting data (insufficient for production, used as example)',
type: 'string',
minLength: 5
},
body: {
description: 'what to store at the url',
type: 'any',
default: null
}
}
}));
`This will return with a value indicating if the
conforms to the schema. If it does not, a descriptive object will be returned containing the errors encountered with validation.` js
{
valid: true // or false
errors: [/ Array of errors if valid is false /]
}
`Installation
$3
bash
$ npm install conform
`Usage
takes json-schema as input to validate objects.$3
This will return with a value indicating if the
obj conforms to the schema. If it does not, a descriptive object will be returned containing the errors encountered with validation.` js
{
valid: true // or false
errors: [/ Array of errors if valid is false /]
}
`#### Available Options
* __validateFormats__: Enforce format constraints (_default true_)
* __validateFormatsStrict__: When
is _true_ treat unrecognized formats as validation errors (_default false_)
* __validateFormatExtensions__: When validateFormats is _true_ also validate formats defined in validate.formatExtensions (_default true_)
* __cast__: Enforce casting of some types (for integers/numbers are only supported) when it's possible, e.g. "42" => 42, but "forty2" => "forty2" for the integer type (_default false_)
* __castSource__: Apply casting (see cast option above) to source object (_default false_)
* __additionalProperties__: Default value for object additionalProperties attribute (_default true_)
* __applyDefaultValue__: Apply value of default attribute to source object (_default false_)
* __validateDefaultValue__: If true value of default attribute will be checked to conforms schema (_default false_)
* __exitOnFirstError__: If true validation will be stopped after first error occurred, valid will be false and errors will contain single error (_default false_)
* __failOnFirstError__: Like exitOnFirstError option but error will be thrown, property info of error will contain regular validation error information (_default false_)Notice: all options (such as castSource, additionalProperties) as well as
attributes (such as filter) which modifies source object
do that directly and immediately. That means that if some property (e.g.
property1)
was modified but later, on other property (e.g. property2), validation or
filtering fails source object will be with modified property1 despite on valid
equals to at result.
$3
For a property an value is that which is given as input for validation where as an expected value is the value of the below fields#### required
If true, the value should not be empty
`js
{ required: true }
`#### type
The
should be equal to the expected value`js
{ type: 'string' }
{ type: 'number' }
{ type: 'integer' }
{ type: 'array' }
{ type: 'boolean' }
{ type: 'object' }
{ type: 'null' }
{ type: 'date' }
{ type: 'any' }
{ type: ['boolean', 'string'] }
`#### pattern
The expected value regex needs to be satisfied by the value
js
{ pattern: /^[a-z]+$/ }
`#### maxLength
The length of value must be greater than or equal to expected value
js
{ maxLength: 8 }
`#### minLength
The length of value must be lesser than or equal to expected value
js
{ minLength: 8 }
`#### minimum
Value must be greater than or equal to the expected value
js
{ minimum: 10 }
`#### maximum
Value must be lesser than or equal to the expected value
js
{ maximum: 10 }
`#### exclusiveMinimum
Value must be greater than expected value
js
{ exclusiveMinimum: 9 }
`$3
Value must be lesser than expected valuejs
{ exclusiveMaximum: 11 }
`#### divisibleBy
Value must be divisible by expected value
js
{ divisibleBy: 5 }
{ divisibleBy: 0.5 }
`#### minItems
Value must contain more then expected value number of items
js
{ minItems: 2 }
`#### maxItems
Value must contains less then expected value number of items
js
{ maxItems: 5 }
`#### uniqueItems
Value must hold a unique set of values
js
{ uniqueItems: true }
`#### enum
Value must be present in the array of expected value
js
{ enum: ['month', 'year'] }
`#### format
Value must be a valid format
js
{ format: 'url' }
{ format: 'email' }
{ format: 'ip-address' }
{ format: 'ipv6' }
{ format: 'date-time' }
{ format: 'date' }
{ format: 'time' }
{ format: 'color' }
{ format: 'host-name' }
{ format: 'utc-millisec' }
{ format: 'regex' }
`#### conform
Value must conform to constraint denoted by expected value
js
{ conform: function (val, obj, prop) {
// obj - current object at validation, prop - property name
return val % 3 == 1;
}
}
`#### dependencies
Value is valid only if the dependent value is valid
js
{
town: { required: true, dependencies: 'country' },
country: { maxLength: 3, required: true }
}
`#### filter
Apply filter on
js
{
filter: function (v) {
return v.toLowerCase();
}
}
` attribute can be array of filters.
Filter applies only after successful validation of value.
Filter errors as validation errors sets valid to false and provides error
description at errors array.
Complex types (array, object) can't be filtered directly, use filter for
array items or object properties instead.$3
We also allow nested schema`js
{
properties: {
title: {
type: 'string',
maxLength: 140,
required: true
},
author: {
type: 'object',
required: true,
properties: {
name: {
type: 'string',
required: true
},
email: {
type: 'string',
format: 'email'
}
}
}
}
}
`$3
We also allow custom message for different constraintsjs
{
type: 'string',
format: 'url'
messages: {
type: 'Not a string type',
format: 'Expected format is a url'
}
`js
{
conform: function () { ... },
message: 'This can be used as a global message'
}
`Tests
Clone repository from github, into cloned dir and install dev dependencies` bash
$ npm install
`run tests
bash
$ npm test
``#### conform.js author: Oleg Korobenko
#### revalidator authors: Charlie Robbins, Alexis Sellier
#### revalidator contributors: Fedor Indutny, Bradley Meck, Laurie Harper
#### License: Apache 2.0