Increment operations in Firebase - Commands & Configuration

Introduction

Increment operations let you add a number to a value stored in your Firebase database without reading it first. This helps keep your data accurate and avoids conflicts when many users update the same value at once.

When you want to count how many times a button is clicked by different users.

When you need to update a score in a game without losing other players' updates.

When tracking the number of views on a post in real time.

When you want to add points to a user's profile safely without reading the current points first.

When multiple devices update the same counter and you want to avoid errors.

Commands

This command increases the 'score' field by 1 for the user with ID 'user123' in the 'users' collection. It updates the value safely without reading it first.

Terminal

firebase firestore:update --project example-project --collection users --doc user123 --field score=increment(1)

Expected Output

Updated document user123 in collection users with increment operation on field score.

→

--project - Specifies the Firebase project to use.

→

--collection - Specifies the Firestore collection containing the document.

→

--doc - Specifies the document ID to update.

→

--field - Specifies the field and increment operation to apply.

This command retrieves the updated document to verify the increment operation was successful.

Terminal

firebase firestore:get --project example-project --collection users --doc user123

Expected Output

{

  "name": "user123",

  "score": 5

}

→

--project - Specifies the Firebase project to use.

→

--collection - Specifies the Firestore collection containing the document.

→

--doc - Specifies the document ID to retrieve.

Key Concept

If you remember nothing else from this pattern, remember: increment operations update numeric fields safely without reading them first, preventing conflicts.

Common Mistakes

Trying to increment a field that does not exist yet.

The increment operation requires the field to be a number or it will fail.

Initialize the field with a number (like 0) before using increment operations.

Using increment operation on a non-numeric field like a string.

Increment only works on numeric fields and will cause an error otherwise.

Ensure the field is numeric before applying increment.

Reading the value first and then writing the incremented value manually.

This can cause race conditions and lost updates when multiple users write at the same time.

Use the atomic increment operation provided by Firebase to avoid conflicts.

Summary

Use Firebase increment operations to safely add numbers to fields without reading them first.

Run update commands with increment to avoid conflicts from multiple users updating the same field.

Verify updates by retrieving the document after the increment operation.

Practice

1. What does FieldValue.increment(1) do in Firebase Firestore?

easy

A. It increases a numeric field by 1 safely, even with concurrent updates.

B. It sets the field value to 1, replacing the old value.

C. It deletes the field from the document.

D. It multiplies the field value by 1.

Solution

1. Step 1: Understand FieldValue.increment usage

   This method safely adds the given number to a numeric field in Firestore, handling concurrent updates without conflicts.

2. Step 2: Analyze the argument 1

   Passing 1 means the field value will increase by 1, not replaced or deleted.

3. Final Answer:

   It increases a numeric field by 1 safely, even with concurrent updates. -> Option A

4. Quick Check:

   FieldValue.increment(1) adds 1 safely [OK]

Hint: Increment adds value safely without overwriting [OK]

Common Mistakes:

• Thinking it replaces the value instead of adding
• Confusing increment with delete operation
• Assuming it multiplies the value

2. Which of the following is the correct syntax to decrement a Firestore numeric field by 5 using FieldValue.increment?

easy

A. FieldValue.increment(-5)

B. FieldValue.increment(5)

C. FieldValue.increment('5')

D. FieldValue.increment()

Solution

1. Step 1: Understand decrement with increment

   To subtract a number, pass a negative value to FieldValue.increment.

2. Step 2: Check options for correct negative number usage

   Only FieldValue.increment(-5) correctly decrements by 5.

3. Final Answer:

   FieldValue.increment(-5) -> Option A

4. Quick Check:

   Negative number decrements value [OK]

Hint: Use negative number inside increment to subtract [OK]

Common Mistakes:

• Passing positive number to decrement
• Using string instead of number
• Calling increment without argument

3. Given this Firestore update code:

docRef.update({ count: FieldValue.increment(3) });
docRef.update({ count: FieldValue.increment(2) });

What will be the total increment to the count field after both updates complete?

medium

A. 3

B. 2

C. Cannot determine due to concurrency

D. 5

Solution

1. Step 1: Understand separate increments

   Each update adds its increment value to the current field value safely.

2. Step 2: Add increments together

   3 + 2 = 5 total increment after both updates.

3. Final Answer:

   5 -> Option D

4. Quick Check:

   3 + 2 = 5 total increment [OK]

Hint: Add increments from each update to get total change [OK]

Common Mistakes:

• Thinking only last update counts
• Assuming increments overwrite each other
• Believing concurrency causes unknown result

4. You wrote this code to increment a field:

docRef.update({ count: FieldValue.increment() });

But it throws an error. What is the problem?

medium

A. FieldValue.increment only works on new documents.

B. FieldValue.increment cannot be used with update().

C. FieldValue.increment requires a numeric argument.

D. FieldValue.increment must be called with a string argument.

Solution

1. Step 1: Check method argument requirements

   FieldValue.increment requires a number argument to know how much to add or subtract.

2. Step 2: Identify missing argument error

   Calling increment() without argument causes an error because it lacks the number.

3. Final Answer:

   FieldValue.increment requires a numeric argument. -> Option C

4. Quick Check:

   Missing number argument causes error [OK]

Hint: Always pass a number to increment() [OK]

Common Mistakes:

• Omitting the number argument
• Thinking increment works without update()
• Passing string instead of number

5. You want to track daily views in Firestore and increment the views field each time a user visits. Which approach ensures correct counts even if many users visit simultaneously?

hard

A. Read the current views value, add 1 in code, then write it back.

B. Use FieldValue.increment(1) in an update to add 1 safely.

C. Delete the views field and set it to 1 each time.

D. Use a transaction that reads and writes the views field without increment.

Solution

1. Step 1: Understand concurrency in counting

   Many users updating the same field can cause conflicts if reading and writing separately.

2. Step 2: Use atomic increment

   FieldValue.increment(1) safely adds 1 without conflicts, even with simultaneous updates.

3. Final Answer:

   Use FieldValue.increment(1) in an update to add 1 safely. -> Option B

4. Quick Check:

   Atomic increment avoids conflicts [OK]

Hint: Use atomic increment to avoid race conditions [OK]

Common Mistakes:

• Reading and writing value separately causing lost updates
• Deleting field instead of incrementing
• Using transactions without increment method