version: {{ releaseVersion }}
+{{ 'APP.ABOUT.VERSION' | translate }} {{ releaseVersion }}
version: {{ repository.edition }} {{ repository.version.display }}
+
+
+
+ {{ 'APP.ABOUT.PLUGINS.ID' | translate }}
+
+ {{ element.$id }}
+
+
+
+ {{
+ 'APP.ABOUT.PLUGINS.NAME' | translate
+ }}
+ {{ element.$name }}
+
+
+
+ {{
+ 'APP.ABOUT.PLUGINS.VERSION' | translate
+ }}
+ {{
+ element.$version
+ }}
+
+
+
+ {{
+ 'APP.ABOUT.PLUGINS.VENDOR' | translate
+ }}
+ {{
+ element.$vendor
+ }}
+
+
+
+ {{
+ 'APP.ABOUT.PLUGINS.LICENSE' | translate
+ }}
+ {{
+ element.$license
+ }}
+
+
+
+ {{
+ 'APP.ABOUT.PLUGINS.RUNTIME' | translate
+ }}
+ {{
+ element.$runtime
+ }}
+
+
+
+ {{
+ 'APP.ABOUT.PLUGINS.DESCRIPTION' | translate
+ }}
+ {{
+ element.$description
+ }}
+
+
+
+
+ {{ 'APP.ABOUT.VERSION' | translate }} {{ repository.edition }} + {{ repository.version.display }} +
+![\"parse5\"](\"https://raw.github.com/inikulin/parse5/master/media/logo.png\"){kind=logo}
\n ![](\"https://user-images.githubusercontent.com/71256/29091486-fa38524c-7c37-11e7-895f-e7ec8e1039b6.png\")
\n\nA tiny JavaScript debugging utility modelled after Node.js core's debugging\ntechnique. Works in Node.js and web browsers.\n\n## Installation\n\n```bash\n$ npm install debug\n```\n\n## Usage\n\n`debug` exposes a function; simply pass this function the name of your module, and it will return a decorated version of `console.error` for you to pass debug statements to. This will allow you to toggle the debug output for different parts of your module as well as the module as a whole.\n\nExample [_app.js_](./examples/node/app.js):\n\n```js\nvar debug = require('debug')('http')\n , http = require('http')\n , name = 'My App';\n\n// fake app\n\ndebug('booting %o', name);\n\nhttp.createServer(function(req, res){\n debug(req.method + ' ' + req.url);\n res.end('hello\\n');\n}).listen(3000, function(){\n debug('listening');\n});\n\n// fake worker of some kind\n\nrequire('./worker');\n```\n\nExample [_worker.js_](./examples/node/worker.js):\n\n```js\nvar a = require('debug')('worker:a')\n , b = require('debug')('worker:b');\n\nfunction work() {\n a('doing lots of uninteresting work');\n setTimeout(work, Math.random() * 1000);\n}\n\nwork();\n\nfunction workb() {\n b('doing some work');\n setTimeout(workb, Math.random() * 2000);\n}\n\nworkb();\n```\n\nThe `DEBUG` environment variable is then used to enable these based on space or\ncomma-delimited names.\n\nHere are some examples:\n\n![\"screen](\"https://user-images.githubusercontent.com/71256/29091703-a6302cdc-7c38-11e7-8304-7c0b3bc600cd.png\")
\n![\"screen](\"https://user-images.githubusercontent.com/71256/29091700-a62a6888-7c38-11e7-800b-db911291ca2b.png\")
\n![\"screen](\"https://user-images.githubusercontent.com/71256/29091701-a62ea114-7c38-11e7-826a-2692bedca740.png\")
\n\n#### Windows note\n\nOn Windows the environment variable is set using the `set` command.\n\n```cmd\nset DEBUG=*,-not_this\n```\n\nNote that PowerShell uses different syntax to set environment variables.\n\n```cmd\n$env:DEBUG = \"*,-not_this\"\n```\n\nThen, run the program to be debugged as usual.\n\n\n## Namespace Colors\n\nEvery debug instance has a color generated for it based on its namespace name.\nThis helps when visually parsing the debug output to identify which debug instance\na debug line belongs to.\n\n#### Node.js\n\nIn Node.js, colors are enabled when stderr is a TTY. You also _should_ install\nthe [`supports-color`](https://npmjs.org/supports-color) module alongside debug,\notherwise debug will only use a small handful of basic colors.\n\n![](\"https://user-images.githubusercontent.com/71256/29092181-47f6a9e6-7c3a-11e7-9a14-1928d8a711cd.png\")
\n\n#### Web Browser\n\nColors are also enabled on \"Web Inspectors\" that understand the `%c` formatting\noption. These are WebKit web inspectors, Firefox ([since version\n31](https://hacks.mozilla.org/2014/05/editable-box-model-multiple-selection-sublime-text-keys-much-more-firefox-developer-tools-episode-31/))\nand the Firebug plugin for Firefox (any version).\n\n![](\"https://user-images.githubusercontent.com/71256/29092033-b65f9f2e-7c39-11e7-8e32-f6f0d8e865c1.png\")
\n\n\n## Millisecond diff\n\nWhen actively developing an application it can be useful to see when the time spent between one `debug()` call and the next. Suppose for example you invoke `debug()` before requesting a resource, and after as well, the \"+NNNms\" will show you how much time was spent between calls.\n\n![](\"https://user-images.githubusercontent.com/71256/29091956-6bd78372-7c39-11e7-8c55-c948396d6edd.png\")
\n\n\n## Conventions\n\nIf you're using this in one or more of your libraries, you _should_ use the name of your library so that developers may toggle debugging as desired without guessing names. If you have more than one debuggers you _should_ prefix them with your library name and use \":\" to separate features. For example \"bodyParser\" from Connect would then be \"connect:bodyParser\". If you append a \"*\" to the end of your name, it will always be enabled regardless of the setting of the DEBUG environment variable. You can then use it for normal output as well as debug output.\n\n## Wildcards\n\nThe `*` character may be used as a wildcard. Suppose for example your library has\ndebuggers named \"connect:bodyParser\", \"connect:compress\", \"connect:session\",\ninstead of listing all three with\n`DEBUG=connect:bodyParser,connect:compress,connect:session`, you may simply do\n`DEBUG=connect:*`, or to run everything using this module simply use `DEBUG=*`.\n\nYou can also exclude specific debuggers by prefixing them with a \"-\" character.\nFor example, `DEBUG=*,-connect:*` would include all debuggers except those\nstarting with \"connect:\".\n\n## Environment Variables\n\nWhen running through Node.js, you can set a few environment variables that will\nchange the behavior of the debug logging:\n\n| Name | Purpose |\n|-----------|-------------------------------------------------|\n| `DEBUG` | Enables/disables specific debugging namespaces. |\n| `DEBUG_HIDE_DATE` | Hide date from debug output (non-TTY). |\n| `DEBUG_COLORS`| Whether or not to use colors in the debug output. |\n| `DEBUG_DEPTH` | Object inspection depth. |\n| `DEBUG_SHOW_HIDDEN` | Shows hidden properties on inspected objects. |\n\n\n__Note:__ The environment variables beginning with `DEBUG_` end up being\nconverted into an Options object that gets used with `%o`/`%O` formatters.\nSee the Node.js documentation for\n[`util.inspect()`](https://nodejs.org/api/util.html#util_util_inspect_object_options)\nfor the complete list.\n\n## Formatters\n\nDebug uses [printf-style](https://wikipedia.org/wiki/Printf_format_string) formatting.\nBelow are the officially supported formatters:\n\n| Formatter | Representation |\n|-----------|----------------|\n| `%O` | Pretty-print an Object on multiple lines. |\n| `%o` | Pretty-print an Object all on a single line. |\n| `%s` | String. |\n| `%d` | Number (both integer and float). |\n| `%j` | JSON. Replaced with the string '[Circular]' if the argument contains circular references. |\n| `%%` | Single percent sign ('%'). This does not consume an argument. |\n\n\n### Custom formatters\n\nYou can add custom formatters by extending the `debug.formatters` object.\nFor example, if you wanted to add support for rendering a Buffer as hex with\n`%h`, you could do something like:\n\n```js\nconst createDebug = require('debug')\ncreateDebug.formatters.h = (v) => {\n return v.toString('hex')\n}\n\n// …elsewhere\nconst debug = createDebug('foo')\ndebug('this is hex: %h', new Buffer('hello world'))\n// foo this is hex: 68656c6c6f20776f726c6421 +0ms\n```\n\n\n## Browser Support\n\nYou can build a browser-ready script using [browserify](https://github.com/substack/node-browserify),\nor just use the [browserify-as-a-service](https://wzrd.in/) [build](https://wzrd.in/standalone/debug@latest),\nif you don't want to build it yourself.\n\nDebug's enable state is currently persisted by `localStorage`.\nConsider the situation shown below where you have `worker:a` and `worker:b`,\nand wish to debug both. You can enable this using `localStorage.debug`:\n\n```js\nlocalStorage.debug = 'worker:*'\n```\n\nAnd then refresh the page.\n\n```js\na = debug('worker:a');\nb = debug('worker:b');\n\nsetInterval(function(){\n a('doing some work');\n}, 1000);\n\nsetInterval(function(){\n b('doing some work');\n}, 1200);\n```\n\n\n## Output streams\n\n By default `debug` will log to stderr, however this can be configured per-namespace by overriding the `log` method:\n\nExample [_stdout.js_](./examples/node/stdout.js):\n\n```js\nvar debug = require('debug');\nvar error = debug('app:error');\n\n// by default stderr is used\nerror('goes to stderr!');\n\nvar log = debug('app:log');\n// set this namespace to log via console.log\nlog.log = console.log.bind(console); // don't forget to bind to console!\nlog('goes to stdout');\nerror('still goes to stderr!');\n\n// set all output to go via console.info\n// overrides all per-namespace log settings\ndebug.log = console.info.bind(console);\nerror('now goes to stdout via console.info');\nlog('still goes to stdout, but via console.info now');\n```\n\n## Checking whether a debug target is enabled\n\nAfter you've created a debug instance, you can determine whether or not it is\nenabled by checking the `enabled` property:\n\n```javascript\nconst debug = require('debug')('http');\n\nif (debug.enabled) {\n // do stuff...\n}\n```\n\nYou can also manually toggle this property to force the debug instance to be\nenabled or disabled.\n\n\n## Authors\n\n - TJ Holowaychuk\n - Nathan Rajlich\n - Andrew Rhyne\n\n## Backers\n\nSupport us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/debug#backer)]\n\n![](\"https://opencollective.com/debug/backer/0/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/1/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/2/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/3/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/4/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/5/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/6/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/7/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/8/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/9/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/10/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/11/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/12/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/13/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/14/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/15/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/16/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/17/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/18/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/19/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/20/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/21/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/22/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/23/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/24/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/25/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/26/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/27/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/28/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/backer/29/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/0/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/1/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/2/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/3/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/4/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/5/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/6/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/7/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/8/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/9/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/10/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/11/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/12/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/13/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/14/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/15/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/16/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/17/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/18/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/19/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/20/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/21/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/22/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/23/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/24/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/25/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/26/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/27/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/28/avatar.svg\"){kind=avatar}
![](\"https://opencollective.com/debug/sponsor/29/avatar.svg\"){kind=avatar}
\n 
\n 
\n 
\n ![alfresco](assets/alfresco.png "\\"alfresco\\"")
\n![\"Ajv](\"http://epoberezkin.github.io/ajv/images/ajv_logo.png\"){kind=logo}
\n\n# Ajv: Another JSON Schema Validator\n\nThe fastest JSON Schema validator for Node.js and browser. Supports draft-04/06/07.\n\n\n[](https://travis-ci.org/epoberezkin/ajv)\n[](https://www.npmjs.com/package/ajv)\n[](https://www.npmjs.com/package/ajv)\n[](https://coveralls.io/github/epoberezkin/ajv?branch=master)\n[](https://greenkeeper.io/)\n[](https://gitter.im/ajv-validator/ajv)\n\n\n## Using version 6\n\n[JSON Schema draft-07](http://json-schema.org/latest/json-schema-validation.html) is published.\n\n[Ajv version 6.0.0](https://github.com/epoberezkin/ajv/releases/tag/v6.0.0) that supports draft-07 is released. It may require either migrating your schemas or updating your code (to continue using draft-04 and v5 schemas, draft-06 schemas will be supported without changes).\n\n__Please note__: To use Ajv with draft-06 schemas you need to explicitly add the meta-schema to the validator instance:\n\n```javascript\najv.addMetaSchema(require('ajv/lib/refs/json-schema-draft-06.json'));\n```\n\nTo use Ajv with draft-04 schemas in addition to explicitly adding meta-schema you also need to use option schemaId:\n\n```javascript\nvar ajv = new Ajv({schemaId: 'id'});\n// If you want to use both draft-04 and draft-06/07 schemas:\n// var ajv = new Ajv({schemaId: 'auto'});\najv.addMetaSchema(require('ajv/lib/refs/json-schema-draft-04.json'));\n```\n\n\n## Contents\n\n- [Performance](#performance)\n- [Features](#features)\n- [Getting started](#getting-started)\n- [Frequently Asked Questions](https://github.com/epoberezkin/ajv/blob/master/FAQ.md)\n- [Using in browser](#using-in-browser)\n- [Command line interface](#command-line-interface)\n- Validation\n - [Keywords](#validation-keywords)\n - [Annotation keywords](#annotation-keywords)\n - [Formats](#formats)\n - [Combining schemas with $ref](#ref)\n - [$data reference](#data-reference)\n - NEW: [$merge and $patch keywords](#merge-and-patch-keywords)\n - [Defining custom keywords](#defining-custom-keywords)\n - [Asynchronous schema compilation](#asynchronous-schema-compilation)\n - [Asynchronous validation](#asynchronous-validation)\n- Modifying data during validation\n - [Filtering data](#filtering-data)\n - [Assigning defaults](#assigning-defaults)\n - [Coercing data types](#coercing-data-types)\n- API\n - [Methods](#api)\n - [Options](#options)\n - [Validation errors](#validation-errors)\n- [Plugins](#plugins)\n- [Related packages](#related-packages)\n- [Packages using Ajv](#some-packages-using-ajv)\n- [Tests, Contributing, History, License](#tests)\n\n\n## Performance\n\nAjv generates code using [doT templates](https://github.com/olado/doT) to turn JSON Schemas into super-fast validation functions that are efficient for v8 optimization.\n\nCurrently Ajv is the fastest and the most standard compliant validator according to these benchmarks:\n\n- [json-schema-benchmark](https://github.com/ebdrup/json-schema-benchmark) - 50% faster than the second place\n- [jsck benchmark](https://github.com/pandastrike/jsck#benchmarks) - 20-190% faster\n- [z-schema benchmark](https://rawgit.com/zaggino/z-schema/master/benchmark/results.html)\n- [themis benchmark](https://cdn.rawgit.com/playlyfe/themis/master/benchmark/results.html)\n\n\nPerformance of different validators by [json-schema-benchmark](https://github.com/ebdrup/json-schema-benchmark):\n\n[](https://github.com/ebdrup/json-schema-benchmark/blob/master/README.md#performance)\n\n\n## Features\n\n- Ajv implements full JSON Schema [draft-06/07](http://json-schema.org/) and draft-04 standards:\n - all validation keywords (see [JSON Schema validation keywords](https://github.com/epoberezkin/ajv/blob/master/KEYWORDS.md))\n - full support of remote refs (remote schemas have to be added with `addSchema` or compiled to be available)\n - support of circular references between schemas\n - correct string lengths for strings with unicode pairs (can be turned off)\n - [formats](#formats) defined by JSON Schema draft-07 standard and custom formats (can be turned off)\n - [validates schemas against meta-schema](#api-validateschema)\n- supports [browsers](#using-in-browser) and Node.js 0.10-8.x\n- [asynchronous loading](#asynchronous-schema-compilation) of referenced schemas during compilation\n- \"All errors\" validation mode with [option allErrors](#options)\n- [error messages with parameters](#validation-errors) describing error reasons to allow creating custom error messages\n- i18n error messages support with [ajv-i18n](https://github.com/epoberezkin/ajv-i18n) package\n- [filtering data](#filtering-data) from additional properties\n- [assigning defaults](#assigning-defaults) to missing properties and items\n- [coercing data](#coercing-data-types) to the types specified in `type` keywords\n- [custom keywords](#defining-custom-keywords)\n- draft-06/07 keywords `const`, `contains`, `propertyNames` and `if/then/else`\n- draft-06 boolean schemas (`true`/`false` as a schema to always pass/fail).\n- keywords `switch`, `patternRequired`, `formatMaximum` / `formatMinimum` and `formatExclusiveMaximum` / `formatExclusiveMinimum` from [JSON Schema extension proposals](https://github.com/json-schema/json-schema/wiki/v5-Proposals) with [ajv-keywords](https://github.com/epoberezkin/ajv-keywords) package\n- [$data reference](#data-reference) to use values from the validated data as values for the schema keywords\n- [asynchronous validation](#asynchronous-validation) of custom formats and keywords\n\nCurrently Ajv is the only validator that passes all the tests from [JSON Schema Test Suite](https://github.com/json-schema/JSON-Schema-Test-Suite) (according to [json-schema-benchmark](https://github.com/ebdrup/json-schema-benchmark), apart from the test that requires that `1.0` is not an integer that is impossible to satisfy in JavaScript).\n\n\n## Install\n\n```\nnpm install ajv\n```\n\n\n## ![](\"https://raw.githubusercontent.com/webpack-contrib/schema-utils/master/logo.png\"){kind=logo}
\n ![](\"https://webpack.js.org/assets/icon-square-big.svg\"){kind=icon}
\n ![](\"https://github.com/bebraw.png?v=3&s=150\")
\n \n ![](\"https://github.com/d3viant0ne.png?v=3&s=150\")
\n \n ![](\"https://github.com/michael-ciniawsky.png?v=3&s=150\")
\n \n ![](\"https://cdn.rawgit.com/webpack/media/e7485eb2/logo/icon.svg\"){kind=icon}
\r\n ![](\"https://avatars3.githubusercontent.com/u/5635476?v=3&s=150\")
\r\n ![](\"https://github.com/evilebottnawi.png?v=3&s=150\")
\r\n \r\n Alexander Krasnoyarov\r\n