import { mongoose } from "https://deno.land/x/mongoose@7.8.2/types/index.d.ts";
const { Schema } = mongoose;
Constructors
new
Schema(definition?: SchemaDefinition<SchemaDefinitionType<EnforcedDocType>, EnforcedDocType> | DocType, options?: SchemaOptions<FlatRecord<DocType>, TInstanceMethods, TQueryHelpers, TStaticMethods, TVirtuals, THydratedDocumentType> | ResolveSchemaOptions<TSchemaOptions>)Create a new schema
Type Parameters
optional
TModelType = Model<EnforcedDocType, any, any, any>optional
DocType extends ApplySchemaOptions<ObtainDocumentType<DocType, EnforcedDocType, ResolveSchemaOptions<TSchemaOptions>>, ResolveSchemaOptions<TSchemaOptions>> = ApplySchemaOptions<ObtainDocumentType<any, EnforcedDocType, ResolveSchemaOptions<TSchemaOptions>>, ResolveSchemaOptions<TSchemaOptions>>optional
THydratedDocumentType = HydratedDocument<FlatRecord<DocType>, TVirtuals & TInstanceMethods>Properties
childSchemas: { schema: Schema; model: any; }[]
Array of child schemas (from document arrays and single nested subdocs)
and their corresponding compiled models. Each element of the array is
an object with 2 properties: schema and model.
optional
discriminators: { [name: string]: Schema; }Object containing discriminators defined on this schema
methods: [F in keyof TInstanceMethods]: TInstanceMethods[F] & AnyObject
Object of currently defined methods on this schema.
The original object passed to the schema constructor
query: TQueryHelpers
Object of currently defined query helpers on this schema.
statics: [F in keyof TStaticMethods]: TStaticMethods[F] & { [name: string]: (this: TModelType, ...args: any[]) => unknown; }
Object of currently defined statics on this schema.
virtuals: TVirtuals
Object of currently defined virtuals on this schema
Methods
add(obj: SchemaDefinition<SchemaDefinitionType<EnforcedDocType>> | Schema, prefix?: string): this
Adds key path / schema type pairs to this schema.
alias(path: string, alias: string | string[]): this
Add an alias for path. This means getting or setting the alias
is equivalent to getting or setting the path.
clearIndexes(): this
Removes all indexes on this schema
clone<T = this>(): T
Returns a copy of this schema
discriminator<DisSchema = Schema>(name: string | number, schema: DisSchema): this
eachPath(fn: (path: string, type: SchemaType) => void): this
Iterates the schemas paths similar to Array#forEach.
get<K extends keyof SchemaOptions>(key: K): SchemaOptions[K]
Gets a schema option.
index(fields: IndexDefinition, options?: IndexOptions): this
Defines an index (most likely compound) for this schema.
indexes(): Array<[IndexDefinition, IndexOptions]>
Returns a list of indexes that this schema declares, via schema.index()
or by index: true in a path's options.
loadClass(model: Function, onlyVirtuals?: boolean): this
Loads an ES6 class into a schema. Maps setters + getters, static methods, and instance methods to schema virtuals, statics, and methods.
method<Context = THydratedDocumentType>(): this
name: string,
fn: (this: Context, ...args: any[]) => any,
opts?: any,
Adds an instance method to documents constructed from Models compiled from this schema.
method(obj: Partial<TInstanceMethods>): this
path<ResultType extends SchemaType = SchemaType<any, THydratedDocumentType>>(path: string): ResultType
Gets/sets schema paths.
path<pathGeneric extends keyof EnforcedDocType>(path: pathGeneric): SchemaType<EnforcedDocType[pathGeneric]>
path(path: string, constructor: any): this
pathType(path: string): string
Returns the pathType of path for this schema.
pick<T = this>(paths: string[], options?: SchemaOptions): T
Returns a new schema that has the picked paths from this schema.
plugin<PFunc extends PluginFunction<DocType, TModelType, any, any, any, any>, POptions extends Parameters<PFunc>[1] = Parameters<PFunc>[1]>(fn: PFunc, opts?: POptions): this
Registers a plugin for this schema.
post<T = Query<any, any>>(): this
method: MongooseQueryMiddleware | MongooseQueryMiddleware[] | RegExp,
options: SchemaPostOptions & { errorHandler: true; },
fn: ErrorHandlingMiddlewareWithOption<T>,
Defines a post hook for the model.
post<T = THydratedDocumentType>(): this
method: MongooseDocumentMiddleware | MongooseDocumentMiddleware[] | RegExp,
options: SchemaPostOptions & { errorHandler: true; },
fn: ErrorHandlingMiddlewareWithOption<T>,
post<T extends Aggregate<any>>(): this
method: "aggregate" | RegExp,
options: SchemaPostOptions & { errorHandler: true; },
fn: ErrorHandlingMiddlewareWithOption<T, Array<any>>,
post<T = TModelType>(): this
method: "insertMany" | RegExp,
options: SchemaPostOptions & { errorHandler: true; },
fn: ErrorHandlingMiddlewareWithOption<T>,
post<T = never>(): this
method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp,
options: SchemaPostOptions & { document: false; query: false; },
fn: PostMiddlewareFunction<never, never>,
post<T = never>(): this
method: MongooseDistinctQueryMiddleware | MongooseDistinctQueryMiddleware[],
options: SchemaPostOptions & { document: boolean; query: false; },
fn: PostMiddlewareFunction<T, QueryResultType<T>>,
post<T = never>(): this
method: MongooseDistinctDocumentMiddleware | MongooseDistinctDocumentMiddleware[] | RegExp,
options: SchemaPostOptions & { document: false; query: true; },
fn: PostMiddlewareFunction<T, T>,
post<T = THydratedDocumentType>(method: MongooseDistinctDocumentMiddleware | MongooseDistinctDocumentMiddleware[], fn: PostMiddlewareFunction<T, T>): this
post<T = THydratedDocumentType>(): this
method: MongooseDistinctDocumentMiddleware | MongooseDistinctDocumentMiddleware[],
options: SchemaPostOptions & SchemaPostOptions,
fn: PostMiddlewareFunction<T, T>,
post<T = THydratedDocumentType>(): this
method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp,
options: SchemaPostOptions & { document: true; query: false; },
fn: PostMiddlewareFunction<T, T>,
post<T = Query<any, any>>(method: MongooseRawResultQueryMiddleware | MongooseRawResultQueryMiddleware[], fn: PostMiddlewareFunction<T, null | QueryResultType<T> | ModifyResult<QueryResultType<T>>>): this
post<T = Query<any, any>>(method: MongooseDefaultQueryMiddleware | MongooseDefaultQueryMiddleware[], fn: PostMiddlewareFunction<T, QueryResultType<T>>): this
post<T = Query<any, any>>(): this
method: MongooseDistinctQueryMiddleware | MongooseDistinctQueryMiddleware[],
options: SchemaPostOptions,
fn: PostMiddlewareFunction<T, QueryResultType<T>>,
post<T = Query<any, any>>(): this
method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp,
options: SchemaPostOptions & { document: false; query: true; },
fn: PostMiddlewareFunction<T, QueryResultType<T>>,
post<T = THydratedDocumentType | Query<any, any>>(): this
method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp,
options: SchemaPostOptions & { document: true; query: true; },
fn: PostMiddlewareFunction<T, T | QueryResultType<T>>,
post<T = THydratedDocumentType | Query<any, any>>(method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp, fn: PostMiddlewareFunction<T, T | QueryResultType<T>>): this
post<T = never>(): this
method: MongooseDistinctQueryMiddleware | MongooseDistinctQueryMiddleware[],
options: SchemaPostOptions & { document: boolean; query: false; },
fn: ErrorHandlingMiddlewareFunction<T>,
post<T = never>(): this
method: MongooseDistinctDocumentMiddleware | MongooseDistinctDocumentMiddleware[],
options: SchemaPostOptions & { document: false; query: boolean; },
fn: ErrorHandlingMiddlewareFunction<T>,
post<T = never>(): this
method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp,
options: SchemaPostOptions & { document: false; query: false; },
fn: ErrorHandlingMiddlewareFunction<T>,
post<T = THydratedDocumentType>(method: MongooseDistinctDocumentMiddleware | MongooseDistinctDocumentMiddleware[], fn: ErrorHandlingMiddlewareFunction<T>): this
post<T = THydratedDocumentType>(): this
method: MongooseDistinctDocumentMiddleware | MongooseDistinctDocumentMiddleware[],
options: SchemaPostOptions,
fn: ErrorHandlingMiddlewareFunction<T>,
post<T = THydratedDocumentType>(): this
method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp,
options: SchemaPostOptions & { document: true; query: false; },
fn: ErrorHandlingMiddlewareFunction<T>,
post<T = Query<any, any>>(method: MongooseDefaultQueryMiddleware | MongooseDefaultQueryMiddleware[], fn: ErrorHandlingMiddlewareFunction<T>): this
post<T = Query<any, any>>(): this
method: MongooseDistinctQueryMiddleware | MongooseDistinctQueryMiddleware[],
options: SchemaPostOptions,
fn: ErrorHandlingMiddlewareFunction<T>,
post<T = Query<any, any>>(): this
method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp,
options: SchemaPostOptions & { document: false; query: true; },
fn: ErrorHandlingMiddlewareFunction<T>,
post<T = THydratedDocumentType | Query<any, any>>(): this
method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp,
options: SchemaPostOptions & { document: true; query: true; },
fn: ErrorHandlingMiddlewareFunction<T>,
post<T = THydratedDocumentType | Query<any, any>>(method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp, fn: ErrorHandlingMiddlewareFunction<T>): this
post<T extends Aggregate<any>>(method: "aggregate" | RegExp, fn: PostMiddlewareFunction<T, Array<AggregateExtract<T>>>): this
post<T extends Aggregate<any>>(): this
method: "aggregate" | RegExp,
options: SchemaPostOptions,
fn: PostMiddlewareFunction<T, Array<AggregateExtract<T>>>,
post<T = TModelType>(method: "insertMany" | RegExp, fn: PostMiddlewareFunction<T, T>): this
post<T = TModelType>(): this
method: "insertMany" | RegExp,
options: SchemaPostOptions,
fn: PostMiddlewareFunction<T, T>,
post<T extends Aggregate<any>>(method: "aggregate" | RegExp, fn: ErrorHandlingMiddlewareFunction<T, Array<any>>): this
post<T extends Aggregate<any>>(): this
method: "aggregate" | RegExp,
options: SchemaPostOptions,
fn: ErrorHandlingMiddlewareFunction<T, Array<any>>,
post<T = TModelType>(method: "insertMany" | RegExp, fn: ErrorHandlingMiddlewareFunction<T>): this
post<T = TModelType>(): this
method: "insertMany" | RegExp,
options: SchemaPostOptions,
fn: ErrorHandlingMiddlewareFunction<T>,
pre<T = never>(): this
method: "save",
options: SchemaPreOptions & { document: false; query: boolean; },
fn: PreSaveMiddlewareFunction<T>,
Defines a pre hook for the model.
pre<T = never>(): this
method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp,
options: SchemaPreOptions & { document: false; query: false; },
fn: PreMiddlewareFunction<T>,
pre<T = never>(): this
method: MongooseDistinctQueryMiddleware | MongooseDistinctQueryMiddleware[],
options: SchemaPreOptions & { document: boolean; query: false; },
fn: PreMiddlewareFunction<T>,
pre<T = never>(): this
method: MongooseDistinctDocumentMiddleware | MongooseDistinctDocumentMiddleware[] | RegExp,
options: SchemaPreOptions & { document: false; query: boolean; },
fn: PreMiddlewareFunction<T>,
pre<T = THydratedDocumentType | Query<any, any>>(): this
method: MongooseQueryAndDocumentMiddleware | MongooseQueryAndDocumentMiddleware[] | RegExp,
options: SchemaPreOptions & { document: true; query: true; },
fn: PreMiddlewareFunction<T>,
pre<T = THydratedDocumentType>(method: "save", fn: PreSaveMiddlewareFunction<T>): this
pre<T = THydratedDocumentType>(): this
method: "save",
options: SchemaPreOptions,
fn: PreSaveMiddlewareFunction<T>,
pre<T = THydratedDocumentType>(method: MongooseDistinctDocumentMiddleware | MongooseDistinctDocumentMiddleware[], fn: PreMiddlewareFunction<T>): this
pre<T = THydratedDocumentType>(): this
method: MongooseDistinctDocumentMiddleware | MongooseDistinctDocumentMiddleware[],
options: SchemaPreOptions,
fn: PreMiddlewareFunction<T>,
pre<T = THydratedDocumentType>(): this
method: MongooseQueryAndDocumentMiddleware | MongooseQueryAndDocumentMiddleware[] | RegExp,
options: SchemaPreOptions & { document: true; },
fn: PreMiddlewareFunction<T>,
pre<T = THydratedDocumentType>(): this
method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp,
options: SchemaPreOptions & { document: true; query: false; },
fn: PreMiddlewareFunction<T>,
pre<T = Query<any, any>>(method: MongooseDefaultQueryMiddleware | MongooseDefaultQueryMiddleware[], fn: PreMiddlewareFunction<T>): this
pre<T = Query<any, any>>(): this
method: MongooseDistinctQueryMiddleware | MongooseDistinctQueryMiddleware[],
options: SchemaPreOptions,
fn: PreMiddlewareFunction<T>,
pre<T = Query<any, any>>(): this
method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp,
options: SchemaPreOptions & { document: false; query: true; },
fn: PreMiddlewareFunction<T>,
pre<T = THydratedDocumentType | Query<any, any>>(): this
method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp,
options: SchemaPreOptions & { document: true; query: true; },
fn: PreMiddlewareFunction<T>,
pre<T = THydratedDocumentType | Query<any, any>>(method: MongooseQueryOrDocumentMiddleware | MongooseQueryOrDocumentMiddleware[] | RegExp, fn: PreMiddlewareFunction<T>): this
pre<T extends Aggregate<any>>(method: "aggregate" | RegExp, fn: PreMiddlewareFunction<T>): this
pre<T extends Aggregate<any>>(): this
method: "aggregate" | RegExp,
options: SchemaPreOptions,
fn: PreMiddlewareFunction<T>,
pre<T = TModelType>(method: "insertMany" | RegExp, fn: () => void | Promise<void>): this
this: T,
next: (err?: CallbackError) => void,
docs: any | Array<any>,
options?: InsertManyOptions & { lean?: boolean; },
pre<T = TModelType>(): this
method: "insertMany" | RegExp,
options: SchemaPreOptions,
fn: () => void | Promise<void>,
this: T,
next: (err?: CallbackError) => void,
docs: any | Array<any>,
options?: InsertManyOptions & { lean?: boolean; },
queue(name: string, args: any[]): this
Adds a method call to the queue.
remove(paths: string | Array<string>): this
Removes the given path (or [paths]).
requiredPaths(invalidate?: boolean): string[]
Returns an Array of path strings that are required by this schema.
set<K extends keyof SchemaOptions>(): this
key: K,
value: SchemaOptions[K],
_tags?: any,
Sets a schema option.
static<K extends keyof TStaticMethods>(name: K, fn: TStaticMethods[K]): this
Adds static "class" methods to Models compiled from this schema.
static(obj: [F in keyof TStaticMethods]: TStaticMethods[F] & { [name: string]: (this: TModelType, ...args: any[]) => any; }): this
static(name: string, fn: (this: TModelType, ...args: any[]) => any): this
virtual<T = HydratedDocument<DocType, TVirtuals & TInstanceMethods, TQueryHelpers>>(name: keyof TVirtuals | string, options?: VirtualTypeOptions<T, DocType>): VirtualType<T>
Creates a virtual type with the given name.
virtualpath<T = THydratedDocumentType>(name: string): VirtualType<T> | null
Returns the virtual type with the given name.