Directive proposal for opting out of null bubbling

At a glance

• Identifier: #1050
• Stage: RFC 0 / Strawman
• Champion: @benjie
• Latest activity: 4 commits pushed on 2025-03-10
• Spec PR: https://github.com/graphql/graphql-spec/pull/1050
• Related:
  • #1065

Spec PR description

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 :wink: or @tepid :rofl:
• @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.

Timeline

• 4 commits pushed on 2025-03-10:
  • benjie committed "Rename directive to preferred name"
  • benjie committed "Add execution logic referencing the directive"
  • benjie committed "Rename Null-Only-On-Error to Semantic-Non-Null"
  • benjie committed "Missed a bit"
• Spec PR created on 2023-10-05 by benjie
• Commit pushed on 2023-10-05 by benjie: Directive proposal for opting out of null bubbling