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