版本

no-restricted-imports

禁止通过 import 加载指定的模块

导入是 ES6/ES2015 标准，用于在当前模块中提供其他模块的功能。在 CommonJS 中，这是通过 require() 调用实现的，这使得此 ESLint 规则大致等同于其 CommonJS 对应规则 no-restricted-modules。

为什么要限制导入？

  • 某些导入在特定环境中可能没有意义。例如，Node.js 的 fs 模块在没有文件系统的环境中就没有意义。

  • 一些模块提供相似或相同的功能，例如 lodash 和 underscore。您的项目可能已经标准化了一个模块。您希望确保没有使用其他替代方案，因为这会不必要地增加项目的臃肿，并在一个就足够的情况下提供两个依赖项的更高维护成本。

规则详情

此规则允许您指定不想在应用程序中使用的导入。

它仅适用于静态导入，不适用于动态导入。

选项

此规则具有字符串和对象选项来指定要限制的导入模块。

使用字符串选项，您可以将要限制导入的模块名称指定为规则选项数组中的值

"no-restricted-imports": ["error", "import1", "import2"]

字符串选项的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", "fs"]*/

import fs from 'fs';

字符串选项也限制模块被导出，如本例所示

在游乐场中打开
/*eslint no-restricted-imports: ["error", "fs"]*/

export { fs } from 'fs';
在游乐场中打开
/*eslint no-restricted-imports: ["error", "fs"]*/

export * from 'fs';

字符串选项的**正确**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", "fs"]*/

import crypto from 'crypto';
export { foo } from "bar";

您还可以使用对象中的 name 和 message 属性为特定模块指定自定义消息，其中 name 的值为模块名称，message 属性包含自定义消息。（自定义消息附加到规则的默认错误消息。）

"no-restricted-imports": ["error", {
    "name": "import-foo",
    "message": "Please use import-bar instead."
}, {
    "name": "import-baz",
    "message": "Please use import-quux instead."
}]

字符串选项的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", {
    "name": "disallowed-import",
    "message": "Please use 'allowed-import' instead"
}]*/

import foo from 'disallowed-import';

paths

这是一个对象选项，其值为包含要限制的模块名称的数组。

"no-restricted-imports": ["error", { "paths": ["import1", "import2"] }]

paths 的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { "paths": ["cluster"] }]*/

import cluster from 'cluster';

特定模块的自定义消息也可以在 paths 数组中使用带有 name 和 message 的对象来指定。

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

importNames

paths 中的此选项是一个数组，可用于指定从模块导出的某些绑定的名称。paths 数组中指定的导入名称会影响相应对象 name 属性中指定的模块，因此在使用 importNames 或 message 选项时，需要先指定 name 属性。

在 importNames 数组中指定 "default" 字符串将限制导入默认导出。

"no-restricted-imports": ["error", {
  "paths": [{
    "name": "import-foo",
    "importNames": ["Bar"],
    "message": "Please use Bar from /import-bar/baz/ instead."
  }]
}]

paths 中 importNames 包含 "default" 的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { paths: [{
    name: "foo",
    importNames: ["default"],
    message: "Please use the default import from '/bar/baz/' instead."
}]}]*/

import DisallowedObject from "foo";

paths 中 importNames 的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { paths: [{
    name: "foo",
    importNames: ["DisallowedObject"],
    message: "Please import 'DisallowedObject' from '/bar/baz/' instead."
}]}]*/

import { DisallowedObject } from "foo";

import { DisallowedObject as AllowedObject } from "foo";

import { "DisallowedObject" as SomeObject } from "foo";
在游乐场中打开
/*eslint no-restricted-imports: ["error", { paths: [{
    name: "foo",
    importNames: ["DisallowedObject"],
    message: "Please import 'DisallowedObject' from '/bar/baz/' instead."
}]}]*/

import * as Foo from "foo";

paths 中 importNames 的**正确**代码示例

如果分配给默认导出的本地名称与 importNames 中的字符串相同，则不会导致错误。

在游乐场中打开
/*eslint no-restricted-imports: ["error", { paths: [{ name: "foo", importNames: ["DisallowedObject"] }] }]*/

import DisallowedObject from "foo"
在游乐场中打开
/*eslint no-restricted-imports: ["error", { paths: [{
    name: "foo",
    importNames: ["DisallowedObject"],
    message: "Please import 'DisallowedObject' from '/bar/baz/' instead."
}]}]*/

import { AllowedObject as DisallowedObject } from "foo";

allowImportNames

此选项是一个数组。importNames 的反义词，allowImportNames 允许在此数组中指定的导入。因此，它限制了模块中的所有导入，除了指定的允许的导入。

注意：allowImportNames 不能与 importNames 结合使用。

"no-restricted-imports": ["error", {
  "paths": [{
    "name": "import-foo",
    "allowImportNames": ["Bar"],
    "message": "Please use only Bar from import-foo."
  }]
}]

paths 中 allowImportNames 的**错误**代码示例

禁止所有导入名称，除了 'AllowedObject'。

在游乐场中打开
/*eslint no-restricted-imports: ["error", { paths: [{
    name: "foo",
    allowImportNames: ["AllowedObject"],
    message: "Please use only 'AllowedObject' from 'foo'."
}]}]*/

import { DisallowedObject } from "foo";

paths 中 allowImportNames 的**正确**代码示例

禁止所有导入名称，除了 'AllowedObject'。

在游乐场中打开
/*eslint no-restricted-imports: ["error", { paths: [{
    name: "foo",
    allowImportNames: ["AllowedObject"],
    message: "Only use 'AllowedObject' from 'foo'."
}]}]*/

import { AllowedObject } from "foo";

patterns

这也是一个对象选项，其值为数组。此选项允许您使用 gitignore 风格的模式或正则表达式指定多个要限制的模块。

其中 paths 选项采用精确的导入路径，patterns 选项可用于更灵活地指定导入路径，允许限制同一目录中的多个模块。例如

"no-restricted-imports": ["error", {
  "paths": [{
    "name": "import-foo",
  }]
}]

此配置限制了 import-foo 模块的导入，但不会限制 import-foo/bar 或 import-foo/baz 的导入。您可以使用 patterns 来限制两者

"no-restricted-imports": ["error", {
    "paths": [{
      "name": "import-foo",
    }],
    "patterns": [{
      "group": ["import-foo/ba*"],
    }]
}]

此配置不仅限制了使用 path 从 import-foo 导入，还使用 patterns 限制了 import-foo/bar 和 import-foo/baz 的导入。

在使用 gitignore 风格的模式时，要重新包含模块，请在模式前添加否定（!）标记。（确保这些否定的模式放在数组的最后，因为顺序很重要）

"no-restricted-imports": ["error", {
    "patterns": ["import1/private/*", "import2/*", "!import2/good"]
}]

您还可以使用正则表达式来限制模块（请参阅regex 选项）。

patterns 选项的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { "patterns": ["lodash/*"] }]*/

import pick from 'lodash/pick';
在游乐场中打开
/*eslint no-restricted-imports: ["error", { "patterns": ["lodash/*", "!lodash/pick"] }]*/

import pick from 'lodash/map';
在游乐场中打开
/*eslint no-restricted-imports: ["error", { "patterns": ["import1/*", "!import1/private/*"] }]*/

import pick from 'import1/private/someModule';

在此示例中，"!import1/private/*" 不会重新包含 private 内部的模块，因为如果其父目录被模式排除，则否定标记（!）不会重新包含文件。在本例中，import1/private 目录已被 import1/* 模式排除。（可以使用 "!import1/private" 重新包含排除的目录。）

patterns 选项的**正确**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { "patterns": ["crypto/*"] }]*/

import crypto from 'crypto';
在游乐场中打开
/*eslint no-restricted-imports: ["error", { "patterns": ["lodash/*", "!lodash/pick"] }]*/

import pick from 'lodash/pick';
在游乐场中打开
/*eslint no-restricted-imports: ["error", { "patterns": ["import1/*", "!import1/private"] }]*/

import pick from 'import1/private/someModule';

group

patterns 数组还可以包含对象。group 属性用于指定限制模块的 gitignore 风格的模式，message 属性用于指定自定义消息。

在使用 patterns 选项时，需要 group 或 regex 属性中的一个。

"no-restricted-imports": ["error", {
    "patterns": [{
      "group": ["import1/private/*"],
      "message": "usage of import1 private modules not allowed."
    }, {
      "group": ["import2/*", "!import2/good"],
      "message": "import2 is deprecated, except the modules in import2/good."
    }]
}]

group 选项的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["lodash/*"],
    message: "Please use the default import from 'lodash' instead."
}]}]*/

import pick from 'lodash/pick';

此 group 选项的**正确**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["lodash/*"],
    message: "Please use the default import from 'lodash' instead."
}]}]*/

import lodash from 'lodash';

regex

regex 属性用于指定限制模块的正则表达式模式。

注意：regex 不能与 group 结合使用。

"no-restricted-imports": ["error", {
    "patterns": [{
      "regex": "import1/private/",
      "message": "usage of import1 private modules not allowed."
    }, {
      "regex": "import2/(?!good)",
      "message": "import2 is deprecated, except the modules in import2/good."
    }]
}]

regex 选项的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    regex: "@app/(?!(api/enums$)).*",
}]}]*/

import Foo from '@app/api';
import Bar from '@app/api/bar';
import Baz from '@app/api/baz';
import Bux from '@app/api/enums/foo';

regex 选项的**正确**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    regex: "@app/(?!(api/enums$)).*",
}]}]*/

import Foo from '@app/api/enums';

caseSensitive

这是一个布尔选项，当 true 时，将 group 或 regex 属性中指定的模式设置为区分大小写。默认为 false。

"no-restricted-imports": ["error", {
    "patterns": [{
      "group": ["import1/private/prefix[A-Z]*"],
      "caseSensitive": true
    }]
}]

caseSensitive: true 选项的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["foo[A-Z]*"],
    caseSensitive: true
}]}]*/

import pick from 'fooBar';

caseSensitive: true 选项的**正确**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["foo[A-Z]*"],
    caseSensitive: true
}]}]*/

import pick from 'food';

importNames

您也可以在 patterns 数组内的对象中指定 importNames。在这种情况下，指定的名称仅适用于关联的 group 或 regex 属性。

"no-restricted-imports": ["error", {
    "patterns": [{
      "group": ["utils/*"],
      "importNames": ["isEmpty"],
      "message": "Use 'isEmpty' from lodash instead."
    }]
}]

patterns 中 importNames 的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["utils/*"],
    importNames: ['isEmpty'],
    message: "Use 'isEmpty' from lodash instead."
}]}]*/

import { isEmpty } from 'utils/collection-utils';

patterns 中 importNames 的**正确**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["utils/*"],
    importNames: ['isEmpty'],
    message: "Use 'isEmpty' from lodash instead."
}]}]*/

import { hasValues } from 'utils/collection-utils';

allowImportNames

您也可以在 patterns 数组内的对象中指定 allowImportNames。在这种情况下，指定的名称仅适用于关联的 group 或 regex 属性。

注意：allowImportNames 不能与 importNames、importNamePattern 或 allowImportNamePattern 结合使用。

"no-restricted-imports": ["error", {
    "patterns": [{
      "group": ["utils/*"],
      "allowImportNames": ["isEmpty"],
      "message": "Please use only 'isEmpty' from utils."
    }]
}]

patterns 中 allowImportNames 的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["utils/*"],
    allowImportNames: ['isEmpty'],
    message: "Please use only 'isEmpty' from utils."
}]}]*/

import { hasValues } from 'utils/collection-utils';

patterns 中 allowImportNames 的**正确**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["utils/*"],
    allowImportNames: ['isEmpty'],
    message: "Please use only 'isEmpty' from utils."
}]}]*/

import { isEmpty } from 'utils/collection-utils';

importNamePattern

此选项允许您使用正则表达式模式来限制导入名称

"no-restricted-imports": ["error", {
    "patterns": [{
      "group": ["import-foo/*"],
      "importNamePattern": "^foo",
    }]
}]

importNamePattern 选项的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["utils/*"],
    importNamePattern: '^is',
    message: "Use 'is*' functions from lodash instead."
}]}]*/

import { isEmpty } from 'utils/collection-utils';
在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["foo/*"],
    importNamePattern: '^(is|has)',
    message: "Use 'is*' and 'has*' functions from baz/bar instead"
}]}]*/

import { isSomething, hasSomething } from 'foo/bar';
在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["foo/*"],
    importNames: ["bar"],
    importNamePattern: '^baz',
}]}]*/

import { bar, bazQux } from 'foo/quux';

importNamePattern 选项的**正确**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["utils/*"],
    importNamePattern: '^is',
    message: "Use 'is*' functions from lodash instead."
}]}]*/

import isEmpty, { hasValue } from 'utils/collection-utils';

您还可以通过将其设置为匹配任何名称的模式（例如 ^）来使用此选项仅允许副作用导入。

importNamePattern 选项的**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["utils/*"],
    importNamePattern: "^"
}]}]*/

import isEmpty, { hasValue } from 'utils/collection-utils';

import * as file from 'utils/file-utils';

importNamePattern 选项的**正确**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["utils/*"],
    importNamePattern: "^"
}]}]*/

import 'utils/init-utils';

allowImportNamePattern

这是一个字符串选项。importNamePattern 的反义词，此选项允许匹配指定正则表达式模式的导入。因此，它限制了模块中的所有导入，除了指定的允许的模式。

注意：allowImportNamePattern 不能与 importNames、importNamePattern 或 allowImportNames 结合使用。

"no-restricted-imports": ["error", {
    "patterns": [{
      "group": ["import-foo/*"],
      "allowImportNamePattern": "^foo",
    }]
}]

allowImportNamePattern 选项**错误**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["utils/*"],
    allowImportNamePattern: '^has'
}]}]*/

import { isEmpty } from 'utils/collection-utils';

allowImportNamePattern 选项**正确**代码示例

在游乐场中打开
/*eslint no-restricted-imports: ["error", { patterns: [{
    group: ["utils/*"],
    allowImportNamePattern: '^is'
}]}]*/

import { isEmpty } from 'utils/collection-utils';

何时不使用它

如果您希望能够在项目中导入模块而不会出现 ESLint 错误或警告，请不要使用此规则或不要将模块包含在此规则的列表中。

版本

此规则在 ESLint v2.0.0-alpha-1 中引入。

资源

编辑此页面
© OpenJS 基金会和 ESLint 贡献者，www.openjsf.org。内容许可证为 MIT 许可证。
更改语言