Mongoose Query.prototype.update() API

The Mongoose Query API update() method is used to update documents from a collection, using the MongoDB query system. It can update one or more than one documents at a time.

Syntax:

Query.prototype.update(filter, doc, options, callback)

Parameters: It accepts the following 4 parameters as mentioned above and described below:

• filter: It is a mongoose object which identifies the existing document to update.
• doc: It is a mongoose object which is the document that will update the data in the existing document.
• options: It is an optional mongoose object which is derived from Query.prototype.setOptions().
• callback: It is a callback function that accepts the parameters, error, and writeOpResult.

Return type: It returns a Query object as a response.

Creating node application And Installing Mongoose:

Step 1: Create a node application using the following command:

mkdir folder_name
cd folder_name
npm init -y
touch main.js

Step 2: After completing the Node.js application, Install the required module using the following command:

npm install mongoose

Project Structure: It will look like the following.

Example 1: In this example, we will use this method to update an existing document that has the name "Luffy".

Filename: main.js

const mongoose = require('mongoose')

// Database connection
mongoose.connect('mongodb://localhost:27017/query-helpers',
    {
        dbName: 'event_db',
        useNewUrlParser: true,
        useUnifiedTopology: true
    }, err => err ? console.log(err)
        : console.log('Connected to database'));

const personSchema = new mongoose.Schema({
    name: {
        type: String,
    },
    age: {
        type: Number,
    }
});

const personsArray = [
    {
        name: 'Luffy',
        age: 19
    },
    {
        name: 'Nami',
        age: 30
    },
    {
        name: 'Zoro',
        age: 35
    }
]

const Person = mongoose.model('Person', personSchema);

(async () => {
    await Person.insertMany(personsArray);
    await Person.where({ name: 'Luffy' }).update({ age: 20 });
})()

Step to Run Application: Run the application using the following command from the root directory of the project:

node main.js

Output: GUI Representation of the  Database using MongoDB Compass:

Example 2: In this example, we will use this method to update multiple existing documents that have the age "19".

Filename: main.js

const mongoose = require('mongoose')

// Database connection
mongoose.connect('mongodb://localhost:27017/query-helpers',
    {
        dbName: 'event_db',
        useNewUrlParser: true,
        useUnifiedTopology: true
    }, err => err ? console.log(err)
        : console.log('Connected to database'));

const personSchema = new mongoose.Schema({
    name: {
        type: String,
    },
    age: {
        type: Number,
    }
});

const personsArray = [
    {
        name: 'Luffy',
        age: 19
    },
    {
        name: 'Nami',
        age: 19
    },
    {
        name: 'Zoro',
        age: 35
    }
]

const Person = mongoose.model('Person', personSchema);

(async () => {
    await Person.insertMany(personsArray);
    await Person.where({ age: 19 }).update({ age: 20 });
})()

Step to Run Application: Run the application using the following command from the root directory of the project:

node main.js

Output: GUI Representation of the  Database using MongoDB Compass:

Reference: https://mongoosejs.com/docs/api/query.html#query_Query-update