Transaction basics in Firebase - Commands & Configuration

Introduction

Sometimes you need to update data in a way that makes sure no one else changes it at the same time. Transactions help you do this by making sure your changes happen all at once or not at all.

When you want to increase a counter safely without losing updates from others.

When you need to read a value, change it, and save it back without conflicts.

When multiple users might try to update the same data at the same time.

When you want to keep data consistent, like updating a balance after a purchase.

When you want to retry your update automatically if someone else changed the data first.

Commands

This command runs a transaction that reads the current count from the 'clicks' document, adds one, and updates it safely. It retries if someone else changed the count meanwhile.

Terminal

firebase firestore:transaction 'db => db.runTransaction(transaction => {
  return transaction.get(db.collection("counters").doc("clicks")).then(doc => {
    const newCount = (doc.data().count || 0) + 1;
    transaction.update(db.collection("counters").doc("clicks"), { count: newCount });
  });
})'

Expected Output

Transaction successfully committed.

This command checks the current value of the 'clicks' counter to verify the transaction worked.

Terminal

firebase firestore:doc get counters/clicks

Expected Output

{

  "count": 1

}

Key Concept

If you remember nothing else from this pattern, remember: transactions let you safely read and write data together so no updates get lost.

Common Mistakes

Trying to update data without a transaction when multiple users write at the same time.

This can cause lost updates because changes overwrite each other.

Use a transaction to read the current data and write the new data atomically.

Not handling retries inside the transaction function.

If data changes during your transaction, it will fail unless retried.

Write your transaction code so it can be retried automatically by the SDK.

Summary

Use transactions to read and update data safely in Firestore.

Run the transaction command to perform atomic updates that retry if needed.

Verify your changes by reading the updated document after the transaction.

Practice

1. What is the main purpose of using a transaction in Firebase?

easy

A. To speed up data retrieval

B. To ensure data changes are safe and consistent

C. To store large files

D. To send notifications to users

Solution

1. Step 1: Understand transaction purpose

   Transactions are designed to keep data changes safe and consistent when multiple users might update the same data.

2. Step 2: Eliminate unrelated options

   Speeding up retrieval, storing files, or sending notifications are not the main goals of transactions.

3. Final Answer:

   To ensure data changes are safe and consistent -> Option B

4. Quick Check:

   Transaction purpose = safe and consistent data [OK]

Hint: Transactions protect data integrity during concurrent updates [OK]

Common Mistakes:

• Thinking transactions speed up data retrieval
• Confusing transactions with file storage
• Assuming transactions send notifications

2. Which of the following is the correct way to start a transaction in Firebase Realtime Database?

easy

A. database.ref('path').transaction(updateFunction)

B. database.ref('path').setTransaction(updateFunction)

C. database.transaction('path', updateFunction)

D. database.ref('path').runTransaction(updateFunction)

Solution

1. Step 1: Recall Firebase transaction syntax

   The correct method to start a transaction is calling transaction() on a database reference.

2. Step 2: Check each option

   database.ref('path').transaction(updateFunction) uses ref('path').transaction(updateFunction), which is correct. Options A, B, and D use incorrect method names or call patterns.

3. Final Answer:

   database.ref('path').transaction(updateFunction) -> Option A

4. Quick Check:

   Correct method is .transaction() on ref [OK]

Hint: Use .transaction() on a database reference to start [OK]

Common Mistakes:

• Using .setTransaction() which does not exist
• Calling transaction directly on database object
• Using .runTransaction() which is invalid

3. Consider this transaction code snippet:

database.ref('counter').transaction(currentValue => {
  if (currentValue === null) {
    return 1;
  } else {
    return currentValue + 1;
  }
});

What will be the value of 'counter' after this transaction if it was initially 5?

medium

A. 6

B. 1

C. null

D. 5

Solution

1. Step 1: Analyze the transaction function logic

   The function checks if the current value is null; if so, it returns 1. Otherwise, it returns currentValue + 1.

2. Step 2: Apply initial value 5

   Since currentValue is 5 (not null), the function returns 5 + 1 = 6.

3. Final Answer:

   6 -> Option A

4. Quick Check:

   5 + 1 = 6 [OK]

Hint: If value exists, transaction adds 1; else sets to 1 [OK]

Common Mistakes:

• Assuming value stays the same
• Confusing null check logic
• Returning 1 regardless of current value

4. What is wrong with this Firebase transaction code?

database.ref('score').transaction(() => {
  database.ref('score').set(10);
  return 20;
});

medium

A. You cannot return a value in a transaction function

B. Calling set() inside transaction causes an error

C. Reads must happen before writes inside the transaction function

D. Transaction function must be async

Solution

1. Step 1: Understand transaction function rules

   All reads must happen before any writes inside the transaction function to ensure consistency.

2. Step 2: Identify the problem in code

   The code calls set(10) inside the transaction function before returning a new value, which violates the rule.

3. Final Answer:

   Reads must happen before writes inside the transaction function -> Option C

4. Quick Check:

   Transaction rule: read before write [OK]

Hint: Do all reads before any writes inside transaction function [OK]

Common Mistakes:

• Calling set() inside transaction function
• Returning a value is allowed and required
• Thinking transaction function must be async

5. You want to increment a user's points only if their current points are less than 100. Which transaction function correctly implements this logic?

database.ref('users/user1/points').transaction(currentPoints => {
  // Your code here
});

hard

A. if (currentPoints === null) { return 0; } else { return 100; }

B. if (currentPoints >= 100) { return currentPoints + 1; } else { return currentPoints; }

C. return currentPoints + 1;

D. if (currentPoints === null || currentPoints < 100) { return (currentPoints || 0) + 1; } else { return currentPoints; }

Solution

1. Step 1: Understand the condition to increment points

   Points should increment only if currentPoints is less than 100 or if it is null (no points yet).

2. Step 2: Check each option logic

   if (currentPoints === null || currentPoints < 100) { return (currentPoints || 0) + 1; } else { return currentPoints; } increments points by 1 if currentPoints is null or less than 100, else returns currentPoints unchanged. This matches the requirement. if (currentPoints >= 100) { return currentPoints + 1; } else { return currentPoints; } increments when points are 100 or more, which is wrong. return currentPoints + 1; always increments ignoring the limit. if (currentPoints === null) { return 0; } else { return 100; } resets points incorrectly.

3. Final Answer:

   if (currentPoints === null || currentPoints < 100) { return (currentPoints || 0) + 1; } else { return currentPoints; } -> Option D

4. Quick Check:

   Increment only if points < 100 or null [OK]

Hint: Check null or less than 100 before incrementing [OK]

Common Mistakes:

• Incrementing points when already 100 or more
• Ignoring null initial value
• Resetting points instead of incrementing