sort-imports.md

Import Sorting (sort-imports)

The import statement is used to import members (functions, objects or primitives) that have been exported from an external module. Using a specific member syntax:

The --fix option on the command line can automatically fix some of the problems reported by this rule.

// default - Import default member.
import myMember from 'my-module.js'

// named - Import named member(s).
import { foo, bar } from 'my-module.js'
import { baz } from 'my-module.js'

// all - Import all members, where myModule contains all the exported bindings.
import * as myModule from 'my-module.js'

// type - Import Flow types.
import type { Foo, Bar } from 'my-module.js'

The import statement can also import a module without exported bindings. Used when the module does not export anything, but runs it own code or changes the global context object.

// none - Import module without exported bindings.
import 'my-module.js'

When declaring multiple imports, a sorted list of import declarations make it easier for developers to read the code and find necessary imports later. This rule is purely a matter of style.

Rule Details

This rule checks all import declarations and verifies that all imports are first sorted by the used member syntax and then alphabetically by the first member or alias name.

The sort order of import declarations based on the member syntax can be configured via the memberSyntaxSortOrder option. The default member syntax sort order is:

• none - import module without exported bindings.
• type - import Flow types.
• all - import all members provided by exported bindings.
• named - import named member(s).
• default - import default member.

The following example shows correct sorted import declarations:

/*eslint wyze/sort-imports: 'error'*/
import 'module-without-export.js';
import type { Foo } from 'foo.js'
import * as foo from 'foo.js';
import * as bar from 'bar.js';
import { alpha, beta } from 'alpha.js';
import { charlie } from 'charlie.js';
import { delta, gamma } from 'delta.js';
import a from 'baz.js';
import b from 'qux.js';

The following patterns are considered problems:

/*eslint wyze/sort-imports: 'error'*/
import b from 'foo.js';
import a from 'bar.js';

/*eslint wyze/sort-imports: 'error'*/
import a from 'foo.js';
import A from 'bar.js';

/*eslint wyze/sort-imports: 'error'*/
import a from 'foo.js';
import A from 'bar.js';
import type { A } from 'bar.js'

/*eslint wyze/sort-imports: 'error'*/
import {b, c} from 'foo.js';
import {a, b} from 'bar.js';

/*eslint wyze/sort-imports: 'error'*/
import a from 'foo.js';
import {b, c} from 'bar.js';

/*eslint wyze/sort-imports: 'error'*/
import a from 'foo.js';
import * as b from 'bar.js';

/*eslint wyze/sort-imports: 'error'*/
import {b, a, c} from 'foo.js'

The following patterns are not considered problems:

/*eslint wyze/sort-imports: 'error'*/
import a from 'foo.js';
import b from 'bar.js';
import c from 'baz.js';

/* eslint wyze/sort-imports: 'error' */
import type { C } from 'foo.js'
import A from 'bar.js'

/*eslint wyze/sort-imports: 'error'*/
import 'foo.js'
import * from 'bar.js';
import { a, b } from 'baz.js';
import { d } from 'baz-extra.js';
import c from 'qux.js';
import e, { f } from 'qux-extra.js';

/*eslint wyze/sort-imports: 'error'*/
import { a, b, c } from 'foo.js'

Options

This rule accepts an object with its properties as

• ignoreCase (default: false)
• ignoreMemberSort (default: false)
• memberSyntaxSortOrder (default: ['none', 'type', 'all', 'named', 'default'])

Default option settings are

{
    'wyze/sort-imports': ['error', {
        'ignoreCase': false,
        'ignoreMemberSort': false,
        'memberSyntaxSortOrder': ['none', 'type', 'all', 'multiple', 'single']
    }]
}

ignoreCase

When true the rule ignores the case-sensitivity of the imports local name.

The following patterns are considered problems:

/*eslint wyze/sort-imports: ['error', { 'ignoreCase': true }]*/

import B from 'foo.js';
import a from 'bar.js';

The following patterns are not considered problems:

/*eslint wyze/sort-imports: ['error', { 'ignoreCase': true }]*/

import a from 'foo.js';
import B from 'bar.js';
import c from 'baz.js';

Default is false.

ignoreMemberSort

Ignores the member sorting within a multiple member import declaration.

The following patterns are considered problems:

/*eslint wyze/sort-imports: 'error'*/
import { b, a, c } from 'foo.js'

The following patterns are not considered problems:

/*eslint wyze/sort-imports: ['error', { 'ignoreMemberSort': true }]*/
import { b, a, c } from 'foo.js'

Default is false.

memberSyntaxSortOrder

The member syntax sort order can be configured with this option. There are five different styles and the default member syntax sort order is:

• none - import module without exported bindings.
• type - import Flow types.
• all - import all members provided by exported bindings.
• named - import named member(s).
• default - import default member.

Use this option if you want a different sort order. Every style must be defined in the sort order (There shall be five items in the array).

The following patterns are considered problems:

/*eslint wyze/sort-imports: 'error'*/
import a from 'foo.js';
import * as b from 'bar.js';

The following patterns are not considered problems:

/*eslint wyze/sort-imports: ['error', { 'memberSyntaxSortOrder': ['default', 'type', 'all', 'named', 'none'] }]*/

import a from 'foo.js';
import * as b from 'bar.js';

/*eslint wyze/sort-imports: ['error', { 'memberSyntaxSortOrder': ['all', 'type', 'default', 'named', 'none'] }]*/

import * as foo from 'foo.js';
import z from 'zoo.js';
import { a, b } from 'foo.js';

/* eslint wyze/sort-imports: ['error', { 'memberSyntaxSortOrder': ['all', 'default', 'type', 'named', 'none'] }] */
import z from 'zoo.js'
import type { Z } from 'zoo.js'

Default is ['none', 'type', 'all', 'named', 'default'].

When Not To Use It

This rule is a formatting preference and not following it won't negatively affect the quality of your code. If you alphabetizing imports isn't a part of your coding standards, then you can leave this rule disabled.