Nested field queries in GraphQL - Mini Project: Build & Apply

Nested Field Queries in GraphQL

📖 Scenario: You are building a simple GraphQL API for a bookstore. The bookstore has books, and each book has an author with details. You want to learn how to write queries that fetch nested information about books and their authors.

🎯 Goal: Create a GraphQL query that fetches a list of books with their titles and the nested author details including the author's name and email.

📋 What You'll Learn

Create a query named books that returns a list of books.

Each book should include the fields title and author.

The author field should be a nested object with name and email fields.

Use proper GraphQL syntax for nested field queries.

💡 Why This Matters

🌍 Real World

Nested queries are common when fetching related data in APIs, such as books and their authors, products and their categories, or users and their posts.

💼 Career

Understanding nested queries is essential for working with GraphQL APIs in web development, backend services, and mobile apps.

1

Create the basic books query

Write a GraphQL query named books that fetches only the title field of each book.

GraphQL

# Write the books query fetching only the title
{
  books {
    title
  }
}

Hint

Start with the root field books and select the title field inside it.

2

Add the author nested field

Extend the books query to include the nested author field.

GraphQL

{
  books {
    title
    author {
      
    }
  }
}
# Add the author nested field inside books

Hint

Inside books, add the author field as an object.

3

Select author name and email fields

Inside the author nested field, select the name and email fields.

GraphQL

{
  books {
    title
    author {
      # Select name and email fields here
    }
  }
}

Hint

Inside author, list the fields name and email to fetch those details.

4

Complete the nested field query

Ensure the full query fetches title of books and nested author details with name and email fields.

GraphQL

{
  books {
    title
    author {
      name
      email
    }
  }
}
# Finalize the nested query

Hint

Check that all required fields are included in the query with correct nesting.

Practice

1. What is the main purpose of using nested field queries in GraphQL?

easy

A. To fetch related data in a single request

B. To update multiple records at once

C. To delete nested data automatically

D. To create new nested fields in the schema

Solution

1. Step 1: Understand nested queries

   Nested queries allow fetching related data together, reducing multiple requests.

2. Step 2: Compare options

   Only To fetch related data in a single request describes fetching related data in one request, which is the key benefit.

3. Final Answer:

   To fetch related data in a single request -> Option A

4. Quick Check:

   Nested queries = fetch related data [OK]

Hint: Nested queries fetch related data together in one request [OK]

Common Mistakes:

• Thinking nested queries update or delete data
• Confusing nested queries with schema creation
• Assuming nested queries only fetch top-level fields

2. Which of the following is the correct syntax to query a nested field author inside book in GraphQL?

easy

A. { book > author { name } }

B. { book { author { name } } }

C. { book: { author { name } } }

D. { book.author { name } }

Solution

1. Step 1: Recall GraphQL nested syntax

   Nested fields are queried using curly braces inside parent fields without dots or colons.

2. Step 2: Check each option

   { book { author { name } } } uses correct nested braces. Options A, B, and C use invalid syntax like dots, colons, or arrows.

3. Final Answer:

   { book { author { name } } } -> Option B

4. Quick Check:

   Nested fields use braces, not dots or colons [OK]

Hint: Use curly braces for nested fields, no dots or colons [OK]

Common Mistakes:

• Using dot notation instead of braces
• Adding colons inside query fields
• Using arrows or other symbols for nesting

3. Given this GraphQL query:

{ user(id: 1) { name posts { title comments { text } } } }

What fields will be included in the response?

medium

A. User's name and comments' texts only

B. Only user's name and posts' titles

C. User's name, posts' titles, and comments' texts

D. Only posts' titles and comments' texts

Solution

1. Step 1: Analyze the query structure

   The query requests user with id 1, then nested fields: name, posts with title, and comments with text inside posts.

2. Step 2: Determine included fields

   All requested fields appear in the response: user's name, posts' titles, and comments' texts.

3. Final Answer:

   User's name, posts' titles, and comments' texts -> Option C

4. Quick Check:

   Nested query fields = all requested fields [OK]

Hint: Response includes all nested fields requested in braces [OK]

Common Mistakes:

• Ignoring nested comments field
• Assuming only top-level fields return
• Confusing which fields are nested

4. Identify the error in this GraphQL query:

{ product { id name { first last } } }

medium

A. Missing parentheses after product

B. Field id cannot be queried with name

C. Curly braces are not allowed inside queries

D. Field name is treated as an object but should be scalar

Solution

1. Step 1: Understand field types

   If name is a scalar (like string), it cannot have nested fields first and last.

2. Step 2: Check query structure

   The query treats name as an object with nested fields, causing an error if schema defines it as scalar.

3. Final Answer:

   Field name is treated as an object but should be scalar -> Option D

4. Quick Check:

   Scalar fields cannot have nested fields [OK]

Hint: Only object fields can have nested fields; scalars cannot [OK]

Common Mistakes:

• Assuming all fields can have nested fields
• Adding parentheses unnecessarily
• Misunderstanding query braces usage

5. You want to fetch a list of authors with their books and each book's reviews including rating and comment. Which query correctly nests these fields?

hard

A. { authors { name books { title reviews { rating comment } } } }

B. { authors { name books { title } reviews { rating comment } } }

C. { authors { name { books { title reviews { rating comment } } } } }

D. { authors { name books reviews { rating comment } } }

Solution

1. Step 1: Understand nesting requirements

   Reviews belong to each book, so reviews must be nested inside books.

2. Step 2: Check each option's nesting

   { authors { name books { title reviews { rating comment } } } } correctly nests reviews inside books. { authors { name books { title } reviews { rating comment } } } places reviews outside books. { authors { name { books { title reviews { rating comment } } } } } nests books inside name incorrectly. { authors { name books reviews { rating comment } } } misses nesting reviews inside books.

3. Final Answer:

   { authors { name books { title reviews { rating comment } } } } -> Option A

4. Quick Check:

   Nested fields must follow data hierarchy [OK]

Hint: Nest fields inside their parent objects to match data structure [OK]

Common Mistakes:

• Placing nested fields at wrong levels
• Nesting fields inside scalar fields
• Missing braces for nested objects