How to Connect to MongoDB: Simple Steps for Beginners

To connect to MongoDB, use the official MongoDB driver and provide a connection string with your database URL inside MongoClient. Then call connect() to establish the connection before performing database operations.

Syntax

The basic syntax to connect to MongoDB involves creating a MongoClient instance with a connection string, then calling connect() to open the connection.

• MongoClient: The main class to manage connections.
• connection string: URL that specifies the MongoDB server address and options.
• connect(): Method to establish the connection asynchronously.

javascript

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

const uri = "mongodb+srv://username:[e-mail]/myDatabase?retryWrites=true&w=majority";
const client = new MongoClient(uri);

async function run() {
  try {
    await client.connect();
    // Use the client here
  } finally {
    await client.close();
  }
}

run().catch(console.dir);

Example

This example demonstrates connecting to a MongoDB database, listing the database names, and then closing the connection.

javascript

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

const uri = "mongodb+srv://username:[e-mail]/?retryWrites=true&w=majority";
const client = new MongoClient(uri);

async function run() {
  try {
    await client.connect();
    const databasesList = await client.db().admin().listDatabases();
    console.log("Databases:");
    databasesList.databases.forEach(db => console.log(` - ${db.name}`));
  } finally {
    await client.close();
  }
}

run().catch(console.error);

Output

Databases:
 - admin
 - config
 - local
 - myDatabase

Common Pitfalls

Common mistakes when connecting to MongoDB include:

• Using an incorrect or incomplete connection string.
• Not awaiting connect() before performing database operations.
• Forgetting to close the connection with close(), which can cause resource leaks.
• Not handling connection errors with try/catch or promise rejection.

javascript

/* Wrong: Not awaiting connect() */
const client = new MongoClient(uri);
client.connect();
const db = client.db('myDatabase'); // May fail because connection not ready

/* Right: Await connect() before using client */
async function run() {
  await client.connect();
  const db = client.db('myDatabase');
  // Use db here
}

run().catch(console.error);

Quick Reference

Tips for connecting to MongoDB:

• Always use the official MongoDB driver for your language.
• Use a connection string from your MongoDB Atlas or local server.
• Call connect() before any database commands.
• Close the connection with close() when done.
• Handle errors with try/catch or promise rejection.

Key Takeaways

Use the official MongoDB driver and provide a valid connection string to create a MongoClient.

Always await the connect() method before running database commands.

Close the connection with close() to free resources.

Handle errors properly to avoid crashes.

Check your connection string carefully for correct credentials and options.