collection.insertOne()¶

On this page

Definition
Usage

Definition¶

collection.insertOne()¶

Insert a single document into a collection and return the _id of the inserted document.

Usage¶

Example¶

To call the collection.insertOne() action from a Function, get a collection handle with database.collection() then call the handle’s insertOne() method.

copy

const newItem = {
  "name": "Plastic Bricks",
  "quantity": 10,
  "category": "toys",
  "reviews": [{ "username": "legolover", "comment": "These are awesome!" }]
};

itemsCollection.insertOne(newItem)
  .then(result => console.log(`Successfully inserted item with _id: ${result.insertedId}`))
  .catch(err => console.error(`Failed to insert item: ${err}`))

Parameters¶

The collection.insertOne() action has the following form:

copy

insertOne(document)

Parameter	Description
Insert Document `document: <document>`	A document to insert into the collection.

Return Value¶

The collection.insertOne() action returns a Promise that resolves to a document that describes the insert operation.

copy

Promise<result: document>

Value	Description
Inserted ID `result.insertedId: <ObjectID>`	The `_id` value of the document that the insert operation added to the collection.

← collection.findOneAndDelete() collection.insertMany() →