alphabetize

🔧 The --fix option on the command line (opens in a new tab) can automatically fix some of the problems reported by this rule.

• Category: Schema & Operations
• Rule name: @graphql-eslint/alphabetize
• Requires GraphQL Schema: false ℹ️
• Requires GraphQL Operations: false ℹ️

Enforce arrange in alphabetical order for type fields, enum values, input object fields, operation selections and more.

Usage Examples

Incorrect

# eslint @graphql-eslint/alphabetize: ['error', { fields: ['ObjectTypeDefinition'] }]
 
type User {
  password: String
  firstName: String! # should be before "password"
  age: Int # should be before "firstName"
  lastName: String!
}

Correct

# eslint @graphql-eslint/alphabetize: ['error', { fields: ['ObjectTypeDefinition'] }]
 
type User {
  age: Int
  firstName: String!
  lastName: String!
  password: String
}

Incorrect

# eslint @graphql-eslint/alphabetize: ['error', { values: ['EnumTypeDefinition'] }]
 
enum Role {
  SUPER_ADMIN
  ADMIN # should be before "SUPER_ADMIN"
  USER
  GOD # should be before "USER"
}

Correct

# eslint @graphql-eslint/alphabetize: ['error', { values: ['EnumTypeDefinition'] }]
 
enum Role {
  ADMIN
  GOD
  SUPER_ADMIN
  USER
}

Incorrect

# eslint @graphql-eslint/alphabetize: ['error', { selections: ['OperationDefinition'] }]
 
query {
  me {
    firstName
    lastName
    email # should be before "lastName"
  }
}

Correct

# eslint @graphql-eslint/alphabetize: ['error', { selections: ['OperationDefinition'] }]
 
query {
  me {
    email
    firstName
    lastName
  }
}

Config Schema

The schema defines the following properties:

fields (array)

Fields of type, interface, and input.

The elements of the array can contain the following enum values:

• ObjectTypeDefinition
• InterfaceTypeDefinition
• InputObjectTypeDefinition

Additional restrictions:

• Minimum items: 1
• Unique items: true

values (array)

Values of enum.

The elements of the array can contain the following enum values:

• EnumTypeDefinition

Additional restrictions:

• Minimum items: 1
• Unique items: true

selections (array)

Selections of fragment and operations query, mutation and subscription.

The elements of the array can contain the following enum values:

• OperationDefinition
• FragmentDefinition

Additional restrictions:

• Minimum items: 1
• Unique items: true

variables (array)

Variables of operations query, mutation and subscription.

The elements of the array can contain the following enum values:

• OperationDefinition

Additional restrictions:

• Minimum items: 1
• Unique items: true

arguments (array)

Arguments of fields and directives.

The elements of the array can contain the following enum values:

• FieldDefinition
• Field
• DirectiveDefinition
• Directive

Additional restrictions:

• Minimum items: 1
• Unique items: true

definitions (boolean)

Definitions – type, interface, enum, scalar, input, union and directive.

Default: false

groups (array)

Custom order group. Example: ['id', '*', 'createdAt', 'updatedAt'] where * says for everything else.

The object is an array with all elements of the type string.

Additional restrictions:

• Minimum items: 2
• Unique items: true

Resources

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