Directive proposal for opting out of null bubbling

At a glance

• Identifier: #1050
• Stage: RFC0: Strawman
• Champion: @benjie
• PR: Directive proposal for opting out of null bubbling
• Related:
  • #1048 (Null-Only-On-Error / Semantically-Non-Null type (asterisk))
  • #1065 (SemanticNonNull type (null only on error))
  • DisableErrorPropagationDirective (Disable Error Propagation Directive)

Timeline

• 4 commits pushed on 2025-03-10:
  • Rename directive to preferred name by @benjie
  • Add execution logic referencing the directive by @benjie
  • Rename Null-Only-On-Error to Semantic-Non-Null by @benjie
  • Missed a bit by @benjie
• Spec PR created on 2023-10-05 by benjie
• Commit pushed: Directive proposal for opting out of null bubbling on 2023-10-05 by @benjie
• 3 commits pushed on 2023-10-04:
  • Add specification changes for Null-Only-On-Error type by @benjie
  • Add examples combining null-only-on-error with list and non-null by @benjie
  • Remove duplicate coercion for brevity by @benjie

---

This PR builds on #1065.

This introduces a directive on operations that disables the null/error propagation behavior by treating all Non-Null types as if they were Semantic-Non-Null types (see #1065).

The specific name of this directive (currently @disableNullPropagation) is open to workshopping:

• @noBubblesPlz 😉 or @tepid 🤣
• @disableNullPropagation / @disableErrorPropagation / @noNullPropagation / @noPropagation / @nullOnError / etc
• @localErrors
• @dontHandleErrorsForMeIKnowWhatImDoing
• {your suggestion here}

Implemented in https://github.com/graphql/graphql-js/pull/4192 as part of semantic non-null support.