collection.deleteMany()¶

On this page

Definition
Usage

Definition¶

collection.deleteMany()¶

Remove one or more documents from the collection based on a query filter.

Usage¶

Example¶

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

copy

const query = { "reviews": { "$size": 0 } };

itemsCollection.deleteMany(query)
  .then(result => console.log(`Deleted ${result.deletedCount} item(s).`))
  .catch(err => console.error(`Delete failed with error: ${err}`))

Parameters¶

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

copy

deleteMany(query)

Parameter	Description
Query Filter `query: <document>`	Optional. A standard MongoDB query document that specifies which documents to delete. You can use most query selectors except for evaluation, geospatial, or bitwise selectors.

Return Value¶

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

copy

Promise<result: document>

Value	Description
Matched Count `result.deletedCount: <integer>`	The number of documents in the collection that were deleted by the delete operation.

← collection.deleteOne() collection.aggregate() →