Skip to content
Jest preset for MongoDB in-memory server
JavaScript
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci docs: update mongodb downloads dir May 3, 2019
.editorconfig chore: initial commit Feb 14, 2018
.eslintignore style: apply eslint fixes Oct 17, 2019
.eslintrc style: switch to shelf eslint config Apr 12, 2019
.gitattributes chore: initial commit Feb 14, 2018
.gitignore
.npmrc chore: initial commit Feb 14, 2018
.prettierrc.json chore: initial commit Feb 14, 2018
environment.js feat: replace console.log with debug May 3, 2019
jest-mongodb-config.js chore: upd npm deps Apr 12, 2019
jest-preset.js feat: make a jest preset out of this example Apr 12, 2019
license chore: transfer repo to shelf org Apr 12, 2019
mongo-aggregate.test.js docs: use process.env.MONGO_URL, get rid of global.__MONGO_DB_NAME__ … Oct 17, 2019
mongo-insert.test.js docs: use process.env.MONGO_URL, get rid of global.__MONGO_DB_NAME__ … Oct 17, 2019
package.json v1.1.2 Oct 17, 2019
readme.md docs: mention how to clean collections before tests Oct 17, 2019
renovate.json chore: use shelf renovate config Jun 20, 2019
setup.js Update mongoDBName to jest-mongodb-config instance dbName Sep 19, 2019
teardown.js feat: replace console.log with debug May 3, 2019

readme.md

jest-mongodb CircleCI npm (scoped)

Jest preset to run MongoDB memory server

Usage

0. Install

$ yarn add @shelf/jest-mongodb --dev

Make sure mongodb is installed in the project as well, as it's required as a peer dependency.

1. Create jest.config.js

module.exports = {
  preset: '@shelf/jest-mongodb'
};

If you have a custom jest.config.js make sure you remove testEnvironment property, otherwise it will conflict with the preset.

2. Create jest-mongodb-config.js

See mongodb-memory-server

module.exports = {
  mongodbMemoryServerOptions: {
    instance: {
      dbName: 'jest'
    },
    binary: {
      version: '4.0.3',
      skipMD5: true
    },
    autoStart: false
  }
};

3. Configure MongoDB client

Library sets the process.env.MONGO_URL for your convenience

const {MongoClient} = require('mongodb');

describe('insert', () => {
  let connection;
  let db;

  beforeAll(async () => {
    connection = await MongoClient.connect(process.env.MONGO_URL, {
      useNewUrlParser: true,
      useUnifiedTopology: true
    });
    db = await connection.db();
  });

  afterAll(async () => {
    await connection.close();
  });
});

4. PROFIT! Write tests

it('should insert a doc into collection', async () => {
  const users = db.collection('users');

  const mockUser = {_id: 'some-user-id', name: 'John'};
  await users.insertOne(mockUser);

  const insertedUser = await users.findOne({_id: 'some-user-id'});
  expect(insertedUser).toEqual(mockUser);
});

Cache MongoDB binary in CI by putting this folder to the list of cached paths: ./node_modules/.cache/mongodb-memory-server/mongodb-binaries

You can enable debug logs by setting environment variable DEBUG=jest-mongodb:*

5. Clean collections before each test (optional)

beforeEach(async () => {
  await db.collection('COLLECTION_NAME').deleteMany({});
});

See this issue for discussion

See Also

License

MIT © Shelf

You can’t perform that action at this time.