mockingoose

Mockingoose

A Jest package for mocking mongoose models

Installation

$ npm i mockingoose -D

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: '[e-mail]'
    };
    
    mockingoose.User.toReturn(_doc); // operation `find` is default
    
    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: '[e-mail]'
      };
      
      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;
})

mockingoose#resetAll()

will reset all mocks.

beforeEach(() => {
  mockingoose.resetAll();
})

Operation available:

• find - for find query
• findOne - for findOne query
• count - for count query
• distinct - for distinct query
• findOneAndUpdate - for findOneAndUpdate query
• findOneAndRemove - for findOneAndRemove query
• update - for update query
• save - for create, and save documents Model.create() or Model.save() or doc.save()
• remove - for remove query
• deleteOne - for deleteOne query
• deleteMany - 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.

you can simulate Error by passing an Error to mockingoose:

mockingoose.User.toReturn(new Error(), 'save');

return User
    .create({ email: '[e-mail]' })
    .catch(err => {
      expect(err).toBeInstanceOf(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.