GraphQL Rules

Below the list of rules supported by Biome, divided by group. Here’s a legend of the emojis:

• The icon indicates that the rule is part of the recommended rules.
• The icon indicates that the rule provides a code action (fix) that is safe to apply.
• The icon indicates that the rule provides a code action (fix) that is unsafe to apply.
• The icon indicates that the rule has been implemented and scheduled for the next release.

correctness

Rule name	Description	Properties
noDuplicateArgumentNames	Require all argument names for fields & directives to be unique.
noDuplicateEnumValueNames	Require all enum value names to be unique.
noDuplicateInputFieldNames	Require fields within an input object to be unique.
noDuplicateVariableNames	Require all variable definitions to be unique.
useGraphqlNamedOperations	Enforce specifying the name of GraphQL operations.
useLoneAnonymousOperation	Disallow anonymous operations when more than one operation specified in document.

nursery

Rule name	Description	Properties
noDuplicateFieldDefinitionNames	Require all fields of a type to be unique.

style

Rule name	Description	Properties
noExcessiveLinesPerFile	Restrict the number of lines in a file.
noRootType	Disallow the usage of specified root types
useConsistentGraphqlDescriptions	Require all descriptions to follow the same style (either block or inline) to maintain consistency and improve readability across the schema.
useDeprecatedReason	Require specifying the reason argument when using @deprecated directive
useGraphqlNamingConvention	Validates that all enum values are capitalized.
useInputName	Require mutation argument to be always called “input”
useLoneExecutableDefinition	Require queries, mutations, subscriptions or fragments each to be located in separate files.

suspicious

Rule name	Description	Properties
noDuplicateFields	No duplicated fields in GraphQL operations.
noDuplicateGraphqlOperationName	Enforce unique operation names across a GraphQL document.
noEmptySource	Disallow empty sources.
useDeprecatedDate	Require the @deprecated directive to specify a deletion date.

Recommended rules

• noDuplicateArgumentNames (Severity: error)
• noDuplicateEnumValueNames (Severity: error)
• noDuplicateInputFieldNames (Severity: error)
• noDuplicateVariableNames (Severity: error)
• useGraphqlNamedOperations (Severity: error)
• useLoneAnonymousOperation (Severity: error)
• useDeprecatedReason (Severity: warning)
• noDuplicateFields (Severity: information)

Missing a rule? Help us by contributing to the analyzer or create a rule suggestion here.