collection.count()¶

On this page

Definition
Usage

Definition¶

collection.count()¶

Return the number of documents in a collection or view that match the specified query filter.

Usage¶

Example¶

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

copy

collection.count({ status: "Complete" })
  .then(numDocs => console.log(`${numDocs} documents match the specified query.`))
  .catch(err => console.error("Failed to count documents: ", err))

Parameters¶

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

copy

count(query)

Parameter Description

Query Filter

query: <document>

Optional. A standard MongoDB query document that specifies which documents to count. You can use most query selectors except for evaluation, geospatial, or bitwise selectors.

Specify an empty query filter ({}) or omit this parameter to count all documents in the collection.

Return Value¶

The collection.count() action returns a Promise that resolves to the integer number of documents in the collection that match the query filter.

copy

Promise<numDocs: Number>

Value	Description
Count Result `numDocs: <integer>`	The number of documents in the collection that match the provided query filter.

← collection.aggregate() Sync Overview →