Docs Menu

Docs Home → Develop Applications → MongoDB Drivers → Node.js

Quick Reference

This page shows the driver syntax for several MongoDB commands and links to their related reference and API documentation.

Compatibility

You can use the Node.js driver to connect and execute commands for deployments hosted in the following environments:

  • MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

  • MongoDB Enterprise: The subscription-based, self-managed version of MongoDB

  • MongoDB Community: The source-available, free-to-use, and self-managed version of MongoDB

To learn more about performing common CRUD operations in the Atlas UI for deployments hosted in MongoDB Atlas, see Create, View, Update, and Delete Documents.

Command
Syntax
Find a Document

API Documentation
Usage Example
Fundamentals
await coll.findOne({ title: 'Hamlet' });
Find Multiple Documents

API Documentation
Usage Example
Fundamentals
coll.find({ year: 2005 });
Insert a Document

API Documentation
Usage Example
Fundamentals
await coll.insertOne({ title: 'Jackie Robinson' });
Insert Multiple Documents

API Documentation
Usage Example
Fundamentals
await coll.insertMany([
  { title: 'Dangal', rating: 'Not Rated' },
  { title: 'The Boss Baby', rating: 'PG' }
 ]);
Update a Document

API Documentation
Usage Example
Fundamentals
await coll.updateOne(
  { title: 'Amadeus' },
  { $set: { 'imdb.rating': 9.5 } }
);
Update Multiple Documents

API Documentation
Usage Example
Fundamentals
await coll.updateMany(
  { year: 2001 },
  { $inc: { 'imdb.votes': 100 } }
);
Update Arrays in Documents

API Documentation
Fundamentals
await coll.updateOne(
  { title: 'Cosmos' },
  { $push: { genres: 'Educational' } }
):
Replace a Document

API Documentation
Usage Example
Fundamentals
await coll.replaceOne(
  { name: 'Deli Llama', address: '2 Nassau St' },
  { name: 'Lord of the Wings', zipcode: 10001 }
);
Delete a Document

API Documentation
Usage Example
Fundamentals
await coll.deleteOne({ title: 'Congo' });
Delete Multiple Documents

API Documentation
Usage Example
Fundamentals
await coll.deleteMany({ title: { $regex: /^Shark.*/ } });
Bulk Write

API Documentation
Usage Example
await coll.bulkWrite([
  {
    insertOne: {
      document: {
        title: 'A New Movie',
        year: 2022
      }
    }
  },
  {
    deleteMany: {
      filter: { year: { $lt: 1970 } }
    }
  }
]);
Watch for Changes

API Documentation
Usage Example
Fundamentals
coll.watch([ { $match: { year: { $gte: 2022 } } } ]);
Access Data from a Cursor Iteratively

API Documentation
Fundamentals
const cursor = coll.find();
await cursor.forEach(console.dir);
Access Data from a Cursor as an Array

API Documentation
Fundamentals
const cursor = coll.find();
const results = await cursor.toArray();
Count Documents

API Documentation
Usage Example
await coll.countDocuments({ year: 2000 });
List the Distinct Documents or Field Values
API Documentation
Usage Example
Fundamentals
await coll.distinct('year');
Limit the Number of Documents Retrieved

API Documentation
Fundamentals
coll.find().limit(2);
Skip Retrieved Documents

API Documentation
Fundamentals
collection.find({ title: { $regex: /^Rocky/} }, { skip: 2 });
Sort the Documents When Retrieving Them

API Documentation
Fundamentals
coll.find().sort({ year: 1});
Project Document Fields When Retrieving Them

API Documentation
Fundamentals
coll.find().project({ _id: 0, year: 1, imdb: 1 });
Create an Index

API Documentation
Fundamentals
await coll.createIndex({ title: 1, year: -1 });
Search Text

API Documentation
Fundamentals
// only searches fields with text indexes
coll.find({ $text: { $search: 'zissou' } });
Install the Driver Dependency
package.json
"dependencies": {
  "mongodb": "^4.8",
  ...
}
←  Quick StartWhat's New →