mockingoose--temp-fix v2.8.2
Mockingoose
A Jest package for mocking mongoose models
Installation
$ npm i mockingoose -D
Import the library
// using commonJS
const mockingoose = require('mockingoose').default;
// using es201x
import mockingoose from 'mockingoose';
Usage
// user.js
import mongoose from 'mongoose';
const { Schema } = mongoose;
const schema = Schema({
name: String,
email: String,
created: { type: Date, default: Date.now }
})
export default mongoose.model('User', schema);
mockingoose#ModelName#toReturn(obj, operation = 'find')
// __tests__/user.test.js
import mockingoose from 'mockingoose';
import model from './model';
describe('test mongoose User model', () => {
it('should return the doc with findById', () => {
const _doc = {
_id: '507f191e810c19729de860ea',
name: 'name',
email: 'name@email.com'
};
mockingoose.User.toReturn(_doc, 'findOne'); // findById is findOne
return model
.findById({ _id: '507f191e810c19729de860ea'})
.then(doc => {
expect(JSON.parse(JSON.stringify(doc)).toMatchObject(_doc);
})
})
it('should return the doc with update', () => {
const _doc = {
_id: '507f191e810c19729de860ea',
name: 'name',
email: 'name@email.com'
};
mockingoose.User.toReturn(doc, 'update');
return model
.update({ name: 'changed' }) // this won't really change anything
.where({ _id: '507f191e810c19729de860ea'})
.then(doc => {
expect(JSON.parse(JSON.stringify(doc)).toMatchObject(_doc);
})
})
})
mockingoose#ModelName#reset(operation = undefined)
will reset Model mock, if pass an operation, will reset only this operation mock.
it('should reset model mock', () => {
mockingoose.User.toReturn({ name: '1' });
mockingoose.User.toReturn({ name: '2' }, 'save');
mockingoose.User.reset(); // will reset all operations;
mockingoose.User.reset('find'); // will reset only find operations;
})
you can also chain mockingoose#ModelName
operations:
mockingoose.User
.toReturn({ name: 'name' })
.toReturn({ name: 'a name too' }, 'findOne')
.toReturn({ name: 'another name' }, 'save')
.reset('find');
mockingoose#resetAll()
will reset all mocks.
beforeEach(() => {
mockingoose.resetAll();
})
Operations available:
find
- for find queryfindOne
- for findOne querycount
- for count querydistinct
- for distinct queryfindOneAndUpdate
- for findOneAndUpdate queryfindOneAndRemove
- for findOneAndRemove queryupdate
- for update querysave
- for create, and save documentsModel.create()
orModel.save()
ordoc.save()
remove
- for remove querydeleteOne
- for deleteOne querydeleteMany
- for deleteMany query
Notes
All operations works with exec
, promise
and callback
.
if you are using Model.create
and you don't pass a mock with mockingoose,
you'll receive the mongoose created doc (with ObjectId and transformations)
validations are working as expected.
the returned document is an instance of mongoose Model.
update
operation returns original mocked object.
you can simulate Error by passing an Error to mockingoose:
mockingoose.User.toReturn(new Error('My Error'), 'save');
return User
.create({ name: 'name', email: 'name@email.com' })
.catch(err => {
expect(err.message).toBe('My Error');
})
no connection is made to the database (mongoose.connect is jest.fn())
will work with node 6.4.x. tested with mongoose 4.x and jest 20.x.
check tests for more, feel free to fork and contribute.