Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including mockgoose with all npm packages installed. Try it out:

var mockgoose = require("mockgoose")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

mockgoose v8.0.4

Mockgoose is an in memory database mock to allow for testing of applications that rely on Mongoose.

Warning: This package has been deprecated! Consider using mongodb-memory-server instead.

Build Status

Please Share on Twitter if you like #mockgoose

What is Mockgoose?

Mockgoose provides test database by spinning up mongod on the back when mongoose.connect call is made. By default it is using in memory store which does not have persistence.

Install

To install the latest official version, use NPM:

npm install mockgoose --save-dev

Usage

You simply require Mongoose and Mockgoose and wrap Mongoose with Mockgoose.

var mongoose = require('mongoose');
var Mockgoose = require('mockgoose').Mockgoose;
var mockgoose = new Mockgoose(mongoose);

mockgoose.prepareStorage().then(function() {
    // mongoose connection      
});

Once Mongoose has been wrapped by Mockgoose connect() will be intercepted by Mockgoose so that no MongoDB instance is created.

Mocha

Default mocha timeout is 2000ms, change it to two minutes.

mocha --timeout 120000

Same can be done by creating 'mocha.opts' file in your test directory with "--timeout 120000" entry.

Example

var Mongoose = require('mongoose').Mongoose;
var mongoose = new Mongoose();

var Mockgoose = require('mockgoose').Mockgoose;
var mockgoose = new Mockgoose(mongoose);

before(function(done) {
    mockgoose.prepareStorage().then(function() {
        mongoose.connect('mongodb://example.com/TestingDB', function(err) {
            done(err);
        });
    });
});

describe('...', function() {
    it("...", function(done) {
        // ...
        done();
    });
});

ES6 Example without mocha

import * as mongoose from 'mongoose';
import {Mockgoose} from 'mockgoose';

let mockgoose: Mockgoose = new Mockgoose(mongoose);

mockgoose.prepareStorage().then(() => {
    mongoose.connect('mongodb://foobar/baz');
    mongoose.connection.on('connected', () => {  
      console.log('db connection is now open');
    }); 
});

Helper methods and variables (mockgoose.helper)

reset(callback)

Reset method will remove ALL of the collections from a temporary store, note that this method is part of mockgoose object, and not defined under mongoose

mockgoose.helper.reset().then(() => {
    done()
});

isMocked

Returns TRUE from mongoose object if Mockgoose is applied

if ( mockgoose.helper.isMocked() === true ) {
  // mongoose object is mocked
}

setDbVersion(mongoDBVersion: string)

Set version of MongoDB release

import * as mongoose from 'mongoose';
import {Mockgoose} from 'mockgoose';

let mockgoose: Mockgoose = new Mockgoose(mongoose);
mockgoose.helper.setDbVersion("3.2.1");

mockgoose.prepareStorage().then(() => {
    mongoose.connect('mongodb://foobar/baz');
    mongoose.connection.on('connected', () => {  
      console.log('db connection is now open');
    }); 
});

setProxy(proxy: string)

Set proxy for downloading MongoDB release

import * as mongoose from 'mongoose';
import {Mockgoose} from 'mockgoose';

let mockgoose: Mockgoose = new Mockgoose(mongoose);

let proxy: string = process.env.http_proxy || 'http://example.com:8080';
mockgoose.helper.setProxy(proxy);

mockgoose.prepareStorage().then(() => {
    mongoose.connect('mongodb://foobar/baz');
    mongoose.connection.on('connected', () => {  
      console.log('db connection is now open');
    }); 
});

Development

This section contains instructions for developers working on the Mockgoose codebase. It is not relevant if you just want to use Mockgoose as a library in your project.

Pre-requisites

  • Node.js >= 6

Setup

git clone git@github.com:Mockgoose/Mockgoose.git
cd Mockgoose
npm install
npm test
RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free