@@ -4,8 +4,6 @@ A GraphQL service generates a response from a request via execution.
4
4
5
5
:: A _ request_ for execution consists of a few pieces of information:
6
6
7
- <!-- https://github.com/prettier/prettier/issues/17286 -->
8
- <!-- prettier-ignore -->
9
7
- {schema}: The schema to use, typically solely provided by the GraphQL service.
10
8
- {document}: A {Document} which must contain GraphQL {OperationDefinition} and
11
9
may contain {FragmentDefinition}.
@@ -19,8 +17,8 @@ A GraphQL service generates a response from a request via execution.
19
17
always use the same initial value for every request.
20
18
- {onError} (optional): The _ error behavior_ to apply to the request; see
21
19
[ 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.
24
22
- {extensions} (optional): A map reserved for implementation-specific additional
25
23
information.
26
24
@@ -617,10 +615,8 @@ raises an _execution error_, the error must be added to the {"errors"} list in
617
615
the _ execution result_ and then handled according to the _ error behavior_ of the
618
616
request:
619
617
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"}
624
620
list to distinguish error results from intentional {null} values.)
625
621
- {"PROPAGATE"}: The _ execution error_ must propagate to the parent _ response
626
622
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_.
941
937
:: The _ error behavior_ of a request indicates how an _ execution error_ is
942
938
handled. It may be specified using the optional {onError} attribute of the
943
939
_ 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"}.
946
941
947
- <!-- https://github.com/prettier/prettier/issues/17286 -->
948
- <!-- prettier-ignore -->
949
942
:: The _ default error behavior_ of a service is implementation-defined. For
950
943
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_ .
954
947
955
948
Note: {"HALT"} is not recommended as the _ default error behavior_ because it
956
949
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
963
956
during execution. The following sections describe the behavior of each valid
964
957
value:
965
958
966
- ** {"NO_PROPAGATE "}**
959
+ ** {"NULL "}**
967
960
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.
972
963
973
964
Note: Clients must inspect the {"errors"} list and use the {"path"} of each
974
965
error result to distinguish between intentional {null} values and those
0 commit comments