Skip to content
A Jest package for mocking mongoose models
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci 🔧 change step to test Oct 7, 2018
.babelrc mockingoose version 1.0.0 Jul 7, 2017
.npmrc 📇 add emoji for npm commit Jul 24, 2017
LICENSE Initial commit Jul 5, 2017 Feature/estimated document count (#43) Oct 31, 2018

Mockingoose CircleCI


A Jest package for mocking mongoose models


$ npm i mockingoose -D

Import the library

// using commonJS
const mockingoose = require('mockingoose').default;

// using es201x
import mockingoose from 'mockingoose';


// user.js
import mongoose from 'mongoose';
const { Schema } = mongoose;

const schema = Schema({
    name: String,
    email: String,
    created: { type: Date, default: }

export default mongoose.model('User', schema);

mockingoose#ModelName#toReturn(obj, operation = 'find')

// __tests__/user.test.js
import mockingoose from 'mockingoose';
import model from './user';

describe('test mongoose User model', () => {
  it('should return the doc with findById', () => {
    const _doc = {
        _id: '507f191e810c19729de860ea',
        name: 'name',
        email: ''
    mockingoose.User.toReturn(_doc, 'findOne'); // findById is findOne
    return model
    .findById({ _id: '507f191e810c19729de860ea'})
    .then(doc => {
  it('should return the doc with update', () => {
      const _doc = {
          _id: '507f191e810c19729de860ea',
          name: 'name',
          email: ''
      mockingoose.User.toReturn(doc, 'update');
      return model
      .update({ name: 'changed' }) // this won't really change anything
      .where({ _id: '507f191e810c19729de860ea'})
      .then(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:

        .toReturn({ name: 'name' })
        .toReturn({ name: 'a name too' }, 'findOne')
        .toReturn({ name: 'another name' }, 'save')


will reset all mocks.

beforeEach(() => {

Operations available:

  • find - for find query
  • findOne - for findOne query
  • count - for count query (deprecated)
  • countDocuments for count query
  • estimatedDocumentCount for count collection documents
  • 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 or
  • remove - for remove query
  • deleteOne - for deleteOne query
  • deleteMany - for deleteMany query
  • aggregate - for aggregate framework


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: '' })
    .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.


  • Return Jest.fn for mock
  • Support Model.aggregate
You can’t perform that action at this time.