How to Connect Node to a MongoDB Database ?

Last Updated : 27 Jan, 2025

Connecting Node.js to MongoDB is a common task for backend developers working with NoSQL databases. MongoDB is a powerful, flexible, and scalable database that stores data in a JSON-like format.

In this step-by-step guide, we’ll walk through the entire process from setting up your development environment to advanced techniques, ensuring you’re equipped to connect Node.js with MongoDB efficiently.

What is MongoDB and Mongoose?

MongoDB: A NoSQL database designed for handling large amounts of unstructured data. Unlike traditional relational databases that use tables with rows and columns to store data, MongoDB uses a flexible document-based model. Data is stored in collections and documents where each document is a JSON-like object

Mongoose: An Object Data Modeling (ODM) library for Node.js that simplifies working with MongoDB. It provides predefined methods for schema validation, database connection, and querying. It provides a higher-level abstraction over the native MongoDB driver, making it easier to define data structures and enforce validation rules.

Step-by-Step Guide to Connect Node.js to MongoDB

Connecting Node.js to MongoDB is essential for building scalable and efficient backend applications. This guide will walk you through the necessary steps to establish a seamless connection and interact with MongoDB using Mongoose.

Step 1: Install mongoose in your system using the below command.

Before you begin, ensure you have Node.js and npm installed on your system. To install Mongoose, run the following command in your terminal or command prompt:

npm install mongoose

Mongoose will allow us to interact with MongoDB using JavaScript in an easier, more efficient manner.

Step 2: Import Mongoose in Your Node.js Application

To connect a Node.js application to MongoDB, we have to use a library called Mongoose.

const mongoose = require("mongoose");

Step 3: Establish a Connection to MongoDB

Use Mongoose’s connect() method to establish a connection with MongoDB. Here’s how to connect to a local MongoDB instance:

mongoose.connect("mongodb://localhost:27017/collectionName", {    useNewUrlParser: true,    useUnifiedTopology: true });

mongodb://localhost:27017/yourDatabaseName: Replace yourDatabaseName with the name of your MongoDB database.
useNewUrlParser and useUnifiedTopology: These options ensure that you are using the latest MongoDB connection logic and avoid deprecation warnings.

Step 4: Define the Schema

Schemas define the structure of the documents in your collection. They specify the types of data stored and can enforce rules like required fields and default values. Here’s an example of a simple schema for storing contact form submissions:

const contactSchema = new mongoose.Schema({   email: { type: String, required: true },   query: { type: String, required: true }, });

mongoose.Schema: Defines the structure of the MongoDB document.
required: true: Specifies that these fields must be provided when creating a document.

Step 5: Create a Model with the defined schema

Once you’ve defined the schema, the next step is to create a model. A model is a wrapper around the schema and allows you to interact with MongoDB collections (e.g., create, read, update, delete operations).

const Contact = mongoose.model("Contact", contactSchema);

The model will automatically map to the contacts collection in MongoDB.

Step 6: Handling Form Submission and Storing Data

Let’s implement the functionality to store data submitted from a contact form in MongoDB. When a user submits the form, the data will be saved to the MongoDB database. Then, finally, we are able to store data in our document.

const express = require('express'); const app = express(); app.use(express.urlencoded({ extended: true }));  app.post('/contact', (req, res) => {   const contact = new Contact({     email: req.body.email,     query: req.body.query,   });    contact.save((err) => {     if (err) {       return res.status(500).send('Error saving data');     }     res.redirect('/thank-you');   }); });  app.listen(3000, () => {   console.log('Server running on port 3000'); });

Express: A minimal web application framework for Node.js used to handle HTTP requests. It simplifies routing and handling form data.
contact.save(): Saves the document to MongoDB. If successful, it redirects to a “Thank You” page.

Step 7: MongoDB CRUD Operations with Mongoose

After setting up the connection and model, it’s essential to understand how to perform basic CRUD (Create, Read, Update, Delete) operations with Mongoose.

1. Create: Insert a new document.

const newContact = new Contact({ email: "[email protected]", query: "How do I use MongoDB?" }); newContact.save();

2. Read: Retrieve documents from the collection.

Contact.find({}, (err, contacts) => {   if (err) throw err;   console.log(contacts); });

3. Update: Modify existing documents.

Contact.updateOne({ email: "[email protected]" }, { $set: { query: "New query" } }, (err) => {   if (err) throw err;   console.log("Document updated"); });

4. Delete: Remove documents from the collection.

Contact.deleteOne({ email: "[email protected]" }, (err) => {   if (err) throw err;   console.log("Document deleted"); });

Advanced Concepts for Connecting Node.js to MongoDB

1. Using MongoDB Atlas for Cloud Hosting

MongoDB Atlas is a fully-managed cloud database service. It simplifies MongoDB hosting with automated backups, scaling, and security.
To connect your Node.js application to MongoDB Atlas, simply replace the local connection string with the one provided by Atlas:

mongoose.connect("mongodb+srv://username:[email protected]/yourDatabase", { useNewUrlParser: true, useUnifiedTopology: true });

2. Mongoose Middleware (Hooks)

Mongoose allows you to define pre- and post- hooks to run certain functions before or after an operation like saving a document.

Example of pre-save hook:

contactSchema.pre('save', function(next) {   this.email = this.email.toLowerCase();   next(); });

3. Aggregation Framework in MongoDB

MongoDB’s aggregation framework allows you to process data records and return computed results. This is useful for tasks like filtering, sorting, and summarizing data.

Example aggregation to group contacts by their email domain:

Contact.aggregate([   { $group: { _id: { $substr: ["$email", 0, 5] }, count: { $sum: 1 } } } ]).exec((err, result) => {   if (err) throw err;   console.log(result); });

Best Practices for Connecting Node.js to MongoDB

Handle Errors: Always implement error handling to ensure your application doesn’t crash due to database connection or query issues.
Environment Variables: Store sensitive information such as database URIs, credentials, and secrets in environment variables using .env files.
Indexing: Use MongoDB indexing for faster querying, especially with large datasets.
Connection Pooling: Use Mongoose’s built-in connection pooling to manage multiple database connections efficiently.

Example: HTML Form for Contact Submission

Here’s an example of a simple contact form that interacts with the Node.js application:

<!DOCTYPE html> <html lang="en">  <head>     <meta charset="UTF-8">     <meta http-equiv="X-UA-Compatible"            content="IE=edge">     <meta name="viewport"            content="width=device-width,                     initial-scale=1.0">     <title>Document</title> </head>  <body>     <form action="/contact" method="post">         <input type="text"                 placeholder="Email"                 name="email">         <input type="text"                 placeholder="Query"                 name="query">         <button type="submit">             Submit         </button>     </form> </body>  </html>

Output

Conclusion

Connecting Node.js to MongoDB with Mongoose simplifies database interactions and offers powerful tools for working with MongoDB’s NoSQL architecture. By following this guide, we can easily integrate MongoDB into your Node.js applications and handle everything from basic CRUD operations to advanced features like aggregation and middleware. With its ease of use and flexibility, Mongoose helps streamline database management and improves productivity.

How to Connect Mongodb Compass to Flask

devaadi

Improve

Article Tags :