deleteOne method in MongoDB - Mini Project: Build & Apply

Using the deleteOne Method in MongoDB

📖 Scenario: You are managing a small online bookstore database. You want to remove a specific book from the collection when it is no longer available.

🎯 Goal: Learn how to use the deleteOne method in MongoDB to remove a single document from a collection based on a condition.

📋 What You'll Learn

Create a collection named books with specific book documents

Define a filter to select the book to delete

Use the deleteOne method with the filter

Confirm the deletion by checking the collection

💡 Why This Matters

🌍 Real World

Deleting outdated or unavailable items from a database is common in inventory management, online stores, and content management systems.

💼 Career

Knowing how to safely remove data using deleteOne is essential for database administrators and backend developers to maintain clean and accurate data.

1

Create the books collection with initial documents

Create a variable called books that represents a MongoDB collection. Insert these exact documents into books: { title: 'The Great Gatsby', author: 'F. Scott Fitzgerald' }, { title: '1984', author: 'George Orwell' }, and { title: 'To Kill a Mockingbird', author: 'Harper Lee' }.

MongoDB

// Create the books collection and insert the documents
// Your code here

Hint

Use db.collection('books') to get the collection and insertMany to add multiple documents.

2

Define a filter to select the book to delete

Create a variable called filter that selects the document where the title is exactly '1984'.

MongoDB

const books = db.collection('books');
await books.insertMany([
  { title: 'The Great Gatsby', author: 'F. Scott Fitzgerald' },
  { title: '1984', author: 'George Orwell' },
  { title: 'To Kill a Mockingbird', author: 'Harper Lee' }
]);

// Create a filter to find the book with title '1984'
// Your code here

Hint

Use an object with title: '1984' to create the filter.

3

Use deleteOne to remove the selected book

Call deleteOne on the books collection using the filter variable to delete the document where the title is '1984'. Store the result in a variable called deleteResult.

MongoDB

const books = db.collection('books');
await books.insertMany([
  { title: 'The Great Gatsby', author: 'F. Scott Fitzgerald' },
  { title: '1984', author: 'George Orwell' },
  { title: 'To Kill a Mockingbird', author: 'Harper Lee' }
]);

const filter = { title: '1984' };

// Use deleteOne with the filter and save the result in deleteResult
// Your code here

Hint

Use await books.deleteOne(filter) and assign it to deleteResult.

4

Confirm the deletion by counting remaining documents

Create a variable called remainingCount that stores the number of documents left in the books collection after deletion by using the countDocuments method.

MongoDB

const books = db.collection('books');
await books.insertMany([
  { title: 'The Great Gatsby', author: 'F. Scott Fitzgerald' },
  { title: '1984', author: 'George Orwell' },
  { title: 'To Kill a Mockingbird', author: 'Harper Lee' }
]);

const filter = { title: '1984' };

const deleteResult = await books.deleteOne(filter);

// Count the remaining documents in books and store in remainingCount
// Your code here

Hint

Use await books.countDocuments() to get the number of documents left.

Practice

1. What does the deleteOne method do in MongoDB?

easy

A. Deletes all documents in a collection.

B. Updates a single document in the collection.

C. Deletes a single document that matches the filter criteria.

D. Finds a document without deleting it.

Solution

1. Step 1: Understand the purpose of deleteOne

   The deleteOne method is designed to remove exactly one document that matches the given filter.

2. Step 2: Compare with other methods

   Unlike deleteMany, which removes multiple documents, deleteOne targets only one document.

3. Final Answer:

   Deletes a single document that matches the filter criteria. -> Option C

4. Quick Check:

   deleteOne removes one matching document [OK]

Hint: Remember: deleteOne removes only one matching document [OK]

Common Mistakes:

• Confusing deleteOne with deleteMany
• Thinking deleteOne updates documents
• Assuming deleteOne deletes all documents

2. Which of the following is the correct syntax to delete one document where the field name equals "Alice"?

easy

A. db.collection.deleteOne({name: "Alice"})

B. db.collection.deleteOne(name = "Alice")

C. db.collection.deleteOne("name: Alice")

D. db.collection.deleteOne({"name" == "Alice"})

Solution

1. Step 1: Check the filter format

   The filter must be an object with key-value pairs, like {name: "Alice"}.

2. Step 2: Validate method call syntax

   The correct syntax is db.collection.deleteOne(filter) where filter is an object.

3. Final Answer:

   db.collection.deleteOne({name: "Alice"}) -> Option A

4. Quick Check:

   Filter is an object with field and value [OK]

Hint: Use object syntax {field: value} inside deleteOne() [OK]

Common Mistakes:

• Using assignment (=) inside filter
• Passing filter as a string
• Using comparison operators (==) inside filter object

3. Given the collection documents: [{"_id":1, "name":"Bob"}, {"_id":2, "name":"Alice"}, {"_id":3, "name":"Bob"}], what will be the result of db.collection.deleteOne({name: "Bob"})?

medium

A. Deletes the first document with name 'Bob' only.

B. No documents are deleted.

C. Deletes the document with name 'Alice'.

D. Deletes both documents with name 'Bob'.

Solution

1. Step 1: Understand deleteOne behavior

   deleteOne removes only one document matching the filter, not all.

2. Step 2: Identify which document is deleted

   It deletes the first document it finds with name: "Bob", which is the one with _id:1.

3. Final Answer:

   Deletes the first document with name 'Bob' only. -> Option A

4. Quick Check:

   deleteOne removes one matching document, not all [OK]

Hint: deleteOne deletes only one matching document, not all [OK]

Common Mistakes:

• Assuming deleteOne deletes all matches
• Thinking it deletes documents with other names
• Believing no document is deleted if multiple matches exist

4. What is wrong with this code snippet?
db.collection.deleteOne({name: 'John')

medium

A. deleteOne cannot delete documents with name field.

B. Using single quotes instead of double quotes.

C. The method name should be deleteMany.

D. Missing closing brace '}' in the filter object.

Solution

1. Step 1: Check the filter object syntax

   The filter object starts with '{' but does not have a matching closing '}'.

2. Step 2: Validate quotes and method usage

   Single quotes are allowed in JavaScript, and deleteOne is correct for deleting one document.

3. Final Answer:

   Missing closing brace '}' in the filter object. -> Option D

4. Quick Check:

   Filter objects must have matching braces [OK]

Hint: Check for matching braces in filter objects [OK]

Common Mistakes:

• Ignoring missing braces causing syntax errors
• Confusing single vs double quotes as error
• Thinking deleteOne is wrong method here

5. You want to delete a user document only if the user's status is "inactive" and age is greater than 30. Which deleteOne filter correctly achieves this?

hard

A. db.collection.deleteOne({$or: [{status: "inactive"}, {age: {$gt: 30}}]})

B. db.collection.deleteOne({status: "inactive", age: {$gt: 30}})

C. db.collection.deleteOne({status == "inactive", age > 30})

D. db.collection.deleteOne({status: "inactive" || age > 30})

Solution

1. Step 1: Understand filter conditions

   We want to delete a document where both conditions are true: status is "inactive" AND age is greater than 30.

2. Step 2: Check filter syntax for AND condition

   In MongoDB filters, multiple key-value pairs in the object imply logical AND. Thus, db.collection.deleteOne({status: "inactive", age: {$gt: 30}}) is correct. $or would match if either condition is true.

3. Final Answer:

   db.collection.deleteOne({status: "inactive", age: {$gt: 30}}) -> Option B

4. Quick Check:

   Multiple fields in filter imply AND [OK]

Hint: Multiple fields in filter object mean AND conditions [OK]

Common Mistakes:

• Using || inside filter object (invalid syntax)
• Using == inside filter object
• Using $or for AND conditions