@@ -2019,7 +2019,7 @@ by a validator, executor, or client tool such as a code generator.
2019
2019
:: A _built -in directive_ is any directive defined within this specification .
2020
2020
2021
2021
GraphQL implementations should provide the `@skip `, `@include ` and
2022
- `@nullOnError ` directives .
2022
+ `@disableErrorPropagation ` directives .
2023
2023
2024
2024
GraphQL implementations that support the type system definition language must
2025
2025
provide the `@deprecated ` directive if representing deprecated portions of the
@@ -2242,22 +2242,22 @@ to the relevant IETF specification.
2242
2242
scalar UUID @specifiedBy (url : " https://tools.ietf.org/html/rfc4122" )
2243
2243
```
2244
2244
2245
- ### @nullOnError
2245
+ ### @disableErrorPropagation
2246
2246
2247
2247
```graphql
2248
- directive @nullOnError on QUERY | MUTATION | SUBSCRIPTION
2248
+ directive @disableErrorPropagation on QUERY | MUTATION | SUBSCRIPTION
2249
2249
```
2250
2250
2251
- The `@nullOnError ` _built -in directive_ may be provided on query , mutation and
2252
- subscription operations , and disables the error propagation behavior described
2253
- in [Handling Field Errors ](#sec-Handling-Field-Errors) by treating all Non-Null
2254
- types as if they were instead Null-Only-On-Error types.
2251
+ The `@disableErrorPropagation ` _built -in directive_ may be provided on query ,
2252
+ mutation and subscription operations , and disables the error propagation
2253
+ behavior described in [Handling Field Errors ](#sec-Handling-Field-Errors) by
2254
+ treating all Non-Null types as if they were instead Null-Only-On-Error types.
2255
2255
2256
2256
Note : This is useful for clients that still wish to receive sibling fields when
2257
- an error on a Non -Null value occurs . Effectively , `@nullOnError` enables the
2258
- client to opt in to handling errors locally; for example, a client might use
2259
- this to limit the scope of null propagation to a fragment rather than the entire
2260
- field, or to update a normalized store even when an error occurs.
2257
+ an error on a Non -Null value occurs . Effectively , `@disableErrorPropagation`
2258
+ enables the client to opt in to handling errors locally; for example, a client
2259
+ might use this to limit the scope of null propagation to a fragment rather than
2260
+ the entire field, or to update a normalized store even when an error occurs.
2261
2261
2262
2262
Consider the following schema :
2263
2263
@@ -2302,10 +2302,10 @@ Would return a result such as:
2302
2302
}
2303
2303
```
2304
2304
2305
- However , if we apply the `@nullOnError ` directive to our operation :
2305
+ However , if we apply the `@disableErrorPropagation ` directive to our operation :
2306
2306
2307
2307
```graphql example
2308
- query myQuery @nullOnError {
2308
+ query myQuery @disableErrorPropagation {
2309
2309
me {
2310
2310
username
2311
2311
bestFriend {
0 commit comments