Skip to content

Commit 35a8e38

Browse files
committed
Rename directive to preferred name
1 parent e58ab2b commit 35a8e38

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

spec/Section 3 -- Type System.md

+13-13
Original file line numberDiff line numberDiff line change
@@ -2019,7 +2019,7 @@ by a validator, executor, or client tool such as a code generator.
20192019
:: A _built-in directive_ is any directive defined within this specification.
20202020

20212021
GraphQL implementations should provide the `@skip`, `@include` and
2022-
`@nullOnError` directives.
2022+
`@disableErrorPropagation` directives.
20232023

20242024
GraphQL implementations that support the type system definition language must
20252025
provide the `@deprecated` directive if representing deprecated portions of the
@@ -2242,22 +2242,22 @@ to the relevant IETF specification.
22422242
scalar UUID @specifiedBy(url: "https://tools.ietf.org/html/rfc4122")
22432243
```
22442244

2245-
### @nullOnError
2245+
### @disableErrorPropagation
22462246

22472247
```graphql
2248-
directive @nullOnError on QUERY | MUTATION | SUBSCRIPTION
2248+
directive @disableErrorPropagation on QUERY | MUTATION | SUBSCRIPTION
22492249
```
22502250

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.
22552255

22562256
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.
22612261

22622262
Consider the following schema:
22632263

@@ -2302,10 +2302,10 @@ Would return a result such as:
23022302
}
23032303
```
23042304

2305-
However, if we apply the `@nullOnError` directive to our operation:
2305+
However, if we apply the `@disableErrorPropagation` directive to our operation:
23062306

23072307
```graphql example
2308-
query myQuery @nullOnError {
2308+
query myQuery @disableErrorPropagation {
23092309
me {
23102310
username
23112311
bestFriend {

0 commit comments

Comments
 (0)