no-duplicate-imports

Disallow duplicate module imports

Using a single import statement per module will make the code clearer because you can see everything being imported from that module on one line.

In the following example the module import on line 1 is repeated on line 3. These can be combined to make the list of imports more succinct.

import { merge } from 'module';
import something from 'another-module';
import { find } from 'module';
1
2
3

Rule Details

This rule requires that all imports from a single module that can be merged exist in a single import statement.

Example of incorrect code for this rule:

/*eslint no-duplicate-imports: "error"*/

import { merge } from 'module';
import something from 'another-module';
import { find } from 'module';
1
2
3
4
5

Example of correct code for this rule:

/*eslint no-duplicate-imports: "error"*/

import { merge, find } from 'module';
import something from 'another-module';
1
2
3
4

Example of correct code for this rule:

/*eslint no-duplicate-imports: "error"*/

// not mergeable
import { merge } from 'module';
import * as something from 'module';
1
2
3
4
5

Options

This rule takes one optional argument, an object with a single key, includeExports which is a boolean. It defaults to false.

If re-exporting from an imported module, you should add the imports to the import-statement, and export that directly, not use export ... from.

Example of incorrect code for this rule with the { "includeExports": true } option:

/*eslint no-duplicate-imports: ["error", { "includeExports": true }]*/

import { merge } from 'module';

export { find } from 'module';
1
2
3
4
5

Example of correct code for this rule with the { "includeExports": true } option:

/*eslint no-duplicate-imports: ["error", { "includeExports": true }]*/

import { merge, find } from 'module';

export { find };
1
2
3
4
5

Example of correct code for this rule with the { "includeExports": true } option:

/*eslint no-duplicate-imports: ["error", { "includeExports": true }]*/

import { merge, find } from 'module';

// cannot be merged with the above import
export * as something from 'module';

// cannot be written differently
export * from 'module';
1
2
3
4
5
6
7
8
9

Version

This rule was introduced in ESLint v2.5.0.

Resources

• Rule source
• Tests source