Querying with where clause in Firebase - Step-by-Step Execution

Process Flow - Querying with where clause

Start Query

↓

Specify Collection

↓

Add where clause

↓

Filter documents

↓

Return matching documents

↓

End Query

This flow shows how a query starts by choosing a collection, then adds a where clause to filter documents, and finally returns only those that match.

Execution Sample

Firebase

const q = query(collection(db, "users"), where("age", ">", 18));
const querySnapshot = await getDocs(q);
querySnapshot.forEach((doc) => {
  console.log(doc.id, "=>", doc.data());
});

This code queries the 'users' collection for documents where the 'age' field is greater than 18, then prints each matching document.

Process Table

Step	Action	Filter Condition	Documents Checked	Documents Matched	Output
1	Start query on 'users' collection	age > 18	All documents in 'users'	N/A	No output yet
2	Check document 1	age=16	Doc1	No	Skip
3	Check document 2	age=22	Doc2	Yes	Include Doc2
4	Check document 3	age=18	Doc3	No	Skip
5	Check document 4	age=25	Doc4	Yes	Include Doc4
6	End query	age > 18	All checked	2 matched	Return Doc2, Doc4

💡 All documents checked; only those with age > 18 are returned.

Status Tracker

Variable	Start	After Doc1	After Doc2	After Doc3	After Doc4	Final
Documents Matched	[]	[]	[Doc2]	[Doc2]	[Doc2, Doc4]	[Doc2, Doc4]

Key Moments - 2 Insights

Why does the document with age 18 not appear in the results?

Because the where clause uses '>' (greater than), not '>=' (greater or equal). The document with age 18 does not satisfy age > 18, as shown in execution_table row 4.

Are all documents checked even if some match early?

Yes, Firestore checks all documents in the collection to find all matches, as seen in execution_table rows 2 to 5.

Visual Quiz - 3 Questions

Look at the execution table, how many documents matched the where clause?

A 2

B 1

C 3

D 4

💡 Hint

Check the 'Documents Matched' column in the last row of the execution_table.

At which step does the query skip a document because it does not meet the condition?

A Step 3

B Step 2

C Step 5

D Step 6

💡 Hint

Look at the 'Documents Checked' and 'Documents Matched' columns in execution_table rows.

If the where clause changed to 'age >= 18', which document would be included additionally?

A Doc1

B Doc4

C Doc3

D No additional document

💡 Hint

Check which document has age exactly 18 in the execution_table.

Concept Snapshot

Querying with where clause in Firebase:
- Use query() with collection() and where(field, operator, value)
- Filters documents by condition
- Returns only matching documents
- Operators: ==, >, >=, <, <=, etc.
- All documents checked, only matches returned

Full Transcript

This visual execution shows how a Firebase query with a where clause works. First, the query starts on the 'users' collection. Then, it applies the filter condition 'age > 18'. Each document in the collection is checked one by one. Documents with age 16 and 18 do not match and are skipped. Documents with age 22 and 25 match and are included in the results. Finally, the query returns only the matching documents. This helps you get only the data you want from your database.