BaseSchema | jsonschema-definer

Type parameters

T
R: boolean
S: BaseJsonSchema

Hierarchy

BaseSchema

Index

Constructors

constructor

Properties

Methods

Constructors

constructor

new BaseSchema(type?: S["type"]): BaseSchema

- Defined in base.ts:46
Parameters
- Optional type: S["type"]
Returns BaseSchema

Properties

$schema

$schema: string = "http://json-schema.org/draft-07/schema#"

definitions

definitions: Record<string, Schema["plain"]>

isFluentSchema

isFluentSchema: true = true

isRequired

isRequired: boolean = true

otype

otype: R extends true ? T : T | undefined

plain

plain: S = {} as S

type

type: T

Static ajv

ajv: Ajv = new Ajv().addKeyword('custom', {validate: (value: string[], data: any, schema: Schema['plain'], path: string, full: any) =>value.every(key => BaseSchema.validators[key](data, full, schema, path))})

Static validators

validators: Record<string, Validator>

Methods

allOf

allOf(...schemas: P): BaseSchema<U.IntersectOf<P[number]["type"]>, R>

- Defined in base.ts:235
It MUST be a non-empty array. Each item of the array MUST be a valid JSON Schema.

example

{ allOf: [ {} ] }

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.6.7.1

Type parameters
- P: BaseSchema<T>[]
Parameters
- Rest ...schemas: P
Returns BaseSchema<U.IntersectOf<P[number]["type"]>, R>

anyOf

anyOf(...schemas: P): BaseSchema<P[number]["type"], R>

- Defined in base.ts:221
It MUST be a non-empty array. Each item of the array MUST be a valid JSON Schema.

example

{ anyOf: [ {} ] }

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.6.7.3

Type parameters
- P: BaseSchema<T>[]
Parameters
- Rest ...schemas: P
Returns BaseSchema<P[number]["type"], R>

const

const(value: P): BaseSchema<P, R>

- Defined in base.ts:207
The value of this keyword MAY be of any type, including null.

example

{ const: 'some' }

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.6.1.3

Type parameters
- P: T
Parameters
- value: P
Returns BaseSchema<P, R>

copyWith

copyWith(modifyObject: Partial<BaseSchema & { plain: Partial<Schema["plain"]> }>): this

- Defined in base.ts:343
Make copy of current schema with modified values

Parameters
- modifyObject: Partial<BaseSchema & { plain: Partial<Schema["plain"]> }>
Returns this

custom

custom(...validators: Validator[]): this

- Defined in base.ts:309
Add custom validation functions. Since custom validators didn't supported by JSON Schema, I used AJV custom keywords to add such functionality

Parameters
- Rest ...validators: Validator[]
Returns this

default

default(def: T): this

- Defined in base.ts:144
There are no restrictions placed on the value of this keyword.

example

{ default: ... }

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.10.2

Parameters
- def: T
Returns this

definition

definition(name: string, definition: BaseSchema): this

- Defined in base.ts:160
The "definitions" keywords provides a standardized location for schema authors to inline re-usable JSON Schemas into a more general schema. There are no restrictions placed on the values within the array.

example

{ definitions: { [name]: definition } }

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.9

Parameters
- name: string
- definition: BaseSchema
Returns this

description

description(description: string): this

- Defined in base.ts:115
It can be used to decorate a user interface with information about the data produced by this user interface. A description provides explanation about the purpose of the instance described by the schema.

example

{ description: "string" }

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.10.1

Parameters
- description: string
Returns this

ensure

ensure(data: T): T

- Defined in base.ts:332
Validate provided data with current schema using ajv, if validation failed function will throw error

Parameters
- data: T
Returns T

enum

enum(...values: P): BaseSchema<P[number], R>

- Defined in base.ts:193
The value of this keyword MUST be an array. This array SHOULD have at least one element. Elements in the array SHOULD be unique.

example

{ enum: [ 'string' ] }

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.6.1.2

Type parameters
- P: T[]
Parameters
- Rest ...values: P
Returns BaseSchema<P[number], R>

examples

examples(...examples: T[]): this

- Defined in base.ts:130
The value of this keyword MUST be an array. There are no restrictions placed on the values within the array.

example

{ examples: [ ... ] }

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.10.4

Parameters
- Rest ...examples: T[]
Returns this

id

id($id: string): this

- Defined in base.ts:62
It defines a URI for the schema, and the base URI that other URI references within the schema are resolved against.

example

{ $id: "string" }

reference

https://json-schema.org/latest/json-schema-core.html#id-keyword

Parameters
- $id: string
  
  an #id
Returns this

ifThen

ifThen(ifClause: BaseSchema, thenClause: BaseSchema): this

- Defined in base.ts:283
This validation outcome of this keyword's subschema has no direct effect on the overall validation result. Rather, it controls which of the "then" or "else" keywords are evaluated. When "if" is present, and the instance successfully validates against its subschema, then validation succeeds against this keyword if the instance also successfully validates against this keyword's subschema.

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.6.6.1

Parameters
- ifClause: BaseSchema
- thenClause: BaseSchema
Returns this

ifThenElse

ifThenElse(ifClause: BaseSchema, thenClause: BaseSchema, elseClause: BaseSchema): this

- Defined in base.ts:297
When "if" is present, and the instance fails to validate against its subschema, then validation succeeds against this keyword if the instance successfully validates against this keyword's subschema.

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.6.6.1

Parameters
- ifClause: BaseSchema
- thenClause: BaseSchema
- elseClause: BaseSchema
Returns this

not

not(not: P): this

- Defined in base.ts:261
It MUST be a valid JSON Schema.

example

{ not: {} }

Type parameters
- P: BaseSchema
Parameters
- not: P
Returns this

oneOf

oneOf(...schemas: P): BaseSchema<P[number]["type"], R>

- Defined in base.ts:249
It MUST be a non-empty array. Each item of the array MUST be a valid JSON Schema.

example

{ oneOf: [ {} ] }

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.6.7.2

Type parameters
- P: BaseSchema<T>[]
Parameters
- Rest ...schemas: P
Returns BaseSchema<P[number]["type"], R>

optional

optional(): BaseSchema<T, false>

- Defined in base.ts:268
Should be used only with ObjectSchema. By default all properties in Object Schema are required. This will make them optional

Returns BaseSchema<T, false>

raw

raw(fragment: Record<string, any>): this

- Defined in base.ts:179
Because the differences between JSON Schemas and Open API (Swagger) it can be handy to arbitrary modify the schema injecting a fragment
- Examples:
- S.number().raw({ nullable:true })
- S.string().format('date').raw({ formatMaximum: '2020-01-01' })
example

{ somethingCustom: 'value' }

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.6.3.3
Parameters
- fragment: Record<string, any>
 
 an arbitrary JSON Schema to inject
Returns this

ref

ref($ref: string): this

- Defined in base.ts:74
The value must be a valid id e.g. #properties/foo

example

{ $ref: "string" }

Parameters
- $ref: string
Returns this

schema

schema($schema: string): this

- Defined in base.ts:85
Set $schema property

example

{ $schema: "string" }

Parameters
- $schema: string
Returns this

title

title(title: string): this

- Defined in base.ts:99
It can be used to decorate a user interface with information about the data produced by this user interface. A title will preferably be short.

example

{ title: "string" }

reference

https://json-schema.org/latest/json-schema-validation.html#rfc.section.10.1

Parameters
- title: string
Returns this

validate

validate(data: T): [boolean | PromiseLike<any>, ErrorObject[] | null | undefined]

- Defined in base.ts:323
Validate provided data with current schema using ajv, does not throw errors

Parameters
- data: T
Returns [boolean | PromiseLike<any>, ErrorObject[] | null | undefined]

valueOf

valueOf(): S

- Defined in base.ts:352
It returns all the schema values

Returns S

Type parameters

T

R: boolean

S: BaseJsonSchema

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Optional type: S["type"]

Returns BaseSchema

Properties

$schema

definitions

isFluentSchema

isRequired

otype

plain

type

Static ajv

Static validators

Methods

allOf

Type parameters

P: BaseSchema<T>[]

Parameters

Rest ...schemas: P

Returns BaseSchema<U.IntersectOf<P[number]["type"]>, R>

anyOf

Type parameters

P: BaseSchema<T>[]

Parameters

Rest ...schemas: P

Returns BaseSchema<P[number]["type"], R>

const

Type parameters

P: T

Parameters

value: P

Returns BaseSchema<P, R>

copyWith

Parameters

modifyObject: Partial<BaseSchema & { plain: Partial<Schema["plain"]> }>

Returns this

custom

Parameters

Rest ...validators: Validator[]

Returns this

default

Parameters

def: T

Returns this

definition

Parameters

name: string

definition: BaseSchema

Returns this

description

Parameters

description: string

Returns this

ensure

Parameters

data: T

Returns T

enum

Type parameters

P: T[]

Parameters

Rest ...values: P

Returns BaseSchema<P[number], R>

examples

Parameters

Rest ...examples: T[]

Returns this

id

Parameters