I am currently trying to add a static method to my mongoose schema but I can\'t find the reason why it doesn\'t work this way.
My model:
import * as
I was having the same problem as you, and then finally managed to resolve it after reading the documentation in the TS mongoose typings (which I didn't know about before, and I'm not sure how long the docs have been around), specifically this section.
As for your case, you'll want to follow a similar pattern to what you currently have, although you'll need to change a few things in both files.
IUser file
IUser
to IUserDocument
. This is to separate your schema from your instance methods.Document
from mongoose.Document
.Model file
IUser
to IUserDocument
, including the module path if you rename the file.IUserModel
to IUser
.IUser
extends from, from IUserDocument, Document
to IUserDocument
.IUserModel
which extends from Model<IUser>
.IUserModel
.User
constant type from Model<IUserModel>
to IUserModel
, as IUserModel
now extends Model<IUser>
.<IUserModel>
to <IUser, IUserModel>
.Here's what your model file would look like with those changes:
import * as bcrypt from 'bcryptjs';
import { Document, Schema, Model, model } from 'mongoose';
import { IUserDocument } from '../interfaces/IUserDocument';
export interface IUser extends IUserDocument {
comparePassword(password: string): boolean;
}
export interface IUserModel extends Model<IUser> {
hashPassword(password: string): string;
}
export const userSchema: Schema = new Schema({
email: { type: String, index: { unique: true }, required: true },
name: { type: String, index: { unique: true }, required: true },
password: { type: String, required: true }
});
userSchema.method('comparePassword', function (password: string): boolean {
if (bcrypt.compareSync(password, this.password)) return true;
return false;
});
userSchema.static('hashPassword', (password: string): string => {
return bcrypt.hashSync(password);
});
export const User: IUserModel = model<IUser, IUserModel>('User', userSchema);
export default User;
And your (newly renamed) ../interfaces/IUserDocument
module would look like this:
import { Document } from 'mongoose';
export interface IUserDocument extends Document {
email: string;
name: string;
password: string;
}
For future readers:
Remember that we are dealing with two different Mongo/Mongoose concepts: a Model, and Documents.
Many Documents can be created from a single Model. The Model is the blueprint, the Document is the thing created according to the Model's instructions.
Each Document contains its own data. Each also carries their own individual instance methods which are tied to its own this
and only operate on that one specific instance.
The Model can have 'static' methods which are not tied to a specific Document instance, but operate over the whole collection of Documents.
How this all relates to TypeScript:
.method
functions..static
functions.The other answers here have decent code, so look at them and trace through the differences between how Documents are defined and how Models are defined.
And remember when you go to use these things in your code, the Model is used to create new Documents and to call static methods like User.findOne
or your custom statics (like User.hashPassword
is defined above).
And Documents are what you use to access the specific data from the object, or to call instance methods like this.save
and custom instance methods like this.comparePassword
defined above.
I think you are having the same issue that I just struggled with. This issue is in your call. Several tutorials have you call the .comparePassword()
method from the model like this.
User.comparePassword(candidate, cb...)
This doesn't work because the method is is on the schema
not on the model
. The only way I was able to call the method was by finding this instance of the model using the standard mongoose/mongo query methods.
Here is relevant part of my passport middleware:
passport.use(
new LocalStrategy({
usernameField: 'email'
},
function (email: string, password: string, done: any) {
User.findOne({ email: email }, function (err: Error, user: IUserModel) {
if (err) throw err;
if (!user) return done(null, false, { msg: 'unknown User' });
user.schema.methods.comparePassword(password, user.password, function (error: Error, isMatch: boolean) {
if (error) throw error;
if (!isMatch) return done(null, false, { msg: 'Invalid password' });
else {
console.log('it was a match'); // lost my $HÏT when I saw it
return done(null, user);
}
})
})
})
);
So I used findOne({})
to get the document instance and then had to access the schema methods by digging into the schema properties on the document user.schema.methods.comparePassword
A couple of differences that I noticed:
instance
method while yours is a static
method. I'm confident that there is a similar method access strategy.comparePassword()
function. perhaps this isn't necessary on statics, but I was unable to access this.password
I cannot see your IUser interface however I suspect that you have not included the methods in there. EG
export interface IUser {
email: string,
hash: string,
salt: string,
setPassword(password: string): void,
validPassword(password: string): boolean,
generateJwt(): string
}
typescript will then recognize your methods and stop complaining
So the one with 70 updates I also gave an upvote. But it is not a complete solution. He uses a trivial example based on the OP. However, more often than not when we use statics
and methods
in order to extend the functionality of the model, we want to reference the model itself. The problem with his solution is he using a callback function which means the value of this
will not refer to the class context but rather a global.
The first step is to invoke the statics
property rather than pass the property as an argument to the static
function:
schema.statics.hashPassword
Now we cannot assign an arrow function to this member, for this
inside the arrow function will still refer to the global object! We have to use function expression syntax in order to capture this
in the context of the model:
schema.statics.hashPassword = async function(password: string): Promise<string> {
console.log('the number of users: ', await this.count({}));
...
}