$elemMatch for complex array queries in MongoDB - Mini Project: Build & Apply

$elemMatch for complex array queries

📖 Scenario: You are managing a database for a library. Each book document contains an array of reviews. Each review has a rating and a comment. You want to find books that have at least one review with a rating of 5 and a comment containing the word "excellent".

🎯 Goal: Build a MongoDB query using $elemMatch to find books where the reviews array contains at least one review with rating equal to 5 and comment containing "excellent".

📋 What You'll Learn

Create a collection called books with documents containing a title and an array called reviews.

Each review in the reviews array must have a rating (number) and a comment (string).

Write a query using $elemMatch to find books with at least one review where rating is 5 and comment contains the word "excellent".

💡 Why This Matters

🌍 Real World

Libraries, e-commerce sites, and review platforms often store multiple reviews or comments inside an array field. Using <code>$elemMatch</code> helps find documents where at least one array element meets complex conditions.

💼 Career

Understanding <code>$elemMatch</code> is essential for database developers and backend engineers working with MongoDB to write efficient and precise queries for nested array data.

1

Create the books collection with sample documents

Create a variable called books and assign it an array with two documents. The first document should have title set to "MongoDB Basics" and reviews as an array with one review: { rating: 5, comment: "An excellent introduction" }. The second document should have title set to "Advanced MongoDB" and reviews as an array with one review: { rating: 4, comment: "Good but not excellent" }.

MongoDB

# Create the books array with two documents as described
# Your code here

Hint

Use an array of objects. Each object has title and reviews keys. reviews is an array of objects with rating and comment.

2

Create a query filter using $elemMatch

Create a variable called query and assign it an object that uses $elemMatch on the reviews field. The $elemMatch should look for a review with rating equal to 5 and comment containing the substring "excellent" using a regular expression.

MongoDB

const books = [
  {
    title: "MongoDB Basics",
    reviews: [
      { rating: 5, comment: "An excellent introduction" }
    ]
  },
  {
    title: "Advanced MongoDB",
    reviews: [
      { rating: 4, comment: "Good but not excellent" }
    ]
  }
];

// Create the query object using $elemMatch
// Your code here

Hint

Use $elemMatch with an object that has rating: 5 and comment with a regular expression to match "excellent" case-insensitively.

3

Apply the query to filter the books array

Create a variable called matchingBooks and assign it the result of filtering the books array using the query variable. Use the Array.filter() method and inside the callback, use Array.some() on the reviews array to check if any review matches the rating and comment conditions from query.

MongoDB

const books = [
  {
    title: "MongoDB Basics",
    reviews: [
      { rating: 5, comment: "An excellent introduction" }
    ]
  },
  {
    title: "Advanced MongoDB",
    reviews: [
      { rating: 4, comment: "Good but not excellent" }
    ]
  }
];

const query = {
  reviews: {
    $elemMatch: {
      rating: 5,
      comment: { $regex: /excellent/i }
    }
  }
};

// Filter books using query with Array.filter and Array.some
// Your code here

Hint

Use filter on books and inside use some on reviews. Compare rating and test comment with the regex.

4

Complete the query by exporting the matching books

Add a line to export the matchingBooks variable using module.exports so it can be used in other files.

MongoDB

const books = [
  {
    title: "MongoDB Basics",
    reviews: [
      { rating: 5, comment: "An excellent introduction" }
    ]
  },
  {
    title: "Advanced MongoDB",
    reviews: [
      { rating: 4, comment: "Good but not excellent" }
    ]
  }
];

const query = {
  reviews: {
    $elemMatch: {
      rating: 5,
      comment: { $regex: /excellent/i }
    }
  }
};

const matchingBooks = books.filter(book =>
  book.reviews.some(review =>
    review.rating === query.reviews.$elemMatch.rating &&
    query.reviews.$elemMatch.comment.$regex.test(review.comment)
  )
);

// Export matchingBooks
// Your code here

Hint

Use module.exports = { matchingBooks } to export the variable.

Practice

1. What does the $elemMatch operator do in MongoDB queries?

easy

A. Matches documents where any array element matches any one condition.

B. Updates all elements in an array regardless of conditions.

C. Finds array elements that match all specified conditions together.

D. Deletes array elements that do not match the condition.

Solution

1. Step 1: Understand array queries

   MongoDB arrays can contain multiple elements, and queries may need to check multiple conditions on the same element.

2. Step 2: Role of $elemMatch

   $elemMatch ensures all conditions apply to the same array element, not spread across different elements.

3. Final Answer:

   Finds array elements that match all specified conditions together. -> Option C

4. Quick Check:

   $elemMatch = all conditions on one element [OK]

Hint: Use $elemMatch to match multiple conditions on one array item [OK]

Common Mistakes:

• Thinking $elemMatch matches conditions across different elements
• Confusing $elemMatch with $in or $all
• Assuming $elemMatch updates or deletes elements

2. Which of the following is the correct syntax to find documents where an array field scores has an element with score greater than 80 and type equal to 'exam' using $elemMatch?

easy

A. { scores: { $elemMatch: { $gt: 80, type: 'exam' } } }

B. { scores: { $elemMatch: { score: { $gt: 80 } }, type: 'exam' } }

C. { scores: { $elemMatch: { score: { $gt: 80 } }, type: { $eq: 'exam' } } }

D. { scores: { $elemMatch: { score: { $gt: 80 }, type: 'exam' } } }

Solution

1. Step 1: Understand $elemMatch syntax

   The correct syntax requires an object inside $elemMatch with each condition as a field: score with $gt operator and type with exact match.

2. Step 2: Analyze options

   { scores: { $elemMatch: { $gt: 80, type: 'exam' } } } misuses $gt without a field name. { scores: { $elemMatch: { score: { $gt: 80 } }, type: 'exam' } } incorrectly places type outside $elemMatch. { scores: { $elemMatch: { score: { $gt: 80 } }, type: { $eq: 'exam' } } } also incorrectly places type outside $elemMatch. { scores: { $elemMatch: { score: { $gt: 80 }, type: 'exam' } } } correctly places both conditions inside $elemMatch.

3. Final Answer:

   { scores: { $elemMatch: { score: { $gt: 80 }, type: 'exam' } } } -> Option D

4. Quick Check:

   Both conditions inside $elemMatch object [OK]

Hint: Put all conditions inside one $elemMatch object [OK]

Common Mistakes:

• Placing some conditions outside $elemMatch
• Using $gt without field name
• Misplacing the type condition outside $elemMatch

3. Given the collection documents:

{ _id: 1, grades: [ { score: 85, type: 'exam' }, { score: 70, type: 'quiz' } ] }

{ _id: 2, grades: [ { score: 90, type: 'quiz' }, { score: 75, type: 'exam' } ] }

What documents will this query return?

{ grades: { $elemMatch: { score: { $gt: 80 }, type: 'exam' } } }

medium

A. Only document with _id: 1

B. Only document with _id: 2

C. Both documents with _id: 1 and _id: 2

D. No documents

Solution

1. Step 1: Check document _id: 1

   It has grades with score 85 and type 'exam' which matches score > 80 and type 'exam'. So it matches.

2. Step 2: Check document _id: 2

   Grades are {score: 90, type: 'quiz'} and {score: 75, type: 'exam'}. No single element has both score > 80 and type 'exam' together.

3. Final Answer:

   Only document with _id: 1 -> Option A

4. Quick Check:

   Match requires both conditions on same element [OK]

Hint: Check each array element for all conditions together [OK]

Common Mistakes:

• Matching documents if conditions appear in different elements
• Ignoring the type field condition
• Assuming any element with score > 80 matches

4. You wrote this query to find documents where items array has an element with price less than 20 and qty greater than 5:

{ items: { $elemMatch: { price: { $lt: 20 }, qty: { $gt: 5 } } } }

But it returns no results, even though you know such documents exist. What is the likely problem?

medium

A. You should use $and instead of $elemMatch.

B. The fields price and qty are not in the same array element.

C. The query syntax is invalid and causes an error.

D. MongoDB does not support comparison operators inside $elemMatch.

Solution

1. Step 1: Understand $elemMatch behavior

   $elemMatch requires all conditions to be true on the same array element.

2. Step 2: Analyze the problem

   If price < 20 and qty > 5 exist but in different elements, the query returns no results because no single element satisfies both.

3. Final Answer:

   The fields price and qty are not in the same array element. -> Option B

4. Quick Check:

   All conditions must match one element [OK]

Hint: Check if conditions apply to same array element [OK]

Common Mistakes:

• Assuming $elemMatch matches conditions across elements
• Thinking $and replaces $elemMatch for arrays
• Believing MongoDB disallows operators inside $elemMatch

5. You have a collection of products with a field reviews which is an array of objects like { rating: Number, user: String, verified: Boolean }. You want to find products that have at least one review with rating >= 4, user 'Alice', and verified true. Which query correctly uses $elemMatch to achieve this?

hard

A. { reviews: { $elemMatch: { rating: { $gte: 4 }, user: 'Alice', verified: true } } }

B. { reviews: { rating: { $gte: 4 }, user: 'Alice', verified: true } }

C. { reviews: { $all: [ { rating: { $gte: 4 } }, { user: 'Alice' }, { verified: true } ] } }

D. { reviews: { $elemMatch: { rating: 4, user: 'Alice', verified: true } } }

Solution

1. Step 1: Understand the conditions

   We want one review element where rating is at least 4, user is 'Alice', and verified is true.

2. Step 2: Analyze query options

   { reviews: { $elemMatch: { rating: { $gte: 4 }, user: 'Alice', verified: true } } } correctly uses $elemMatch with all conditions combined, including $gte for rating. { reviews: { rating: { $gte: 4 }, user: 'Alice', verified: true } } misses $elemMatch, so conditions apply to different elements. { reviews: { $all: [ { rating: { $gte: 4 } }, { user: 'Alice' }, { verified: true } ] } } misuses $all which matches elements individually, not combined. { reviews: { $elemMatch: { rating: 4, user: 'Alice', verified: true } } } uses rating: 4 (exact), not >= 4.

3. Final Answer:

   { reviews: { $elemMatch: { rating: { $gte: 4 }, user: 'Alice', verified: true } } } -> Option A

4. Quick Check:

   Use $elemMatch with all conditions and correct operators [OK]

Hint: Combine all conditions inside $elemMatch with correct operators [OK]

Common Mistakes:

• Omitting $elemMatch causing wrong matches
• Using exact match instead of comparison operators
• Using $all which checks elements separately