Skip to content

Commit cc50991

Browse files
committed
Change NO_PROPAGATE to NULL
1 parent 7ab36b8 commit cc50991

File tree

1 file changed

+11
-20
lines changed

1 file changed

+11
-20
lines changed

spec/Section 6 -- Execution.md

Lines changed: 11 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,6 @@ A GraphQL service generates a response from a request via execution.
44

55
:: A _request_ for execution consists of a few pieces of information:
66

7-
<!-- https://github.com/prettier/prettier/issues/17286 -->
8-
<!-- prettier-ignore -->
97
- {schema}: The schema to use, typically solely provided by the GraphQL service.
108
- {document}: A {Document} which must contain GraphQL {OperationDefinition} and
119
may contain {FragmentDefinition}.
@@ -19,8 +17,8 @@ A GraphQL service generates a response from a request via execution.
1917
always use the same initial value for every request.
2018
- {onError} (optional): The _error behavior_ to apply to the request; see
2119
[Handling Execution Errors](#sec-Handling-Execution-Errors). If {onError} is
22-
provided and its value is not one of {"PROPAGATE"}, {"NO_PROPAGATE"}, or
23-
{"HALT"}, then a _request error_ must be raised.
20+
provided and its value is not one of {"NULL"}, {"PROPAGATE"}, or {"HALT"},
21+
then a _request error_ must be raised.
2422
- {extensions} (optional): A map reserved for implementation-specific additional
2523
information.
2624

@@ -617,10 +615,8 @@ raises an _execution error_, the error must be added to the {"errors"} list in
617615
the _execution result_ and then handled according to the _error behavior_ of the
618616
request:
619617

620-
<!-- https://github.com/prettier/prettier/issues/17286 -->
621-
<!-- prettier-ignore -->
622-
- {"NO\_PROPAGATE"}: The _response position_ must be set to {null}. (The client
623-
is responsible for interpreting this {null} in conjunction with the {"errors"}
618+
- {"NULL"}: The _response position_ must be set to {null}. (The client is
619+
responsible for interpreting this {null} in conjunction with the {"errors"}
624620
list to distinguish error results from intentional {null} values.)
625621
- {"PROPAGATE"}: The _execution error_ must propagate to the parent _response
626622
position_ (the entire selection set in the case of a field, or the entire list
@@ -941,16 +937,13 @@ added to the errors list per _response position_.
941937
:: The _error behavior_ of a request indicates how an _execution error_ is
942938
handled. It may be specified using the optional {onError} attribute of the
943939
_request_. If omitted, the _default error behavior_ of the service applies.
944-
Valid values for _error behavior_ are {"PROPAGATE"}, {"NO_PROPAGATE"} and
945-
{"HALT"}.
940+
Valid values for _error behavior_ are {"NULL"}, {"PROPAGATE"} and {"HALT"}.
946941

947-
<!-- https://github.com/prettier/prettier/issues/17286 -->
948-
<!-- prettier-ignore -->
949942
:: The _default error behavior_ of a service is implementation-defined. For
950943
compatibility with existing clients, services should default to {"PROPAGATE"}
951-
which reflects prior behavior. <!-- For new services, {"NO_PROPAGATE"} is
952-
recommended. --> The default error behavior is indicated via the
953-
{"org.graphql.defaultErrorBehavior"} _capability_.
944+
which reflects prior behavior. <!-- For new services, {"NULL"} is
945+
recommended. --> The default error behavior is indicated via the {"org.graphql.defaultErrorBehavior"}
946+
_capability_.
954947

955948
Note: {"HALT"} is not recommended as the _default error behavior_ because it
956949
prevents generating partial responses which may still contain useful data.
@@ -963,12 +956,10 @@ The _error behavior_ of a request applies to every _execution error_ raised
963956
during execution. The following sections describe the behavior of each valid
964957
value:
965958

966-
**{"NO_PROPAGATE"}**
959+
**{"NULL"}**
967960

968-
<!-- https://github.com/prettier/prettier/issues/17286 -->
969-
<!-- prettier-ignore -->
970-
With {"NO\_PROPAGATE"}, a `Non-Null` _response position_ will have the value
971-
{null} if and only if an error occurred at that position.
961+
With {"NULL"}, a `Non-Null` _response position_ will have the value {null} if
962+
and only if an error occurred at that position.
972963

973964
Note: Clients must inspect the {"errors"} list and use the {"path"} of each
974965
error result to distinguish between intentional {null} values and those

0 commit comments

Comments
 (0)