Skip to main content

Known Issues

Known Issues

Please look here first, to decide if it is a Typegoose or a Mongoose issue.

transpile-only

It is not recommended to run compilers with option transpile-only (like tsc --transpile-only or ts-node --transpile-only), because this will act like not having emitDecoratorMetadata enabled, see Use Without "emitDecoratorMetadata".

tsconfig-paths

TypeScript provides the option to alias paths (with tsconfig-paths) but is somehow incompatible with Typegoose, more info in here.

Self-Containing classes

It is currently not (and probably never) possible to use a self-containing class:

class SomeClass {
@prop()
public ref: SomeClass; // ERROR "Maximum Class Stack Size Exceeded"
}

Though Deferred Reference will still work:

class SomeClass {
@prop({ ref: () => SomeClass }) // or hardcode the string
public ref: Ref<SomeClass>;
}

Babel

This Section may be outdated

Using babel as a TypeScript compiler is known to cause problems (like incorrect types) (see transpile-only), it is recommended you use tsc, ts-node or ts-jest directly.

If Babel is still needed, then read Babel TypeScript preset and install the following plugins:

info

emitDecoratorMetadata is not strictly needed, see Use Without emitDecoratorMetadata.

module.exports = {
plugins: [
['@babel/plugin-proposal-decorators', { legacy: true }],
'babel-plugin-transform-typescript-metadata',
['@babel/plugin-proposal-class-properties', { loose: true }],
]
}

prop on get & set

@prop cannot be applied to get & set (ES6 class keywords), because virtuals do not accept options & schema.loadClass wouldn't load these.

Webpack

Webpack's minimize cannot be used with typegoose, because typegoose relies heavily on reflection and property names.

In webpack, it can be disabled when adding the following to the webpack config:

module.exports = {
optimization: {
minimize: false
}
}
note

There are some workarounds for some minification problems, like the class name (which would be the model name) can be changed with customName.

@types/node breaking change

Early January 2022, there was a update in @types/node, which was actually a breaking change which causes typescript compile errors to show up (like for GridFSBucketWriteStream from mongodb, even though unused).

The current only workaround is to pin the versions of @types/node used to ones before the update, which in the case of typegoose is @types/node@12.20.39.
As of 02-02-2022 (d/m/y), mongoose has released 6.2.0 which upgraded mongodb to a version that has updated types, and typegoose 9.6.0 uses this mongoose version.

NodeJS 17.5 Breaking Change

NodeJS 17.5 was released, which included a breaking change for mongoose, which resulted in a error (/ crash of the application).

Mongoose has released version 6.2.2 on 16.2.22 (d/m/y) which fixes the issue on mongoose's side.
Since 24.2.22 (d/m/y) NodeJS 17.6 is released which should include the fix.

DocumentType is not generic

Typescript has its own DocumentType when having DOM enabled in tsconfig option lib, in any case the correct DocumentType has to be imported directly from typegoose.
It is also recommended to remove the option DOM from the tsconfig option lib when possible.

Typescript 5.0 ES Decorators

Typescript 5.0 has support for ES Decorators (Stage 3) so @decorator is now valid syntax whether experimentalDecorators is true or false (Stage 2), but the implementations are not type and runtime compatible and would require special handling, also the new ES Decorators (Stage 3) dont support metadata, which typegoose heavily relies on. (and no use without emitDecoratorMetadata cannot be used as a workaround).

TL;DR: typegoose currently does not support ES Decorators (Stage 3) and experimentalDecorators: true has to be enabled.

Example Error: Unable to resolve signature of property decorator when called as an expression. Argument of type 'undefined' is not assignable to parameter of type 'Object'.ts(1240)

Deferred function with explicit function

When deferred functions are using with explicit functions, then the expected resulting type is not actually returned.

Example of a deferred function: type: () => Something
Example of a explicit function: type: function() { return Something; }

Explicit functions can implicitly occur if the tsconfig's target is not set to at least es6.

The reason currently is that there is not a good way to differentiate between classes¹, functions like String², and other function like mongoose's types³ which are callable without new (could likely be worked around), but it is not worth the performance to check for all of this and likely also does not cover all the bases.

  • ¹: classes could be differentiated with /^class\s/.test(Function.prototype.toString.call(obj))
  • ²: native types could be differentiated with /\[native code\]/.test(Function.prototype.toString.call(obj)), but what about mocked or proxied types?
  • ³: could likely be differenitated by matching references & names against mongoose.Types.* and mongoose.Schema.Types.*