Search across types in GraphQL - Step-by-Step Execution

Concept Flow - Search across types

Start Search Query

↓

Identify Types to Search

↓

Execute Search on Each Type

↓

Collect Results from All Types

↓

Combine Results into Single List

↓

Return Combined Results to Client

The search query runs on multiple types, collects results, and returns them combined.

Execution Sample

GraphQL

query SearchAll($term: String!) {
  search(term: $term) {
    __typename
    ... on Book {
      title
      author
    }
    ... on Author {
      name
      books {
        title
      }
    }
  }
}

This query searches for a term across Book and Author types and returns matching fields.

Execution Table

Step	Action	Type Searched	Search Term	Results Found	Combined Results
1	Start search query	N/A	"GraphQL"	N/A	[]
2	Search Books	Book	"GraphQL"	[{"title": "Learning GraphQL", "author": "Eve"}]	[{"title": "Learning GraphQL", "author": "Eve"}]
3	Search Authors	Author	"GraphQL"	[{"name": "Eve", "books": [{"title": "Learning GraphQL"}]}]	[{"title": "Learning GraphQL", "author": "Eve"}, {"name": "Eve", "books": [{"title": "Learning GraphQL"}]}]
4	Return combined results	N/A	N/A	N/A	[{"title": "Learning GraphQL", "author": "Eve"}, {"name": "Eve", "books": [{"title": "Learning GraphQL"}]}]

💡 All types searched and results combined, query returns combined list.

Variable Tracker

Variable	Start	After Step 2	After Step 3	Final
searchTerm	"GraphQL"	"GraphQL"	"GraphQL"	"GraphQL"
bookResults	[]	[{"title": "Learning GraphQL", "author": "Eve"}]	[{"title": "Learning GraphQL", "author": "Eve"}]	[{"title": "Learning GraphQL", "author": "Eve"}]
authorResults	[]	[]	[{"name": "Eve", "books": [{"title": "Learning GraphQL"}]}]	[{"name": "Eve", "books": [{"title": "Learning GraphQL"}]}]
combinedResults	[]	[{"title": "Learning GraphQL", "author": "Eve"}]	[{"title": "Learning GraphQL", "author": "Eve"}, {"name": "Eve", "books": [{"title": "Learning GraphQL"}]}]	[{"title": "Learning GraphQL", "author": "Eve"}, {"name": "Eve", "books": [{"title": "Learning GraphQL"}]}]

Key Moments - 3 Insights

Why do we need to include __typename in the query?

Including __typename helps identify which type each result belongs to when combining results from multiple types, as shown in execution_table step 4.

How are results combined from different types?

Results from each type are collected separately and then merged into one list, as seen in combinedResults variable in variable_tracker after step 3.

What happens if no results are found in one type?

If a type returns no results, its result list is empty but the combined results still include results from other types, ensuring no data loss.

Visual Quiz - 3 Questions

Look at the execution_table at step 3, what is the combinedResults value?

A [{"title": "Learning GraphQL", "author": "Eve"}]

B [{"title": "Learning GraphQL", "author": "Eve"}, {"name": "Eve", "books": [{"title": "Learning GraphQL"}]}]

C [{"name": "Eve", "books": [{"title": "Learning GraphQL"}]}]

D []

💡 Hint

Check the Combined Results column in execution_table row for step 3.

At which step does the search query return the final combined results?

A Step 4

B Step 1

C Step 3

D Step 2

💡 Hint

Look for the step labeled 'Return combined results' in execution_table.

If the search term changes, which variable in variable_tracker changes accordingly?

A bookResults

B authorResults

C searchTerm

D combinedResults

💡 Hint

Look at the searchTerm variable values across steps in variable_tracker.

Concept Snapshot

Search across types in GraphQL:
- Use a single query with fragments for each type.
- Include __typename to identify result types.
- Search each type separately.
- Combine all results into one list.
- Return combined results to client.

Full Transcript

This visual execution shows how a GraphQL search query runs across multiple types. The query starts by receiving a search term. It then searches the Book type and collects matching books. Next, it searches the Author type and collects matching authors. Each type's results are stored separately. Then, all results are combined into one list. Finally, the combined list is returned to the client. Including __typename in the query helps identify which type each result belongs to. If one type has no results, the others still return their matches. This process ensures a unified search experience across different data types.