A[JSONSchema](http://json-schema.org/) validator that uses code generation

to be extremely fast

A[JSONSchema](https://json-schema.org/) validator that uses code generation to be extremely fast.

It passes the entire JSONSchema v4 test suite except for`remoteRefs` and`maxLength`/`minLength` when using unicode surrogate pairs.

[](http://travis-ci.org/mafintosh/is-my-json-valid)

[](https://travis-ci.org/mafintosh/is-my-json-valid)

npm install --save is-my-json-valid

Simply pass a schema to compile it

var validator=require('is-my-json-valid')

var validate=validator({

You can also pass the schema as a string

var validate=validator('{"type": ... }')

Optionally you can use the require submodule to load a schema from`__dirname`

var validator=require('is-my-json-valid/require')

var validate=validator('my-schema.json')

is-my-json-valid supports the formats specified in JSON schema v4 (such as date-time).

If you want to add your own custom formats pass them as the formats options to the validator

var validate=validator({

type:'string',

required:true,

You can pass in external schemas that you reference using the`$ref` attribute as the`schemas` option

var ext= {

required:true,

type:'string'

is-my-json-valid supports filtering away properties not in the schema

var filter=validator.filter({

required:true,

type:'object',

-`value`: The data value that caused the error

-`schemaPath`: an array of keys indicating which sub-schema failed

var schema= {

required:true,

type:'object',

Many popular libraries make it easy to retrieve the failing rule with the`schemaPath`:

var schemaPath=validate.errors[0].schemaPath

varR=require('ramda')

By default is-my-json-valid bails on first validation error but when greedy is

set to true it tries to validate as much as possible:

var validate=validator({

type:'object',

properties: {

Here is a list of possible`message` values for errors:

*`must be FORMAT format` (FORMAT is the`format` property from the schema)

-`must be FORMAT format` (FORMAT is the`format` property from the schema)

is-my-json-valid uses code generation to turn your JSON schema into basic javascript code that is easily optimizeable by v8.

At the time of writing, is-my-json-valid is the__fastest validator__ when running

At the time of writing, is-my-json-valid is the**fastest validator** when running

*[json-schema-benchmark](https://github.com/Muscula/json-schema-benchmark)

*[cosmicreals.com benchmark](http://cosmicrealms.com/blog/2014/08/29/benchmark-of-node-dot-js-json-validation-modules-part-3/)

*[jsck benchmark](https://github.com/pandastrike/jsck/issues/72#issuecomment-70992684)

*[themis benchmark](https://cdn.rawgit.com/playlyfe/themis/master/benchmark/results.html)

*[z-schema benchmark](https://rawgit.com/zaggino/z-schema/master/benchmark/results.html)

-[json-schema-benchmark](https://github.com/Muscula/json-schema-benchmark)

-[cosmicreals.com benchmark](http://cosmicrealms.com/blog/2014/08/29/benchmark-of-node-dot-js-json-validation-modules-part-3/)

-[jsck benchmark](https://github.com/pandastrike/jsck/issues/72#issuecomment-70992684)

-[themis benchmark](https://cdn.rawgit.com/playlyfe/themis/master/benchmark/results.html)

-[z-schema benchmark](https://rawgit.com/zaggino/z-schema/master/benchmark/results.html)

If you know any other relevant benchmarks open a PR and I'll add them.

{

"name":"is-my-json-valid",

"version":"2.19.0",

"description":"A JSONSchema validator that uses code generation to be extremely fast",

"main":"index.js",

"license":"MIT",

"repository":"mafintosh/is-my-json-valid",

"files": [

"formats.js",

"index.d.ts",

"index.js",

],

"scripts": {

"test":"tape test/*.js && tsc"

},

"dependencies": {

"generate-function":"^2.0.0",

"generate-object-property":"^1.1.0",

"tape":"^2.13.4",

"typescript":"^3.0.1"

},

"scripts": {

"test":"tape test/*.js && tsc"

},

"repository": {

"type":"git",

"url":"https://github.com/mafintosh/is-my-json-valid"

},

"keywords": [

"json",

"schema",

"orderly",

],

"author":"Mathias Buus",

"license":"MIT",

"bugs": {

"url":"https://github.com/mafintosh/is-my-json-valid/issues"

},

"homepage":"https://github.com/mafintosh/is-my-json-valid"

]

}