unique-directives-per-location

Since 0.9.0

This rule checks that non-repeatable directives are used once per location, as the GraphQL specification requires.

Rule Details

The rule reports the issues of the validation rule of the same name, with the messages of graphql-js. A document that breaks it is rejected by GraphQL servers and tools, so the rule should stay enabled with the error severity.

Configuration

This rule has no options.

version: "1.0"
commands:
  lint:
    graphql:
      rules:
        unique-directives-per-location: warning

The rule can be disabled for a node and everything nested in it with an # apigenie-lint-disable unique-directives-per-location comment on the node, or for a whole file with the comment at the top of the file, separated from the first definition by a blank line. It applies to definitions.

Examples

Good.

type Query { a: Int @deprecated }

Bad. The linter reports The directive "@deprecated" can only be used once at this location..

type Query { a: Int @deprecated @deprecated }

Compatibility

The rule applies to schemas and to operations. The built-in directives and those defined in the document are known; other directives are not checked.

Further reading

• GraphQL specification