no-restricted-globals

禁止指定的全局变量

如果你想允许一组全局变量，但仍然想禁止其中的一些，那么不允许使用特定的全局变量可能会很有用。

🌐 Disallowing usage of specific global variables can be useful if you want to allow a set of global variables, but still want to disallow some of those.

例如，早期的 Internet Explorer 版本将当前的 DOM 事件作为全局变量 event 暴露出来，但长期以来使用这个变量一直被认为是不好的做法。限制它将确保在浏览器代码中不使用此变量。

🌐 For instance, early Internet Explorer versions exposed the current DOM event as a global variable event, but using this variable has been considered as a bad practice for a long time. Restricting this will make sure this variable isn’t used in browser code.

规则详情

🌐 Rule Details

此规则允许你指定不想在应用中使用的全局变量名称。

🌐 This rule allows you to specify global variable names that you don’t want to use in your application.

选项

🌐 Options

此规则同时包含字符串和对象选项，用于指定要限制的全局变量。

🌐 This rule has both string and object options to specify the global variables to restrict.

使用字符串选项，你可以指定要限制为规则选项数组中值的全局变量名称：

🌐 Using the string option, you can specify the name of a global variable that you want to restrict as a value in the rule options array:

{
    "rules": {
        "no-restricted-globals": ["error", "event", "fdescribe"]
    }
}
1
2
3
4
5

或者，该规则还接受对象，其中指定了全局名称和可选的自定义消息：

🌐 Alternatively, the rule also accepts objects, where the global name and an optional custom message are specified:

{
    "rules": {
        "no-restricted-globals": [
            "error",
            {
                "name": "event",
                "message": "Use local parameter instead."
            },
            {
                "name": "fdescribe",
                "message": "Do not commit fdescribe. Use describe instead."
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

示例 "event", "fdescribe" 全局变量名的错误代码示例：

🌐 Examples of incorrect code for sample "event", "fdescribe" global variable names:

/*global event, fdescribe*/
/*eslint no-restricted-globals: ["error", "event", "fdescribe"]*/

function onClick() {
    console.log(event);
}

fdescribe("foo", function() {
});
1
2
3
4
5
6
7
8
9

示例：针对示例 "event" 全局变量名的正确代码：

🌐 Examples of correct code for a sample "event" global variable name:

/*global event*/
/*eslint no-restricted-globals: ["error", "event"]*/

import event from "event-module";
1
2
3
4

/*global event*/
/*eslint no-restricted-globals: ["error", "event"]*/

const event = 1;
1
2
3
4

针对示例 "event" 全局变量名的 错误 代码示例，以及自定义错误消息：

🌐 Examples of incorrect code for a sample "event" global variable name, along with a custom error message:

/*global event*/
/* eslint no-restricted-globals: ["error", { name: "event", message: "Use local parameter instead." }] */

function onClick() {
    console.log(event);    // Unexpected global variable 'event'. Use local parameter instead.
}
1
2
3
4
5
6

globals

一个对象选项，其值是一个数组，其中包含要限制的全局变量的名称。

🌐 An object option whose value is an array containing the names of the globals you want to restrict.

"event" 和 "fdescribe" 全局变量名的错误代码示例：

🌐 Examples of incorrect code for "event" and "fdescribe" global variable names:

/*global event, fdescribe*/
/*eslint no-restricted-globals: ["error", { globals: ["event", "fdescribe"] }]*/

function onClick() {
    console.log(event);
}

fdescribe("foo", function() {
});
1
2
3
4
5
6
7
8
9

可以使用带有 name 和 message 的对象在 globals 数组中为特定全局指定自定义消息：

🌐 Custom messages for a particular global can also be specified in globals array using objects with name and message:

针对 "event" 全局变量名的错误代码示例，以及自定义错误消息：

🌐 Examples of incorrect code for an "event" global variable name, along with a custom error message:

/*global event*/
/* eslint no-restricted-globals: ["error", { globals: [{ name: "event", message: "Use local parameter instead." }] }] */

function onClick() {
    console.log(event);
}
1
2
3
4
5
6

checkGlobalObject

一个布尔选项，用于启用通过全局对象访问受限全局变量的检测。默认值是 false。

🌐 A boolean option that enables detection of restricted globals accessed via global objects. Default is false.

checkGlobalObject: true 选项的错误代码示例：

🌐 Examples of incorrect code for checkGlobalObject: true option:

/*global globalThis, self, window*/
/*eslint no-restricted-globals: ["error", { globals: ["Promise"], checkGlobalObject: true }]*/

globalThis.Promise
self.Promise
window.Promise
1
2
3
4
5
6

globalObjects

一个数组选项，用于在启用 checkGlobalObject 时指定要检查的其他全局对象名称。默认情况下，该规则会检查以下全局对象：globalThis、self 和 window。

🌐 An array option that specifies additional global object names to check when checkGlobalObject is enabled. By default, the rule checks these global objects: globalThis, self, and window.

globalObjects 选项的错误代码示例：

🌐 Examples of incorrect code for globalObjects option:

/*global globalThis, self, window, myGlobal*/
/*eslint no-restricted-globals: ["error", {
    globals: ["Promise"],
    checkGlobalObject: true,
    globalObjects: ["myGlobal"]
}]*/

globalThis.Promise
self.Promise
window.Promise
myGlobal.Promise;
1
2
3
4
5
6
7
8
9
10
11

此规则忽略 TypeScript 类型注释中使用的受限全局变量（例如类型引用、接口继承或类实现）。

🌐 Restricted globals used in TypeScript type annotations—such as type references, interface inheritance, or class implementations—are ignored by this rule.

“Promise”、“Event”和“Window”全局变量名的正确 TypeScript 代码示例：

🌐 Examples of correct TypeScript code for “Promise”, “Event”, and “Window” global variable names:

/*eslint no-restricted-globals: ["error", "Promise", "Event", "Window"]*/

const fetchData: Promise<string> = fetchString();

interface CustomEvent extends Event {}

class CustomWindow implements Window {}

function handleClick(event: Event) {
  console.log(event);
}
1
2
3
4
5
6
7
8
9
10
11

相关规则

• no-restricted-properties
• no-restricted-syntax

版本

此规则是在 ESLint v2.3.0 中引入。

资源

• 规则源码
• 测试源码