Deleting documents in Firebase - Step-by-Step Execution

Process Flow - Deleting documents

Start

↓

Identify Document

↓

Call Delete Method

↓

Check Success?

No→Error Handling

Yes↓

Document Removed

↓

End

This flow shows how a document is deleted: find it, delete it, check if successful, then finish.

Execution Sample

Firebase

const docRef = firestore.collection('users').doc('user123');
await docRef.delete();

This code deletes the document with ID 'user123' from the 'users' collection.

Process Table

Step	Action	Document Reference	Result	Notes
1	Create reference to document 'user123'	users/user123	Reference created	Ready to delete
2	Call delete() on document reference	users/user123	Delete request sent	Waiting for confirmation
3	Firestore processes delete	users/user123	Document deleted	Document no longer exists
4	Confirm deletion success	users/user123	Success	No errors
5	End process	-	-	Document removed from database

💡 Deletion confirmed successful, document no longer exists in Firestore

Status Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	Final
docRef	undefined	Reference to users/user123	Same	Same	Same
deleteStatus	undefined	undefined	Pending	Success	Success

Key Moments - 3 Insights

Why do we need to create a document reference before deleting?

Because Firestore needs to know exactly which document to delete. Step 1 in the execution_table shows creating this reference.

What happens if the document does not exist when delete() is called?

Firestore treats delete as successful even if the document is missing, so no error occurs. This is implied in Step 4 where success is confirmed.

Is the delete operation immediate or asynchronous?

It is asynchronous. Step 2 shows sending the delete request, and Step 3 waits for Firestore to process it.

Visual Quiz - 3 Questions

Look at the execution_table, what is the state of 'deleteStatus' after Step 2?

A Pending

B Success

C Undefined

D Failed

💡 Hint

Check variable_tracker column 'After Step 2' for 'deleteStatus'

At which step does Firestore confirm the document is deleted?

A Step 2

B Step 4

C Step 3

D Step 5

💡 Hint

Look at execution_table 'Result' column for when document is deleted

If the document does not exist, what will be the result at Step 4?

A Error

B Success

C Pending

D No result

💡 Hint

Refer to key_moments about delete behavior when document is missing

Concept Snapshot

Deleting documents in Firestore:
1. Create a reference to the document.
2. Call delete() on that reference.
3. The operation is asynchronous.
4. Firestore confirms deletion or no error if missing.
5. Document is removed from the database.

Full Transcript

To delete a document in Firestore, first create a reference to the document you want to remove. Then call the delete() method on that reference. This sends an asynchronous request to Firestore. Firestore processes the request and removes the document if it exists. If the document does not exist, Firestore still treats the operation as successful without error. After confirmation, the document is no longer in the database.

Practice

1. What does the delete() method do in Firebase Firestore?

easy

A. Reads data from a document

B. Adds a new document to the database

C. Updates fields in an existing document

D. Removes a specific document from the database

Solution

1. Step 1: Understand the purpose of delete()

   The delete() method is used to remove a document from Firestore.

2. Step 2: Compare with other operations

   Adding, updating, and reading documents use different methods like set(), update(), and get().

3. Final Answer:

   Removes a specific document from the database -> Option D

4. Quick Check:

   delete() removes documents [OK]

Hint: Delete removes documents, not adds or updates [OK]

Common Mistakes:

• Confusing delete() with set() or update()
• Thinking delete() reads data
• Assuming delete() removes collections

2. Which of the following is the correct syntax to delete a document with ID 'doc1' from a collection 'users' in Firestore?

easy

A. db.collection('users').doc('doc1').remove()

B. db.collection('users').delete('doc1')

C. db.collection('users').doc('doc1').delete()

D. db.delete('users/doc1')

Solution

1. Step 1: Identify correct method to delete a document

   The method to delete a document is delete() called on a document reference.

2. Step 2: Check syntax for document reference

   Use collection('users').doc('doc1') to get the document, then call delete().

3. Final Answer:

   db.collection('users').doc('doc1').delete() -> Option C

4. Quick Check:

   Use doc().delete() to remove documents [OK]

Hint: Use doc('id').delete() to remove a document [OK]

Common Mistakes:

• Using remove() instead of delete()
• Calling delete() on collection instead of doc
• Wrong method chaining order

3. What will the following code output if the document 'doc1' exists and is deleted successfully?

db.collection('users').doc('doc1').delete()
  .then(() => console.log('Deleted'))
  .catch(() => console.log('Error'))

medium

A. Error

B. Deleted

C. Nothing

D. SyntaxError

Solution

1. Step 1: Understand promise handling in delete()

   The delete() method returns a promise that resolves on success and rejects on failure.

2. Step 2: Analyze the then/catch handlers

   If deletion succeeds, then() runs and logs 'Deleted'. If it fails, catch() logs 'Error'.

3. Final Answer:

   Deleted -> Option B

4. Quick Check:

   Successful delete logs 'Deleted' [OK]

Hint: Successful delete triggers then(), logs 'Deleted' [OK]

Common Mistakes:

• Assuming delete() is synchronous
• Ignoring promise handling
• Expecting output without then()

4. Identify the error in this code snippet that tries to delete a document:

const docRef = db.collection('users').doc('doc1');
docRef.delete;
console.log('Deleted');

medium

A. Missing parentheses after delete method call

B. Wrong collection name

C. docRef is not defined

D. delete is not a method

Solution

1. Step 1: Check method invocation syntax

   The delete method must be called with parentheses: delete().

2. Step 2: Identify impact of missing parentheses

   Without parentheses, the method is not executed, so the document is not deleted.

3. Final Answer:

   Missing parentheses after delete method call -> Option A

4. Quick Check:

   Call delete() with () to execute [OK]

Hint: Always use parentheses to call delete() method [OK]

Common Mistakes:

• Forgetting () after delete
• Assuming delete is a property, not a method
• Ignoring promise handling

5. You want to delete multiple documents with IDs ['doc1', 'doc2', 'doc3'] from the 'users' collection. Which approach correctly deletes all documents and logs 'All deleted' after completion?

hard

A. Use Promise.all with delete promises:Promise.all(['doc1','doc2','doc3'].map(id => db.collection('users').doc(id).delete()))
.then(() => console.log('All deleted'))

B. Call delete() on the collection:db.collection('users').delete();
console.log('All deleted');

C. Use a loop with await:for (const id of ['doc1','doc2','doc3']) {
await db.collection('users').doc(id).delete();
}
console.log('All deleted');

D. Delete documents without waiting:['doc1','doc2','doc3'].forEach(id => db.collection('users').doc(id).delete());
console.log('All deleted');

Solution

1. Step 1: Understand asynchronous deletion of multiple documents

   Deleting multiple documents returns promises; to know when all finish, use Promise.all().

2. Step 2: Evaluate each option's correctness

   Use Promise.all with delete promises:
   

   Promise.all(['doc1','doc2','doc3'].map(id => db.collection('users').doc(id).delete()))
     .then(() => console.log('All deleted'))

   uses Promise.all() with delete promises to wait for all deletions concurrently before logging. B calls invalid delete() on collection. C uses await loop without async function, causing syntax error. D logs without waiting for completion.

3. Final Answer:

   Use Promise.all with delete promises -> Option A

4. Quick Check:

   Promise.all waits for all deletes before logging [OK]

Hint: Use Promise.all to wait for all deletes before logging [OK]

Common Mistakes:

• Trying to delete entire collection directly
• Not waiting for all deletes before logging
• Using forEach without async/await or Promise.all