no-restricted-imports

Disallow specified modules when loaded by import.

Attributes

• Included in configs
  • ✅ Recommended
  • 🔒 Strict
• Fixable
  • 🔧 Automated Fixer
  • 💡 Suggestion Fixer
• 💭 Requires type information

Rule Details

This rule extends the base eslint/no-restricted-imports rule.

How to Use

.eslintrc.cjs

module.exports = {
  // Note: you must disable the base rule as it can report incorrect errors
  "no-restricted-imports": "off",
  "@typescript-eslint/no-restricted-imports": "warn"
};

Options

See eslint/no-restricted-imports options.

This rule adds the following options:

allowTypeImports

(default: false)

You can specify this option for a specific path or pattern as follows:

"@typescript-eslint/no-restricted-imports": ["error", {
  "paths": [{
    "name": "import-foo",
    "message": "Please use import-bar instead.",
    "allowTypeImports": true
  }, {
    "name": "import-baz",
    "message": "Please use import-quux instead.",
    "allowTypeImports": true
  }]
}]

When set to true, the rule will allow Type-Only Imports.

Examples of code with the above config:

❌ Incorrect

import foo from 'import-foo';
export { Foo } from 'import-foo';

import baz from 'import-baz';
export { Baz } from 'import-baz';

✅ Correct

import { foo } from 'other-module';

import type foo from 'import-foo';
export type { Foo } from 'import-foo';

import type baz from 'import-baz';
export type { Baz } from 'import-baz';

^{Taken with ❤️ from ESLint core}

Resources

• Rule source
• Test source