Easy JSON fixture loading for MongoDB. Makes managing document relationships easier. This is a forked version of pow-mongodb-fixtures


301.0.25 years ago5 years agoMinified + gzip package size for @coorpacademy/mongo-fixme in KB



Build Status

This is a forked version of pow-mongodb-fixtures

Simple fixture loader for MongoDB on NodeJS. Makes managing relationships between documents easier.

Fixtures can be in one file, or divided up into separate files for organisation (e.g. one file per model)

The fixture files must export objects which are keyed by the MongoDB collection name, each containing the data for documents within that.

FOR EXAMPLE: With the file below, 3 documents will be inserted into the 'users' collection and 2 into the 'businesses' collection:

exports.users = [
    { name: 'Gob' },
    { name: 'Buster' },
    { name: 'Steve Holt' }

exports.businesses = [
    { name: 'The Banana Stand' },
    { name: 'Bluth Homes' }

You can also load fixtures as an object where each document is keyed, in case you want to reference another document. This example uses the included createObjectId helper:

var id = require('mongo-fixme').createObjectId;

var users = exports.users = {
    user1: {
        _id: id(),
        name: 'Michael'
    user2: {
        _id: id(),
        name: 'George Michael',
        father: users.user1._id
    user3: {
        _id: id('4ed2b809d7446b9a0e000014'),
        name: 'Tobias'

CLI usage

A CLI program is included for quickly loading fixture files. To use it install the module globally:

npm install mongo-fixme -g

Then use the program to install a file or directory:

mongofixtures <dbname> <fixture file>

mongofixtures appdb fixtures/users.js


connect(dbname, options)

Returns a new Loader instance, configured to interact with a certain database.


  • host (Default: localhost)
  • port (Default: 27017)
  • user
  • pass
  • safe (Default: false)


var fixtures = require('mongo-fixme').connect('dbname');

var fixtures2 = require('mongo-fixme').connect('dbname', {
  host: 'http://dbhost.com/',
  port: 1234

load(data, callback)

Adds documents to the relevant collection. If the collection doesn't exist it will be created first.

var fixtures = require('mongo-fixme').connect('mydb');

    users: [
        { name: 'Maeby' },
        { name: 'George Michael' }
}, callback);

fixtures.load(__dirname + '/fixtures/users.js', cb);

//Directories (loads all files in the directory)
fixtures.load(__dirname + '/fixtures', callback);


Clears existing data.

fixtures.clear(function(err) {
    //Drops the database

fixtures.clear('foo', function(err) {
    //Clears the 'foo' collection

fixtures.clear(['foo', 'bar'], function(err) {
    //Clears the 'foo' and 'bar' collections

clearAllAndLoad(data, callback)

Drops the database (clear all collections) and loads data.

clearAndLoad(data, callback)

Clears the collections that have documents in the data that is passed in, and then loads data.

var data = { users: [...] };

fixtures.clearAndLoad(data, function(err) {
    //Clears only the 'users' collection then loads data


Adds a modifier (function) which gets called for each document that is to be inserted. The signature of this function should be:

(collectionName, document, callback)
  • collectionName - name of collection
  • document - the document which is to be inserted
  • callback - function with signature (err, modifiedDocument). This should be called with the modified document.

Modifiers are chained in the order in which they're added. For example:

var data = { users: [...] };

// this modifier will get called first
fixtures.addModifier(function(collectionName, doc, cb) {
  doc.createdAt = new Date();

  cb(null, doc);

// this modifier will get called second with the result from the first modifier call
fixtures.addModifier(function(collectionName, doc, cb) {
  doc.updatedAt = new Date();

  cb(null, doc);

fixtures.load(data, function(err) {
    // each loaded data item will have the createdAt and updatedAt keys set.


npm install mongo-fixme



  • fix npm deploy key


  • fix tag


  • breaking change doesn't support node 0.10 & 0.12
  • support node 5 and node 6
  • async: 2.0.0-rc.6
  • bson: 0.4.23
  • lodash: 4.13.1
  • mongodb: 2.1.18


  • Update mongodb driver to 1.4.31
  • fix mongo db minor version
  • replace underscore to lodash
  • rename project to mongodb-fixtures
  • add npm test support


  • Update mongodb driver to 1.3.x
  • Add ability to connect with URI
  • Make safe mode the default


  • Add mongofixtures CLI program


  • Add 'safe' option (donnut)


  • Add user and password options for connecting to authenticated/remote DBs


  • Add username and password connect options


  • Make clear be safe


  • Windows fixes (samitny)


  • Ignore subdirectories (hiddentao)

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.