countDocuments method in MongoDB - Step-by-Step Execution

Concept Flow - countDocuments method

Start countDocuments call

↓

Apply filter to collection

↓

Scan matching documents

↓

Count matched documents

↓

Return count result

↓

End

The countDocuments method starts by applying a filter to the collection, scans all matching documents, counts them, and returns the total count.

Execution Sample

MongoDB

db.users.countDocuments({ age: { $gte: 18 } })

Counts how many documents in the 'users' collection have an age of 18 or older.

Execution Table

Step	Action	Filter Applied	Documents Scanned	Count So Far	Result Returned
1	Start countDocuments	{ age: { $gte: 18 } }	0	0
2	Scan document 1	{ age: { $gte: 18 } }	1	1
3	Scan document 2	{ age: { $gte: 18 } }	2	2
4	Scan document 3	{ age: { $gte: 18 } }	3	2
5	Scan document 4	{ age: { $gte: 18 } }	4	3
6	All documents scanned	{ age: { $gte: 18 } }	4	3	3
7	Return count				3

💡 All documents scanned; count of matching documents (3) returned.

Variable Tracker

Variable	Start	After 1	After 2	After 3	After 4	Final
Documents Scanned	0	1	2	3	4	4
Count So Far	0	1	2	2	3	3

Key Moments - 2 Insights

Why does the count not increase when scanning document 3?

Because document 3 does not match the filter { age: { $gte: 18 } }, so the count remains the same as shown in execution_table row 4.

Does countDocuments return the actual documents?

No, countDocuments only returns the number of documents matching the filter, not the documents themselves, as seen in the final result in execution_table row 7.

Visual Quiz - 3 Questions

Look at the execution table, what is the count after scanning the second document?

A 1

B 0

C 2

D 3

💡 Hint

Check the 'Count So Far' column at Step 3 in the execution_table.

At which step does the countDocuments method return the final count?

A Step 5

B Step 7

C Step 6

D Step 4

💡 Hint

Look at the 'Result Returned' column in the execution_table to find when the count is returned.

If the filter was changed to { age: { $gte: 21 } }, how would the count after scanning document 4 change?

A It would be 2

B It would be 3

C It would be 4

D It would be 1

💡 Hint

Refer to variable_tracker and consider which documents meet the new filter condition.

Concept Snapshot

countDocuments(filter)
- Counts documents matching filter in a collection
- Returns number, not documents
- Efficient for counting large sets
- Filter is optional; counts all if omitted

Full Transcript

The countDocuments method in MongoDB counts how many documents in a collection match a given filter. It starts by applying the filter, scans each document, increments the count if the document matches, and finally returns the total count. For example, counting users aged 18 or older scans each user document, counts those with age >= 18, and returns that number. The method does not return the documents themselves, only the count. This process is efficient and useful for quickly knowing how many records meet certain criteria.