no-restricted-modules

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

此规则已在 ESLint v7.0.0 中**弃用**。请在 eslint-plugin-n 中使用相应的规则。

在 Node.js 中，模块是一个组织在 JavaScript 文件中的简单或复杂的功能，可以在整个 Node.js 应用程序中重用。关键字 require 用于在 Node.js/CommonJS 中将模块导入应用程序。这样，您可以进行动态加载，其中加载的模块名称不是预定义的/静态的，或者您仅在“真正需要”时有条件地加载模块。

为什么要限制模块？

如果您想限制开发人员可以使用的方法，则禁止使用特定的 Node.js 模块可能很有用。例如，如果您想禁止文件系统访问，则可以阻止使用 fs 模块。

规则详情

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

选项

该规则将一个或多个字符串作为选项：受限模块的名称。

"no-restricted-modules": ["error", "foo-module", "bar-module"]
1

它还可以采用包含 paths 列表和 gitignore 风格的 patterns 字符串的对象。

"no-restricted-modules": ["error", { "paths": ["foo-module", "bar-module"] }]
1

"no-restricted-modules": ["error", {
    "paths": ["foo-module", "bar-module"],
    "patterns": ["foo-module/private/*", "bar-module/*","!baz-module/good"]
}]
1
2
3
4

您还可以为要限制的任何路径指定自定义消息，如下所示

"no-restricted-modules": ["error", {
  "name": "foo-module",
  "message": "Please use bar-module instead."
  }
]
1
2
3
4
5

或像这样

"no-restricted-modules": ["error",{
"paths":[{
  "name": "foo-module",
  "message": "Please use bar-module instead."
  }]
}]
1
2
3
4
5
6

自定义消息将附加到默认错误消息。请注意，您不能为受限模式指定自定义错误消息，因为特定模块可能匹配多个模式。

要限制所有 Node.js 核心模块的使用（通过 https://github.com/nodejs/node/tree/master/lib）

{
    "no-restricted-modules": ["error",
        "assert","buffer","child_process","cluster","crypto","dgram","dns","domain","events","freelist","fs","http","https","module","net","os","path","punycode","querystring","readline","repl","smalloc","stream","string_decoder","sys","timers","tls","tracing","tty","url","util","vm","zlib"
    ]
}
1
2
3
4
5

示例

此规则的错误代码示例，其中示例 "fs", "cluster", "lodash" 模块受到限制

在游乐场中打开

/*eslint no-restricted-modules: ["error", "fs", "cluster"]*/

var fs = require('fs');
var cluster = require('cluster');
1
2
3
4

在游乐场中打开

/*eslint no-restricted-modules: ["error", {"paths": ["cluster"] }]*/

var cluster = require('cluster');
1
2
3

在游乐场中打开

/*eslint no-restricted-modules: ["error", { "patterns": ["lodash/*"] }]*/

var pick = require('lodash/pick');
1
2
3

此规则的正确代码示例，其中示例 "fs", "cluster", "lodash" 模块受到限制

在游乐场中打开

/*eslint no-restricted-modules: ["error", "fs", "cluster"]*/

var crypto = require('crypto');
1
2
3

在游乐场中打开

/*eslint no-restricted-modules: ["error", {
    "paths": ["fs", "cluster"],
    "patterns": ["lodash/*", "!lodash/pick"]
}]*/

var crypto = require('crypto');
var pick = require('lodash/pick');
1
2
3
4
5
6
7

版本

此规则是在 ESLint v0.6.0 中引入的。

资源

编辑此页面