<img align="right" alt="Ajv logo" width="160" src="http://epoberezkin.github.io/ajv/images/ajv_logo.png">
# Ajv: Another JSON Schema Validator
The fastest JSON Schema validator for Node.js and browser. Supports draft-04/06/07.
[](https://travis-ci.org/epoberezkin/ajv)
[](https://www.npmjs.com/package/ajv)
[](https://www.npmjs.com/package/ajv)
[](https://coveralls.io/github/epoberezkin/ajv?branch=master)
[](https://greenkeeper.io/)
[](https://gitter.im/ajv-validator/ajv)
### _Ajv and [related repositories](#related-packages) will be transfered to [ajv-validator](https://github.com/ajv-validator) org_
## Using version 6
[JSON Schema draft-07](http://json-schema.org/latest/json-schema-validation.html) is published.
[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).
__Please note__: To use Ajv with draft-06 schemas you need to explicitly add the meta-schema to the validator instance:
```javascript
ajv.addMetaSchema(require('ajv/lib/refs/json-schema-draft-06.json'));
```
To use Ajv with draft-04 schemas in addition to explicitly adding meta-schema you also need to use option schemaId:
```javascript
var ajv = new Ajv({schemaId: 'id'});
// If you want to use both draft-04 and draft-06/07 schemas:
// var ajv = new Ajv({schemaId: 'auto'});
ajv.addMetaSchema(require('ajv/lib/refs/json-schema-draft-04.json'));
```
## Contents
- [Performance](#performance)
- [Features](#features)
- [Getting started](#getting-started)
- [Frequently Asked Questions](https://github.com/epoberezkin/ajv/blob/master/FAQ.md)
- [Using in browser](#using-in-browser)
- [Command line interface](#command-line-interface)
- Validation
- [Keywords](#validation-keywords)
- [Annotation keywords](#annotation-keywords)
- [Formats](#formats)
- [Combining schemas with $ref](#ref)
- [$data reference](#data-reference)
- NEW: [$merge and $patch keywords](#merge-and-patch-keywords)
- [Defining custom keywords](#defining-custom-keywords)
- [Asynchronous schema compilation](#asynchronous-schema-compilation)
- [Asynchronous validation](#asynchronous-validation)
- [Security considerations](#security-considerations)
- Modifying data during validation
- [Filtering data](#filtering-data)
- [Assigning defaults](#assigning-defaults)
- [Coercing data types](#coercing-data-types)
- API
- [Methods](#api)
- [Options](#options)
- [Validation errors](#validation-errors)
- [Plugins](#plugins)
- [Related packages](#related-packages)
- [Some packages using Ajv](#some-packages-using-ajv)
- [Tests, Contributing, History, License](#tests)
## Performance
Ajv 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.
Currently Ajv is the fastest and the most standard compliant validator according to these benchmarks:
- [json-schema-benchmark](https://github.com/ebdrup/json-schema-benchmark) - 50% faster than the second place
- [jsck benchmark](https://github.com/pandastrike/jsck#benchmarks) - 20-190% faster
- [z-schema benchmark](https://rawgit.com/zaggino/z-schema/master/benchmark/results.html)
- [themis benchmark](https://cdn.rawgit.com/playlyfe/themis/master/benchmark/results.html)
Performance of different validators by [json-schema-benchmark](https://github.com/ebdrup/json-schema-benchmark):
[](https://github.com/ebdrup/json-schema-benchmark/blob/master/README.md#performance)
## Features
- Ajv implements full JSON Schema [draft-06/07](http://json-schema.org/) and draft-04 standards:
- all validation keywords (see [JSON Schema validation keywords](https://github.com/epoberezkin/ajv/blob/master/KEYWORDS.md))
- full support of remote refs (remote schemas have to be added with `addSchema` or compiled to be available)
- support of circular references between schemas
- correct string lengths for strings with unicode pairs (can be turned off)
- [formats](#formats) defined by JSON Schema draft-07 standard and custom formats (can be turned off)
- [validates schemas against meta-schema](#api-validateschema)
- supports [browsers](#using-in-browser) and Node.js 0.10-8.x
- [asynchronous loading](#asynchronous-schema-compilation) of referenced schemas during compilation
- "All errors" validation mode with [option allErrors](#options)
- [error messages with parameters](#validation-errors) describing error reasons to allow creating custom error messages
- i18n error messages support with [ajv-i18n](https://github.com/epoberezkin/ajv-i18n) package
- [filtering data](#filtering-data) from additional properties
- [assigning defaults](#assigning-defaults) to missing properties and items
- [coercing data](#coercing-data-types) to the types specified in `type` keywords
- [custom keywords](#defining-custom-keywords)
- draft-06/07 keywords `const`, `contains`, `propertyNames` and `if/then/else`
- draft-06 boolean schemas (`true`/`false` as a schema to always pass/fail).
- 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
- [$data reference](#data-reference) to use values from the validated data as values for the schema keywords
- [asynchronous validation](#asynchronous-validation) of custom formats and keywords
Currently 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).
## Install
```
npm install ajv
```
## <a name="usage"></a>Getting started
Try it in the Node.js REPL: https://tonicdev.com/npm/ajv
The fastest validation call:
```javascript
var Ajv = require('ajv');
var ajv = new Ajv(); // options can be passed, e.g. {allErrors: true}
var validate = ajv.compile(schema);
var valid = validate(data);
if (!valid) console.log(validate.errors);
```
or with less code
```javascript
// ...
var valid = ajv.validate(schema, data);
if (!valid) console.log(ajv.errors);
// ...
```
or
```javascript
// ...
var valid = ajv.addSchema(schema, 'mySchema')
.validate('mySchema', data);
if (!valid) console.log(ajv.errorsText());
// ...
```
See [API](#api) and [Options](#options) for more details.
Ajv compiles schemas to functions and caches them in all cases (using schema serialized with [fast-json-stable-stringify](https://github.com/epoberezkin/fast-json-stable-stringify) or a custom function as a key), so that the next time the same schema is used (not necessarily the same object instance) it won't be compiled again.
The best performance is achieved when using compiled func
compile-node-sass-0.0.3.zip
需积分: 10 144 浏览量
2022-11-19
17:22:49
上传
评论
收藏 6.73MB ZIP 举报
compile-node-sass-0.0.3.zip （2000个子文件） 
cencode.c 2KB c99func.c 2KB parser.cpp 98KB ast.cpp 81KB extend.cpp 78KB functions.cpp 73KB eval.cpp 62KB prelexer.cpp 48KB json.cpp 33KB color_maps.cpp 33KB context.cpp 33KB inspect.cpp 31KB sass_context.cpp 30KB expand.cpp 26KB sass2scss.cpp 25KB cssize.cpp 18KB util.cpp 18KB file.cpp 16KB sass_values.cpp 15KB binding.cpp 13KB test_subset_map.cpp 12KB bind.cpp 11KB node.cpp 10KB check_nesting.cpp 10KB output.cpp 9KB sass_functions.cpp 8KB constants.cpp 8KB units.cpp 7KB source_map.cpp 7KB emitter.cpp 7KB error_handling.cpp 7KB plugins.cpp 6KB lexer.cpp 6KB environment.cpp 5KB values.cpp 5KB sass.cpp 5KB position.cpp 5KB sass_util.cpp 4KB color.cpp 4KB map.cpp 4KB custom_importer_bridge.cpp 3KB list.cpp 3KB utf8_string.cpp 3KB SharedPtr.cpp 3KB remove_placeholders.cpp 3KB boolean.cpp 2KB to_value.cpp 2KB listize.cpp 2KB number.cpp 2KB test_node.cpp 2KB to_c.cpp 2KB plugin.cpp 2KB factory.cpp 2KB test_superselector.cpp 2KB subset_map.cpp 2KB sass_context_wrapper.cpp 2KB null.cpp 2KB string.cpp 1KB base64vlq.cpp 1KB test_unification.cpp 923B custom_function_bridge.cpp 839B ast_fwd_decl.cpp 705B error.cpp 594B test_selector_difference.cpp 578B test_specificity.cpp 560B test_paths.cpp 537B create_string.cpp 467B qunit.css 3KB expected.css 756B expected.css 409B expected.css 255B expected.css 204B expected.css 167B expected.css 116B expected-importer.css 56B expected.css 49B setter-expected.css 46B expected.css 36B expected-orange.css 35B string-conversion-expected.css 32B expected-red.css 32B expected.css 30B expected.css 29B nan.h 87KB nan_callbacks_12_inl.h 18KB nan_callbacks_pre_12_inl.h 17KB nan_weak.h 15KB nan_implementation_12_inl.h 15KB nan_maybe_43_inl.h 13KB checked.h 12KB core.h 11KB context.h 10KB nan_new.h 9KB unchecked.h 9KB nan_maybe_pre_43_inl.h 8KB nan_string_bytes.h 8KB nan_implementation_pre_12_inl.h 8KB callback_bridge.h 7KB functions.h 7KB values.h 6KB共 2000 条
- 1
- 2
- 3
- 4
- 5
- 6
- 20
资源评论
