Skip to content

Commit fc70008

Browse files
committed
Rename response position to execution position
1 parent 67f07f7 commit fc70008

File tree

3 files changed

+36
-35
lines changed

3 files changed

+36
-35
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: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -599,14 +599,14 @@ 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
609-
have not yet yielded a value may be cancelled to avoid unnecessary work.
608+
If this occurs, any sibling _execution position_ which has not yet executed or
609+
has not yet yielded a value may be cancelled to avoid unnecessary work.
610610

611611
Note: See [Handling Execution Errors](#sec-Handling-Execution-Errors) for more
612612
about this behavior.
@@ -902,40 +902,40 @@ ResolveAbstractType(abstractType, objectValue):
902902
</a>
903903

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

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

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

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

923-
If a _response position_ resolves to {null} because of an execution error which
923+
If a _execution position_ resolves to {null} because of an execution error which
924924
has already been added to the {"errors"} list in the _execution result_, the
925925
{"errors"} list must not be further affected. That is, each error added to the
926926
errors list during execution must have a unique _response path_.
927927

928-
Since `Non-Null` response positions cannot be {null}, execution errors are
929-
propagated to be handled by the parent _response position_. If the parent
930-
response position may be {null} then it resolves to {null}, otherwise if it is a
931-
`Non-Null` type, the execution error is further propagated to its parent
932-
_response position_.
928+
Since `Non-Null` execution positions cannot be {null}, execution errors are
929+
propagated to be handled by the parent _execution position_. If the parent
930+
execution position may be {null} then it resolves to {null}, otherwise if it is
931+
a `Non-Null` type, the execution error is further propagated to its parent
932+
_execution position_.
933933

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

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

spec/Section 7 -- Response.md

Lines changed: 16 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -76,18 +76,18 @@ The value of this entry is described in the "Extensions" section.
7676
<!-- Legacy link, this section was previously titled "Path" -->
7777
</a>
7878

79-
:: A _response position_ is a uniquely identifiable position in the response
79+
:: A _execution position_ is a uniquely identifiable position 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()}. Each response position is
82+
nested) List value evaluated by {CompleteValue()}. Each execution position is
8383
uniquely identifiable via a _response path_.
8484

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
8686
error propagation.
8787

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
8989
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.
9191

9292
The value for a _response path_ must be a list of path segments. Path segments
9393
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
9696
represents a path in the response, not in the request.
9797

9898
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.
100100

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,
102103

103104
```graphql example
104105
{
@@ -111,7 +112,7 @@ A single field execution may result in multiple response positions. For example,
111112
}
112113
```
113114

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
115116
_response path_ `["hero", "name"]`. The List of the hero's friends would be
116117
found at `["hero", "friends"]`, the hero's first friend at
117118
`["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
125126
output will be an object of the mutation root operation type.
126127

127128
The response data is the result of accumulating the resolved result of all
128-
response positions during execution.
129+
execution positions during execution.
129130

130131
If an error was raised before execution begins, the _response_ must be a
131132
_request error result_ which will result in no response data.
@@ -168,12 +169,12 @@ _field error_.
168169

169170
An execution error is typically the fault of a GraphQL service.
170171

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
173174
indicated via a _response path_ in the error response's {"path"} entry.
174175

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
177178
(except {null}), and the {"errors"} entry must include the error. Nested
178179
execution is halted and sibling execution attempts to continue, producing
179180
partial result (see
@@ -193,8 +194,8 @@ associated syntax element.
193194

194195
If an error can be associated to a particular field in the GraphQL result, it
195196
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
198199
_execution error_.
199200

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

0 commit comments

Comments
 (0)