|
|
declare var ajv: { (options?: ajv.Options): ajv.Ajv; new(options?: ajv.Options): ajv.Ajv; ValidationError: typeof AjvErrors.ValidationError; MissingRefError: typeof AjvErrors.MissingRefError; $dataMetaSchema: object; }
declare namespace AjvErrors { class ValidationError extends Error { constructor(errors: Array<ajv.ErrorObject>);
message: string; errors: Array<ajv.ErrorObject>; ajv: true; validation: true; }
class MissingRefError extends Error { constructor(baseId: string, ref: string, message?: string); static message: (baseId: string, ref: string) => string;
message: string; missingRef: string; missingSchema: string; } }
declare namespace ajv { type ValidationError = AjvErrors.ValidationError;
type MissingRefError = AjvErrors.MissingRefError;
interface Ajv { /** * Validate data using schema * Schema will be compiled and cached (using serialized JSON as key, [fast-json-stable-stringify](https://github.com/epoberezkin/fast-json-stable-stringify) is used to serialize by default).
* @param {string|object|Boolean} schemaKeyRef key, ref or schema object * @param {Any} data to be validated * @return {Boolean} validation result. Errors from the last validation will be available in `ajv.errors` (and also in compiled schema: `schema.errors`). */ validate(schemaKeyRef: object | string | boolean, data: any): boolean | PromiseLike<any>; /** * Create validating function for passed schema. * @param {object|Boolean} schema schema object * @return {Function} validating function */ compile(schema: object | boolean): ValidateFunction; /** * Creates validating function for passed schema with asynchronous loading of missing schemas. * `loadSchema` option should be a function that accepts schema uri and node-style callback. * @this Ajv * @param {object|Boolean} schema schema object * @param {Boolean} meta optional true to compile meta-schema; this parameter can be skipped * @param {Function} callback optional node-style callback, it is always called with 2 parameters: error (or null) and validating function. * @return {PromiseLike<ValidateFunction>} validating function */ compileAsync(schema: object | boolean, meta?: Boolean, callback?: (err: Error, validate: ValidateFunction) => any): PromiseLike<ValidateFunction>; /** * Adds schema to the instance. * @param {object|Array} schema schema or array of schemas. If array is passed, `key` and other parameters will be ignored. * @param {string} key Optional schema key. Can be passed to `validate` method instead of schema object or id/ref. One schema per instance can have empty `id` and `key`. * @return {Ajv} this for method chaining */ addSchema(schema: Array<object> | object, key?: string): Ajv; /** * Add schema that will be used to validate other schemas * options in META_IGNORE_OPTIONS are alway set to false * @param {object} schema schema object * @param {string} key optional schema key * @return {Ajv} this for method chaining */ addMetaSchema(schema: object, key?: string): Ajv; /** * Validate schema * @param {object|Boolean} schema schema to validate * @return {Boolean} true if schema is valid */ validateSchema(schema: object | boolean): boolean; /** * Get compiled schema from the instance by `key` or `ref`. * @param {string} keyRef `key` that was passed to `addSchema` or full schema reference (`schema.id` or resolved id). * @return {Function} schema validating function (with property `schema`). Returns undefined if keyRef can't be resolved to an existing schema. */ getSchema(keyRef: string): ValidateFunction | undefined; /** * Remove cached schema(s). * If no parameter is passed all schemas but meta-schemas are removed. * If RegExp is passed all schemas with key/id matching pattern but meta-schemas are removed. * Even if schema is referenced by other schemas it still can be removed as other schemas have local references. * @param {string|object|RegExp|Boolean} schemaKeyRef key, ref, pattern to match key/ref or schema object * @return {Ajv} this for method chaining */ removeSchema(schemaKeyRef?: object | string | RegExp | boolean): Ajv; /** * Add custom format * @param {string} name format name * @param {string|RegExp|Function} format string is converted to RegExp; function should return boolean (true when valid) * @return {Ajv} this for method chaining */ addFormat(name: string, format: FormatValidator | FormatDefinition): Ajv; /** * Define custom keyword * @this Ajv * @param {string} keyword custom keyword, should be a valid identifier, should be different from all standard, custom and macro keywords. * @param {object} definition keyword definition object with properties `type` (type(s) which the keyword applies to), `validate` or `compile`. * @return {Ajv} this for method chaining */ addKeyword(keyword: string, definition: KeywordDefinition): Ajv; /** * Get keyword definition * @this Ajv * @param {string} keyword pre-defined or custom keyword. * @return {object|Boolean} custom keyword definition, `true` if it is a predefined keyword, `false` otherwise. */ getKeyword(keyword: string): object | boolean; /** * Remove keyword * @this Ajv * @param {string} keyword pre-defined or custom keyword. * @return {Ajv} this for method chaining */ removeKeyword(keyword: string): Ajv; /** * Validate keyword * @this Ajv * @param {object} definition keyword definition object * @param {boolean} throwError true to throw exception if definition is invalid * @return {boolean} validation result */ validateKeyword(definition: KeywordDefinition, throwError: boolean): boolean; /** * Convert array of error message objects to string * @param {Array<object>} errors optional array of validation errors, if not passed errors from the instance are used. * @param {object} options optional options with properties `separator` and `dataVar`. * @return {string} human readable string with all errors descriptions */ errorsText(errors?: Array<ErrorObject> | null, options?: ErrorsTextOptions): string; errors?: Array<ErrorObject> | null; }
interface CustomLogger { log(...args: any[]): any; warn(...args: any[]): any; error(...args: any[]): any; }
interface ValidateFunction { ( data: any, dataPath?: string, parentData?: object | Array<any>, parentDataProperty?: string | number, rootData?: object | Array<any> ): boolean | PromiseLike<any>; schema?: object | boolean; errors?: null | Array<ErrorObject>; refs?: object; refVal?: Array<any>; root?: ValidateFunction | object; $async?: true; source?: object; }
interface Options { $data?: boolean; allErrors?: boolean; verbose?: boolean; jsonPointers?: boolean; uniqueItems?: boolean; unicode?: boolean; format?: false | string; formats?: object; keywords?: object; unknownFormats?: true | string[] | 'ignore'; schemas?: Array<object> | object; schemaId?: '$id' | 'id' | 'auto'; missingRefs?: true | 'ignore' | 'fail'; extendRefs?: true | 'ignore' | 'fail'; loadSchema?: (uri: string, cb?: (err: Error, schema: object) => void) => PromiseLike<object | boolean>; removeAdditional?: boolean | 'all' | 'failing'; useDefaults?: boolean | 'empty' | 'shared'; coerceTypes?: boolean | 'array'; strictDefaults?: boolean | 'log'; strictKeywords?: boolean | 'log'; strictNumbers?: boolean; async?: boolean | string; transpile?: string | ((code: string) => string); meta?: boolean | object; validateSchema?: boolean | 'log'; addUsedSchema?: boolean; inlineRefs?: boolean | number; passContext?: boolean; loopRequired?: number; ownProperties?: boolean; multipleOfPrecision?: boolean | number; errorDataPath?: string, messages?: boolean; sourceCode?: boolean; processCode?: (code: string, schema: object) => string; cache?: object; logger?: CustomLogger | false; nullable?: boolean; serialize?: ((schema: object | boolean) => any) | false; }
type FormatValidator = string | RegExp | ((data: string) => boolean | PromiseLike<any>); type NumberFormatValidator = ((data: number) => boolean | PromiseLike<any>);
interface NumberFormatDefinition { type: "number", validate: NumberFormatValidator; compare?: (data1: number, data2: number) => number; async?: boolean; }
interface StringFormatDefinition { type?: "string", validate: FormatValidator; compare?: (data1: string, data2: string) => number; async?: boolean; }
type FormatDefinition = NumberFormatDefinition | StringFormatDefinition;
interface KeywordDefinition { type?: string | Array<string>; async?: boolean; $data?: boolean; errors?: boolean | string; metaSchema?: object; // schema: false makes validate not to expect schema (ValidateFunction)
schema?: boolean; statements?: boolean; dependencies?: Array<string>; modifying?: boolean; valid?: boolean; // one and only one of the following properties should be present
validate?: SchemaValidateFunction | ValidateFunction; compile?: (schema: any, parentSchema: object, it: CompilationContext) => ValidateFunction; macro?: (schema: any, parentSchema: object, it: CompilationContext) => object | boolean; inline?: (it: CompilationContext, keyword: string, schema: any, parentSchema: object) => string; }
interface CompilationContext { level: number; dataLevel: number; dataPathArr: string[]; schema: any; schemaPath: string; baseId: string; async: boolean; opts: Options; formats: { [index: string]: FormatDefinition | undefined; }; keywords: { [index: string]: KeywordDefinition | undefined; }; compositeRule: boolean; validate: (schema: object) => boolean; util: { copy(obj: any, target?: any): any; toHash(source: string[]): { [index: string]: true | undefined }; equal(obj: any, target: any): boolean; getProperty(str: string): string; schemaHasRules(schema: object, rules: any): string; escapeQuotes(str: string): string; toQuotedString(str: string): string; getData(jsonPointer: string, dataLevel: number, paths: string[]): string; escapeJsonPointer(str: string): string; unescapeJsonPointer(str: string): string; escapeFragment(str: string): string; unescapeFragment(str: string): string; }; self: Ajv; }
interface SchemaValidateFunction { ( schema: any, data: any, parentSchema?: object, dataPath?: string, parentData?: object | Array<any>, parentDataProperty?: string | number, rootData?: object | Array<any> ): boolean | PromiseLike<any>; errors?: Array<ErrorObject>; }
interface ErrorsTextOptions { separator?: string; dataVar?: string; }
interface ErrorObject { keyword: string; dataPath: string; schemaPath: string; params: ErrorParameters; // Added to validation errors of propertyNames keyword schema
propertyName?: string; // Excluded if messages set to false.
message?: string; // These are added with the `verbose` option.
schema?: any; parentSchema?: object; data?: any; }
type ErrorParameters = RefParams | LimitParams | AdditionalPropertiesParams | DependenciesParams | FormatParams | ComparisonParams | MultipleOfParams | PatternParams | RequiredParams | TypeParams | UniqueItemsParams | CustomParams | PatternRequiredParams | PropertyNamesParams | IfParams | SwitchParams | NoParams | EnumParams;
interface RefParams { ref: string; }
interface LimitParams { limit: number; }
interface AdditionalPropertiesParams { additionalProperty: string; }
interface DependenciesParams { property: string; missingProperty: string; depsCount: number; deps: string; }
interface FormatParams { format: string }
interface ComparisonParams { comparison: string; limit: number | string; exclusive: boolean; }
interface MultipleOfParams { multipleOf: number; }
interface PatternParams { pattern: string; }
interface RequiredParams { missingProperty: string; }
interface TypeParams { type: string; }
interface UniqueItemsParams { i: number; j: number; }
interface CustomParams { keyword: string; }
interface PatternRequiredParams { missingPattern: string; }
interface PropertyNamesParams { propertyName: string; }
interface IfParams { failingKeyword: string; }
interface SwitchParams { caseIndex: number; }
interface NoParams { }
interface EnumParams { allowedValues: Array<any>; } }
export = ajv;
|