Skip to content

Commit 608ed6c

Browse files
committed
Editorial: Clarify meta-fields in introspection
Derived from #777 Renames "field" to "meta-field" consistently. Adds "with the single exception of the subscription root operation type". Clarifies some language.
1 parent c43d2f7 commit 608ed6c

File tree

1 file changed

+10
-7
lines changed

1 file changed

+10
-7
lines changed

spec/Section 4 -- Introspection.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -89,14 +89,17 @@ warnings.
8989

9090
## Type Name Introspection
9191

92-
GraphQL supports type name introspection at any point within a query by the
93-
meta-field `__typename: String!` when querying against any Object, Interface,
94-
or Union. It returns the name of the object type currently being queried.
92+
GraphQL supports type name introspection at any selection set within an
93+
operation with the meta-field `__typename: String!` on any Object,
94+
Interface, or Union; with the single exception of the subscription root
95+
operation type. It returns the name of the concrete Object type at that point
96+
during execution.
9597

9698
This is most often used when querying against Interface or Union types to
97-
identify which actual type of the possible types has been returned.
99+
identify which actual Object type of the possible types has been returned.
98100

99-
This field is implicit and does not appear in the fields list in any defined type.
101+
This meta-field is implicit and does not appear in the fields list in any
102+
defined type.
100103

101104

102105
## Schema Introspection
@@ -110,8 +113,8 @@ __schema: __Schema!
110113
__type(name: String!): __Type
111114
```
112115

113-
These fields are implicit and do not appear in the fields list in the root type
114-
of the query operation.
116+
These meta-fields are implicit and do not appear in the fields list in the root
117+
type of the query operation.
115118

116119
The schema of the GraphQL schema introspection system:
117120

0 commit comments

Comments
 (0)