useUniqueGraphqlOperationName

GraphQL

Summary

Rule available since: v2.3.6
Diagnostic Category: lint/nursery/useUniqueGraphqlOperationName
This rule doesn’t have a fix.
The default severity of this rule is information.
Sources:
- Inspired from @graphql-eslint/unique-operation-name

How to configure

1
{
2
  "linter": {
3
    "rules": {
4
      "nursery": {
5
        "useUniqueGraphqlOperationName": "error"
6
      }
7
    }
8
  }
9
}

Description

Enforce unique operation names across a GraphQL document.

This rule ensures that all GraphQL operations (queries, mutations, subscriptions) have unique names. Using unique operation names is essential for proper identification and reducing confusion.

Examples

Invalid

1
query user {
2
  user {
3
    id
4
  }
5
}
6

7
query user {
8
  me {
9
    id
10
  }
11
}

code-block.graphql:7:1 lint/nursery/useUniqueGraphqlOperationName ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Operation named “user” is already defined.
  
     5 │ }
     6 │ 
   > 7 │ query user {
       │ ^^^^^^^^^^^^
   > 8 │   me {
   > 9 │     id
  > 10 │   }
  > 11 │ }
       │ ^
    12 │ 
  
  ℹ GraphQL operation names must be unique to ensure proper identification.
  
  ℹ Rename the operation to have a unique name.
  
  ℹ This rule belongs to the nursery group, which means it is not yet stable and may change in the future. Visit https://biomejs.dev/linter/#nursery for more information.

Valid

1
query user {
2
  user {
3
    id
4
  }
5
}
6

7
query me {
8
  me {
9
    id
10
  }
11
}