Parent (root) argument in GraphQL

Introduction

The parent (root) argument helps you access data from the previous level when fetching nested information in GraphQL.

When you want to get related data inside a nested query.

When resolving fields that depend on data from the parent object.

When building a list of items connected to a main item.

When you need to fetch details based on the current object in the query.

Syntax

GraphQL

fieldName(parent, args, context, info) {
  // use parent to get data from the previous level
}

parent is the first argument and holds data from the previous resolver.

You use parent to access fields already fetched before.

Examples

Here, posts resolver uses parent.id to get posts for the user fetched in the user resolver.

GraphQL

user(parent, args, context, info) {
  return getUserById(args.id);
}

posts(parent, args, context, info) {
  return getPostsByUserId(parent.id);
}

The author resolver uses parent.authorId from the book to fetch the author details.

GraphQL

book(parent, args, context, info) {
  return getBookById(args.id);
}
author(parent, args, context, info) {
  return getAuthorById(parent.authorId);
}

Sample Program

This example shows a user with posts. The posts resolver uses parent.id to find posts for that user.

GraphQL

const resolvers = {
  Query: {
    user(parent, args, context, info) {
      return { id: 1, name: 'Alice' };
    }
  },
  User: {
    posts(parent, args, context, info) {
      return [
        { id: 101, title: 'Hello World', userId: parent.id },
        { id: 102, title: 'GraphQL Basics', userId: parent.id }
      ];
    }
  }
};

// Query:
// {
//   user {
//     name
//     posts {
//       title
//     }
//   }
// }

Important Notes

The parent argument is often called root or source in some tutorials.

If you are at the top query level, parent is usually undefined or an empty object.

Summary

The parent argument gives access to data from the previous resolver.

It is useful for nested queries to connect related data.

Always remember parent is the first argument in resolver functions.

Practice

1. What does the parent argument represent in a GraphQL resolver function?

easy

A. It is the root query object that starts the GraphQL execution.

B. It is the context object shared across all resolvers.

C. It contains the arguments passed to the current query.

D. It holds the result of the previous resolver in the resolver chain.

Solution

1. Step 1: Understand resolver chaining

   Resolvers can be nested, so the parent argument holds the output of the previous resolver in the chain.

2. Step 2: Differentiate from other arguments

   The context is shared globally, args are query inputs, and root is the initial query object, not the parent.

3. Final Answer:

   It holds the result of the previous resolver in the resolver chain. -> Option D

4. Quick Check:

   parent = previous resolver result [OK]

Hint: Remember: parent is previous resolver's output [OK]

Common Mistakes:

• Confusing parent with context
• Thinking parent holds query arguments
• Assuming parent is always the root query

2. Which of the following is the correct way to define a resolver function using the parent argument in GraphQL?

easy

A. resolver(parent, args, context, info) { ... }

B. resolver(args, parent, context, info) { ... }

C. resolver(context, parent, args, info) { ... }

D. resolver(info, args, parent, context) { ... }

Solution

1. Step 1: Recall resolver argument order

   The standard resolver function signature is resolver(parent, args, context, info).

2. Step 2: Verify argument positions

   Only resolver(parent, args, context, info) { ... } matches the correct order with parent as the first argument.

3. Final Answer:

   resolver(parent, args, context, info) { ... } -> Option A

4. Quick Check:

   Parent is first argument in resolver [OK]

Hint: Parent is always first argument in resolver [OK]

Common Mistakes:

• Swapping parent and args positions
• Placing context before parent
• Misordering resolver parameters

3. Given the following GraphQL schema and resolvers, what will be the output of the query { user { id name posts { title } } }?

type User {
  id: ID!
  name: String!
  posts: [Post!]!
}

type Post {
  title: String!
}

const resolvers = {
  User: {
    posts(parent) {
      return postsData.filter(post => post.userId === parent.id);
    }
  }
};

const postsData = [
  { title: "Post 1", userId: "1" },
  { title: "Post 2", userId: "2" },
  { title: "Post 3", userId: "1" }
];

medium

A. { "user": { "id": "2", "name": "Bob", "posts": [{ "title": "Post 1" }, { "title": "Post 3" }] } }

B. { "user": { "id": "1", "name": "Alice", "posts": [{ "title": "Post 2" }] } }

C. { "user": { "id": "1", "name": "Alice", "posts": [{ "title": "Post 1" }, { "title": "Post 3" }] } }

D. Error: posts resolver missing parent argument

Solution

1. Step 1: Understand parent argument usage in posts resolver

   The posts resolver uses parent.id to filter posts belonging to the user.

2. Step 2: Match posts with user id "1"

   Posts with userId === "1" are "Post 1" and "Post 3".

3. Final Answer:

   { "user": { "id": "1", "name": "Alice", "posts": [{ "title": "Post 1" }, { "title": "Post 3" }] } } -> Option C

4. Quick Check:

   Parent.id filters posts correctly [OK]

Hint: Parent holds user data to filter posts [OK]

Common Mistakes:

• Ignoring parent.id and returning all posts
• Mixing user IDs in filtering
• Assuming posts resolver lacks parent argument

4. Identify the error in this resolver function using the parent argument:

const resolvers = {
  User: {
    posts(args) {
      return postsData.filter(post => post.userId === args.id);
    }
  }
};

medium

A. The resolver should not use filter on postsData.

B. The resolver is missing the parent argument as the first parameter.

C. The resolver should use context instead of args.

D. The resolver function name should be Posts with uppercase P.

Solution

1. Step 1: Check resolver function parameters

   The resolver function must have parent as the first argument to access parent data.

2. Step 2: Identify misuse of args instead of parent

   The code incorrectly uses args.id instead of parent.id to filter posts.

3. Final Answer:

   The resolver is missing the parent argument as the first parameter. -> Option B

4. Quick Check:

   Parent argument must be first in resolver [OK]

Hint: Always include parent as first resolver argument [OK]

Common Mistakes:

• Using args instead of parent for parent data
• Ignoring resolver parameter order
• Assuming function name case matters

5. You want to fetch a list of books with their authors' names using nested resolvers. The Book type has an authorId field, and the Author type has id and name. How should you use the parent argument in the author resolver inside Book to get the correct author name?

hard

A. Use parent.authorId to find the author by matching id.

B. Use args.authorId to find the author by matching id.

C. Use context.authorId to find the author by matching id.

D. Use info.authorId to find the author by matching id.

Solution

1. Step 1: Understand nested resolver data flow

   The author resolver inside Book receives the book object as parent.

2. Step 2: Access authorId from parent to find author

   Use parent.authorId to look up the author by matching id in authors data.

3. Final Answer:

   Use parent.authorId to find the author by matching id. -> Option A

4. Quick Check:

   Parent holds book data, use parent.authorId [OK]

Hint: Parent holds book; use parent.authorId for author lookup [OK]

Common Mistakes:

• Using args instead of parent for authorId
• Trying to get authorId from context or info
• Ignoring parent argument in nested resolver