@@ -76,18 +76,18 @@ The value of this entry is described in the "Extensions" section.
76
76
<!-- Legacy link, this section was previously titled "Path" -->
77
77
</a >
78
78
79
- :: A _ response position_ is a uniquely identifiable position in the response
79
+ :: A _ execution position_ is a uniquely identifiable position in the response
80
80
structure evaluated during execution. It may correspond to a {responseName}
81
81
evaluated by {ExecuteCollectedFields()}, or to an element within a (potentially
82
- nested) List value evaluated by {CompleteValue()}. Each response position is
82
+ nested) List value evaluated by {CompleteValue()}. Each execution position is
83
83
uniquely identifiable via a _ response path_ .
84
84
85
- Note: A _ response position_ may be omitted from the _ execution result_ due to
85
+ Note: An _ execution position_ may be omitted from the _ execution result_ due to
86
86
error propagation.
87
87
88
- :: A _ response path_ uniquely identifies a _ response position_ via a list of
88
+ :: A _ response path_ uniquely identifies an _ execution position_ via a list of
89
89
path segments (response names or list indices) starting at the root of the
90
- response and ending with the associated response position.
90
+ response and ending with the associated execution position.
91
91
92
92
The value for a _ response path_ must be a list of path segments. Path segments
93
93
that represent field _ response name_ must be strings, and path segments that
@@ -96,9 +96,10 @@ associated with an aliased field it must use the aliased name, since it
96
96
represents a path in the response, not in the request.
97
97
98
98
When a _ response path_ is present on an _ error result_ , it identifies the
99
- _ response position_ which raised the error.
99
+ _ execution position_ which raised the error.
100
100
101
- A single field execution may result in multiple response positions. For example,
101
+ A single field execution may result in multiple execution positions. For
102
+ example,
102
103
103
104
``` graphql example
104
105
{
@@ -111,7 +112,7 @@ A single field execution may result in multiple response positions. For example,
111
112
}
112
113
```
113
114
114
- The hero's name would be found in the _ response position_ identified by the
115
+ The hero's name would be found in the _ execution position_ identified by the
115
116
_ response path_ ` ["hero", "name"] ` . The List of the hero's friends would be
116
117
found at ` ["hero", "friends"] ` , the hero's first friend at
117
118
` ["hero", "friends", 0] ` and that friend's name at
@@ -125,7 +126,7 @@ object of the query root operation type; if the operation was a mutation, this
125
126
output will be an object of the mutation root operation type.
126
127
127
128
The response data is the result of accumulating the resolved result of all
128
- response positions during execution.
129
+ execution positions during execution.
129
130
130
131
If an error was raised before execution begins, the _ response_ must be a
131
132
_ request error result_ which will result in no response data.
@@ -168,12 +169,12 @@ _field error_.
168
169
169
170
An execution error is typically the fault of a GraphQL service.
170
171
171
- An _ execution error_ must occur at a specific _ response position_ , and may occur
172
- in any response position. The response position of an execution error is
172
+ An _ execution error_ must occur at a specific _ execution position_ , and may
173
+ occur in any execution position. The execution position of an execution error is
173
174
indicated via a _ response path_ in the error response's {"path"} entry.
174
175
175
- When an execution error is raised at a given _ response position_ , then that
176
- response position must not be present within the _ response_ {"data"} entry
176
+ When an execution error is raised at a given _ execution position_ , then that
177
+ execution position must not be present within the _ response_ {"data"} entry
177
178
(except {null}), and the {"errors"} entry must include the error. Nested
178
179
execution is halted and sibling execution attempts to continue, producing
179
180
partial result (see
@@ -193,8 +194,8 @@ associated syntax element.
193
194
194
195
If an error can be associated to a particular field in the GraphQL result, it
195
196
must contain an entry with the key {"path"} with a _ response path_ which
196
- describes the _ response position_ which raised the error. This allows clients to
197
- identify whether a {null} resolved result is a true value or the result of an
197
+ describes the _ execution position_ which raised the error. This allows clients
198
+ to identify whether a {null} resolved result is a true value or the result of an
198
199
_ execution error_ .
199
200
200
201
For example, if fetching one of the friends' names fails in the following
0 commit comments