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

require-selections

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

💡 This rule provides suggestions

  • Category: Operations
  • Rule name: @graphql-eslint/require-selections
  • Requires GraphQL Schema: true ℹ️
  • Requires GraphQL Operations: true ℹ️
Enforce selecting specific fields when they are available on the GraphQL type.

Usage Examples

Incorrect

# eslint @graphql-eslint/require-selections: 'error'
 
# In your schema
type User {
  id: ID!
  name: String!
}
 
# Query
query {
  user {
    name
  }
}

Correct

# eslint @graphql-eslint/require-selections: 'error'
 
# In your schema
type User {
  id: ID!
  name: String!
}
 
# Query
query {
  user {
    id
    name
  }
}
 
# Selecting `id` with an alias is also valid
query {
  user {
    id: name
  }
}

Config Schema

The schema defines the following properties:

fieldName

The object must be one of the following types:

  • asString
  • asArray

Default: "id"


Sub Schemas

The schema defines the following additional types:

asString (string)

asArray (array)

Resources

Last updated on