Documentation not updated- 'Model.insertMany() no longer accepts a callback');

[arifaisal123]

Prerequisites

• I have written a descriptive issue title
• I have searched existing issues to ensure the bug has not already been reported

Mongoose version

7.3.4

Node.js version

18.16.1

MongoDB server version

4.0.28

Typescript version (if applicable)

No response

Description

I have followed the mongoose documentation to use Model.insertMany() in my code.

The documentation example states to use the following:

Considering the documentation, I used the following code for my project:

const express = require("express");
const bodyParser = require("body-parser");
const mongoose = require("mongoose");

const app = express();

app.set("view engine", "ejs");

app.use(bodyParser.urlencoded({extended: true}));
app.use(express.static("public"));

mongoose.connect("mongodb://0.0.0.0:27017/todolistDB");

const itemsSchema = {
    name: String
};

const Item = mongoose.model("Item", itemsSchema);

const item1 = new Item({
    name: "Welcome to your todolist!"
});

const item2 = new Item({
    name: "Hit the + button to add a new item"
});

const item3 = new Item({
    name: "<-- Hit this to delete an item."
});

const defaultItems = [item1, item2, item3];

Item.insertMany(defaultItems, function(error, docs) {});

The above code produces the following error:

With stackoverflow, I was able to understand that the callback function with insertMany() method has been deprecated. Hence, I refactored my code following the SO suggestions as below:

Item.insertMany(defaultItems)
            .then(function(){
                console.log("Successfully Inserted!");
            })
            .catch(function(err){
                console.log(err);
            });

The above code seems to solve the issue for me.

I believe the documentation needs to be updated in here.

I am also willing to work and contribute in this issue.

Steps to Reproduce

Running the following code in the terminal with the command "node app.js" reproduces the error.

const express = require("express");
const bodyParser = require("body-parser");
const mongoose = require("mongoose");

const app = express();

app.set("view engine", "ejs");

app.use(bodyParser.urlencoded({extended: true}));
app.use(express.static("public"));

mongoose.connect("mongodb://0.0.0.0:27017/todolistDB");

const itemsSchema = {
    name: String
};

const Item = mongoose.model("Item", itemsSchema);

const item1 = new Item({
    name: "Welcome to your todolist!"
});

const item2 = new Item({
    name: "Hit the + button to add a new item"
});

const item3 = new Item({
    name: "<-- Hit this to delete an item."
});

const defaultItems = [item1, item2, item3];

Item.insertMany(defaultItems, function(error, docs) {});

Expected Behavior

I wanted the code to successfully insert the documents in the collection, but it produces the error "MongooseError('Model.insertMany() no longer accepts a callback')"