Class String

Hierarchy (view full)

Constructors

constructor

Properties

OptionsConstructor defaultOptions instance isRequired? options path schema validators schemaName

Methods

cast default enum get immutable index lowercase match maxlength minlength ref required select set sparse text transform trim unique uppercase validate cast checkRequired get set

Constructors

constructor

  • new String(path, options?, instance?): String

  • SchemaType constructor

    Parameters

    • path: string
    • Optional options: AnyObject
    • Optional instance: string

    Returns String

Properties

OptionsConstructor

OptionsConstructor: SchemaTypeOptions<any, any>

The class that Mongoose uses internally to instantiate this SchemaType's options property.

defaultOptions

defaultOptions: Record<string, any>

Default options for this SchemaType

instance

instance: string

String representation of what type this is, like 'ObjectID' or 'Number'

Optional isRequired

isRequired?: boolean

True if this SchemaType has a required validator. False otherwise.

options

options: AnyObject

The options this SchemaType was instantiated with

path

path: string

The path to this SchemaType in a Schema.

schema

schema: Schema<any, mongoose.Model<any, any, any, any, any, any>, {}, {}, {}, {}, DefaultSchemaOptions, {}, mongoose.Document<unknown, {}, FlatRecord<{}>> & FlatRecord<{}> & Required<{
    _id: unknown;
}>>

The schema this SchemaType instance is part of

Type declaration

    Type declaration

      Type declaration

        Type declaration

          Type declaration

            validators

            validators: mongoose.Validator[]

            The validators that Mongoose should run to validate properties at this SchemaType's path.

            Static schemaName

            schemaName: "String"

            This schema type's name, to defend against minifiers that mangle function names.

            Methods

            cast

            • cast(val, doc, init, prev?, options?): any

            • Cast val to this schema type. Each class that inherits from schema type should implement this function.

              Parameters

              • val: any
              • doc: mongoose.Document<any, any, any>
              • init: boolean
              • Optional prev: any
              • Optional options: any

              Returns any

            default

            • default(val): any

            • Sets a default value for this SchemaType.

              Parameters

              • val: any

              Returns any

            enum

            • enum(vals): this

            • Adds an enum validator

              Parameters

              • vals: any

              Returns this

            get

            • get(fn): this

            • Adds a getter to this schematype.

              Parameters

              • fn: Function

              Returns this

            immutable

            • immutable(bool): this

            • Defines this path as immutable. Mongoose prevents you from changing immutable paths unless the parent document has isNew: true.

              Parameters

              • bool: boolean

              Returns this

            index

            • index(options): this

            • Declares the index options for this schematype.

              Parameters

              • options: any

              Returns this

            lowercase

            • lowercase(shouldApply?): this

            • Adds a lowercase setter.

              Parameters

              • Optional shouldApply: boolean

              Returns this

            match

            • match(value, message): this

            • Sets a regexp validator.

              Parameters

              • value: RegExp
              • message: string

              Returns this

            maxlength

            • maxlength(value, message): this

            • Sets a maximum length validator.

              Parameters

              • value: number
              • message: string

              Returns this

            minlength

            • minlength(value, message): this

            • Sets a minimum length validator.

              Parameters

              • value: number
              • message: string

              Returns this

            ref

            • ref(ref): this

            • Set the model that this path refers to. This is the option that populate looks at to determine the foreign collection it should query.

              Parameters

              • ref: string | boolean | mongoose.Model<any, {}, {}, {}, any, any>

              Returns this

            required

            • required(required, message?): this

            • Adds a required validator to this SchemaType. The validator gets added to the front of this SchemaType's validators array using unshift().

              Parameters

              • required: boolean
              • Optional message: string

              Returns this

            select

            • select(val): this

            • Sets default select() behavior for this path.

              Parameters

              • val: boolean

              Returns this

            set

            • set(fn): this

            • Adds a setter to this schematype.

              Parameters

              • fn: Function

              Returns this

            sparse

            • sparse(bool): this

            • Declares a sparse index.

              Parameters

              • bool: boolean

              Returns this

            text

            • text(bool): this

            • Declares a full text index.

              Parameters

              • bool: boolean

              Returns this

            transform

            • transform(fn): this

            • Defines a custom function for transforming this path when converting a document to JSON.

              Parameters

              • fn: ((value) => any)
                  • (value): any

                  • Parameters

                    • value: any

                    Returns any

              Returns this

            trim

            • trim(shouldTrim?): this

            • Adds a trim setter.

              Parameters

              • Optional shouldTrim: boolean

              Returns this

            unique

            • unique(bool): this

            • Declares an unique index.

              Parameters

              • bool: boolean

              Returns this

            uppercase

            • uppercase(shouldApply?): this

            • Adds an uppercase setter.

              Parameters

              • Optional shouldApply: boolean

              Returns this

            validate

            • validate(obj, errorMsg?, type?): this

            • Adds validator(s) for this document path.

              Parameters

              • obj: RegExp | ((this, value, validatorProperties?) => any)
              • Optional errorMsg: string
              • Optional type: string

              Returns this

            Static cast

            • cast(caster?): Function

            • Get/set the function used to cast arbitrary values to this type.

              Parameters

              • Optional caster: boolean | Function

              Returns Function

            Static checkRequired

            • checkRequired(checkRequired?): ((v) => boolean)

            • Parameters

              • Optional checkRequired: ((v) => boolean)
                  • (v): boolean

                  • Parameters

                    • v: any

                    Returns boolean

              Returns ((v) => boolean)

                • (v): boolean

                • Parameters

                  • v: any

                  Returns boolean

            Static get

            • get(getter): void

            • Attaches a getter for all instances of this schema type.

              Parameters

              • getter: ((value) => any)
                  • (value): any

                  • Parameters

                    • value: any

                    Returns any

              Returns void

            Static set

            • set(option, value): void

            • Sets a default option for this schema type.

              Parameters

              • option: string
              • value: any

              Returns void

            Settings

            Member Visibility

            Theme

            On This Page

            constructorOptionsConstructordefaultOptionsinstanceisRequiredoptionspathschemavalidatorsschemaNamecastdefaultenumgetimmutableindexlowercasematchmaxlengthminlengthrefrequiredselectsetsparsetexttransformtrimuniqueuppercasevalidatecastcheckRequiredgetset