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

• Rule source (opens in a new tab)
• Test source (opens in a new tab)