Skip to Content
This is documentation for v4 of the plugin. For v3 click here.
ESLGraphQL-ESLint
Rulesrequire-deprecation-reason

require-deprecation-reason

✅ The "extends": "plugin:@graphql-eslint/schema-recommended" property in a configuration file enables this rule.

  • Category: Schema
  • Rule name: @graphql-eslint/require-deprecation-reason
  • Requires GraphQL Schema: false ℹ️
  • Requires GraphQL Operations: false ℹ️
Require all deprecation directives to specify a reason.

Usage Examples

Incorrect

# eslint @graphql-eslint/require-deprecation-reason: 'error' type MyType { name: String @deprecated }

Incorrect

# eslint @graphql-eslint/require-deprecation-reason: 'error' type MyType { name: String @deprecated(reason: "") }

Correct

# eslint @graphql-eslint/require-deprecation-reason: 'error' type MyType { name: String @deprecated(reason: "no longer relevant, please use fullName field") }

Resources

Last updated on