no-restricted-modules

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

Node.js 中的模块是组织在 JavaScript 文件中的简单或复杂功能，可以在整个 Node.js 应用程序中重用。在 Node.js/CommonJS 中使用关键字 require 将模块导入应用程序。这样，您可以在加载的模块名称未预定义/静态的情况下进行动态加载，或者仅在模块为 "truly required" 时有条件地加载模块。

为什么要限制模块？

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

规则详情

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

选项

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

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

它也可以接受一个带有 paths 和 gitignore 风格的 patterns 字符串列表的对象。

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

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

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

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

或像这样：

"no-restricted-modules": ["error",{
"paths":[{
  "name": "foo-module",
  "message": "Please use bar-module instead."
  }]
}]

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

限制使用所有 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"
    ]
}

示例

带有示例 "fs", "cluster", "lodash" 受限模块的此规则的错误代码示例：

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

var fs = require('fs');
var cluster = require('cluster');

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

var cluster = require('cluster');

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

var pick = require('lodash/pick');

带有示例 "fs", "cluster", "lodash" 受限模块的此规则的正确代码示例：

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

var crypto = require('crypto');

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

var crypto = require('crypto');
var pick = require('lodash/pick');