Skip to content

Commit a3092d9

Browse files
committed
Rename response position to execution position
1 parent 15d2a32 commit a3092d9

File tree

3 files changed

+38
-37
lines changed

3 files changed

+38
-37
lines changed

spec/Section 3 -- Type System.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1876,9 +1876,9 @@ performed. If that result was not {null}, then the result of coercing the
18761876
Non-Null type is that result. If that result was {null}, then an _execution
18771877
error_ must be raised.
18781878

1879-
Note: When an _execution error_ is raised on a non-null _response position_, the
1880-
error propagates to the parent _response position_. For more information on this
1881-
process, see
1879+
Note: When an _execution error_ is raised on a non-null _execution position_,
1880+
the error propagates to the parent _execution position_. For more information on
1881+
this process, see
18821882
[Errors and Non-Null Types](#sec-Executing-Selection-Sets.Errors-and-Non-Null-Types)
18831883
within the Execution section.
18841884

spec/Section 6 -- Execution.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -599,15 +599,15 @@ section.
599599
<!-- Legacy link, this section was previously titled "Errors and Non-Null Fields" -->
600600
</a>
601601

602-
If during {ExecuteCollectedFields()} a _response position_ with a non-null type
602+
If during {ExecuteCollectedFields()} a _execution position_ with a non-null type
603603
raises an _execution error_ then that error must propagate to the parent
604-
response position (the entire selection set in the case of a field, or the
604+
execution position (the entire selection set in the case of a field, or the
605605
entire list in the case of a list position), either resolving to {null} if
606-
allowed or being further propagated to a parent response position.
606+
allowed or being further propagated to a parent execution position.
607607

608-
If this occurs, any sibling response positions which have not yet executed or
608+
If this occurs, any sibling execution positions which have not yet executed or
609609
have not yet yielded a value may be cancelled to avoid unnecessary work. Any
610-
errors raised by these sibling response positions must not be added to the
610+
errors raised by these sibling execution positions must not be added to the
611611
{"errors"} list in the _execution result_.
612612

613613
Note: See [Handling Execution Errors](#sec-Handling-Execution-Errors) for more
@@ -904,45 +904,45 @@ ResolveAbstractType(abstractType, objectValue):
904904
</a>
905905

906906
An _execution error_ is an error raised during field execution, value resolution
907-
or coercion, at a specific _response position_. While these errors must be
907+
or coercion, at a specific _execution position_. While these errors must be
908908
reported in the response, they are "handled" by producing partial {"data"} in
909909
the _response_.
910910

911911
Note: This is distinct from a _request error_ which results in a _request error
912912
result_ with no data.
913913

914914
If an execution error is raised while resolving a field (either directly or
915-
nested inside any lists), it is handled as though the _response position_ at
915+
nested inside any lists), it is handled as though the _execution position_ at
916916
which the error occurred resolved to {null}, and the error must be added to the
917917
{"errors"} list in the _execution result_.
918918

919-
If the result of resolving a _response position_ is {null} (either due to the
919+
If the result of resolving a _execution position_ is {null} (either due to the
920920
result of {ResolveFieldValue()} or because an execution error was raised), and
921921
that position is of a `Non-Null` type, then an execution error is raised at that
922922
position. The error must be added to the {"errors"} list in the _execution
923923
result_.
924924

925-
If a _response position_ resolves to {null} because of an execution error which
925+
If a _execution position_ resolves to {null} because of an execution error which
926926
has already been added to the {"errors"} list in the _execution result_, the
927-
{"errors"} list must not be further affected. If a sibling field of a response
927+
{"errors"} list must not be further affected. If a sibling field of an execution
928928
position that triggered error propagation also raises an error, this additional
929929
error must not be added to the {"errors"} list.
930930

931931
Note: The result of the above is that exactly one error must be added to the
932932
{"errors"} list for each {null} appearing in the _execution response_ because of
933933
an error (including due to error propagation).
934934

935-
Since `Non-Null` response positions cannot be {null}, execution errors are
936-
propagated to be handled by the parent _response position_. If the parent
937-
response position may be {null} then it resolves to {null}, otherwise if it is a
938-
`Non-Null` type, the execution error is further propagated to its parent
939-
_response position_.
935+
Since `Non-Null` execution positions cannot be {null}, execution errors are
936+
propagated to be handled by the parent _execution position_. If the parent
937+
execution position may be {null} then it resolves to {null}, otherwise if it is
938+
a `Non-Null` type, the execution error is further propagated to its parent
939+
_execution position_.
940940

941-
If a `List` type wraps a `Non-Null` type, and one of the _response position_
942-
elements of that list resolves to {null}, then the entire list _response
941+
If a `List` type wraps a `Non-Null` type, and one of the _execution position_
942+
elements of that list resolves to {null}, then the entire list _execution
943943
position_ must resolve to {null}. If the `List` type is also wrapped in a
944944
`Non-Null`, the execution error continues to propagate upwards.
945945

946-
If every _response position_ from the root of the request to the source of the
946+
If every _execution position_ from the root of the request to the source of the
947947
execution error has a `Non-Null` type, then the {"data"} entry in the _execution
948948
result_ should be {null}.

spec/Section 7 -- Response.md

Lines changed: 17 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -70,22 +70,22 @@ The _request error result_ map must not contain an entry with key {"data"}.
7070
The _request error result_ map may also contain an entry with key `extensions`.
7171
The value of this entry is described in the "Extensions" section.
7272

73-
### Response Position
73+
### Execution Position
7474

7575
<a name="sec-Path">
7676
<!-- Legacy link, this section was previously titled "Path" -->
7777
</a>
7878

79-
:: A _response position_ is a uniquely identifiable location in the response
79+
:: An _execution position_ is a uniquely identifiable location in the response
8080
structure evaluated during execution. It may correspond to a {responseName}
8181
evaluated by {ExecuteCollectedFields()}, or to an element within a (potentially
82-
nested) List value evaluated by {CompleteValue()}. A _response position_ does
82+
nested) List value evaluated by {CompleteValue()}. An _execution position_ does
8383
not appear in the _execution result_ when elided by error propagation. Each
84-
response position is uniquely identifiable by a _response path_.
84+
execution position is uniquely identifiable by a _response path_.
8585

86-
:: A _response path_ uniquely identifies a _response position_ via a list of
86+
:: A _response path_ uniquely identifies an _execution position_ via a list of
8787
path segments (response names or list indices) starting at the root of the
88-
response and ending with the associated response position.
88+
response and ending with the associated execution position.
8989

9090
The value for a _response path_ must be a list of path segments. Path segments
9191
that represent field _response name_ must be strings, and path segments that
@@ -94,9 +94,10 @@ associated with an aliased field it must use the aliased name, since it
9494
represents a path in the response, not in the request.
9595

9696
When a _response path_ is present on an _error result_, it identifies the
97-
_response position_ which raised the error.
97+
_execution position_ which raised the error.
9898

99-
A single field execution may result in multiple response positions. For example,
99+
A single field execution may result in multiple execution positions. For
100+
example,
100101

101102
```graphql example
102103
{
@@ -109,7 +110,7 @@ A single field execution may result in multiple response positions. For example,
109110
}
110111
```
111112

112-
The hero's name would be found in the _response position_ identified by the
113+
The hero's name would be found in the _execution position_ identified by the
113114
_response path_ `["hero", "name"]`. The List of the hero's friends would be
114115
found at `["hero", "friends"]`, the hero's first friend at
115116
`["hero", "friends", 0]` and that friend's name at
@@ -123,7 +124,7 @@ object of the query root operation type; if the operation was a mutation, this
123124
output will be an object of the mutation root operation type.
124125

125126
The response data is the result of accumulating the resolved result of all
126-
response positions during execution.
127+
execution positions during execution.
127128

128129
If an error was raised before execution begins, the _response_ must be a
129130
_request error result_ which will result in no response data.
@@ -166,12 +167,12 @@ _field error_.
166167

167168
An execution error is typically the fault of a GraphQL service.
168169

169-
An _execution error_ must occur at a specific _response position_, and may occur
170-
in any response position. The response position of an execution error is
170+
An _execution error_ must occur at a specific _execution position_, and may
171+
occur in any execution position. The execution position of an execution error is
171172
indicated via a _response path_ in the error response's {"path"} entry.
172173

173-
When an execution error is raised at a given _response position_, then that
174-
response position must not be present within the _response_ {"data"} entry
174+
When an execution error is raised at a given _execution position_, then that
175+
execution position must not be present within the _response_ {"data"} entry
175176
(except {null}), and the {"errors"} entry must include the error. Nested
176177
execution is halted and sibling execution attempts to continue, producing
177178
partial result (see
@@ -191,8 +192,8 @@ associated syntax element.
191192

192193
If an error can be associated to a particular field in the GraphQL result, it
193194
must contain an entry with the key {"path"} with a _response path_ which
194-
describes the _response position_ which raised the error. This allows clients to
195-
identify whether a {null} resolved result is a true value or the result of an
195+
describes the _execution position_ which raised the error. This allows clients
196+
to identify whether a {null} resolved result is a true value or the result of an
196197
_execution error_.
197198

198199
For example, if fetching one of the friends' names fails in the following

0 commit comments

Comments
 (0)