jski - json schema validator

JSON Schema support

jski validates a subset of json schema v4. Following features are missing or restricted:

no union types
array: additionalItems can only be true or false, not a schema
object: additionalProperties can only be true or false
object: no patternProperties
object: no dependencies
$ref: definitions are solely looked up by name in options.definitions or jski.object({...}).defintions({...})
not: not supported

Installation

npm install jski

Usage

var J = require('jski')();

Examples

Create schema using method chaining

var J = require('jski')();

var validator = J.object({
  foo: J.number(),
  bar: J.string().maxLength(255)
});

var errs = validator.validate({ foo: 11, bar: 'hello' });

Create validator from json

var J = require('jski')();

var js = {
  foo: { type: 'number' },
  bar: { type: 'string', maxLength: 255 }
};

var validator = J.createValidator(js);

var errs = validator.validate({ foo: true, bar: 'hello' });

Get schema in json form

var J = require('jski')();

var json = J.object({ foo: J.string() }).toJSON();

API

Building schemas with method chaining

Types

J.boolean()
J.number().minimum(1).maximum(10).multipleOf()
J.integer() - Same as number
J.string().minLength(1).maxLength(10).pattern('[0-9]*').format('email')
J.array(J.number()).minItems(1).maxItems(10).uniqueItems(true).additionalItems(false)
J.array(J.number(), J.string(), J.boolean())
J.object({ foo: J.number() }).minProperties(1).maxProperties(10).required('foo', 'bar').additionalProperties(false)
J.enum(1, 2, 3)
J.any()
J.null()
J.allOf(schema1, schema2, schema3)
J.anyOf(schema1, schema2, schema3)
J.oneOf(schema1, schema2, schema3)

Common methods available to all types

J.number().title('foo').description('bar').default(11)

Validation

validate(value, options) returns an error array. When the value is valid, the array is empty.

var errors = J.number().maximum(127).validate(128)

Definitions

Add Defintions:

by method: J.object({...}).definitions({...})
by options: var errors = J.object({...}).validate({...}, { definitions: {...} })

Serializing schemas from/to JSON

J.createValidator(Schema JSON)
J.object({ foo: j.string() }).toJSON()

Create a default value for a schema

J.createValue(J.number())
J.createValue({ type: 'number' })

Options

J.object().validate(value, { definitions: defs, omitRefs: true })

definitions - Dict where $refs are lookuped by name
omitRefs - Do not validate $refs

Add mixins for validators

Simple way to reuse definitions without using an actual $ref

var validator = J
  .mixin('foo', J.object({ bar: J.string() }))
  .mixin('bar', J.object({ baz: J.number() }))
  .object({
    un: J.foo(),
    dos: J.bar()
  });

Validator context

var J = require('jski)();
var v1 = J.object({ foo: J.string() });
assert(v1.context === J);

Errors

Error messages look like:

{ message: "Value is too long", code: "maxLength", path: "foo.bar[0].baz" }

tillre / jski