no-shadow-restricted-names

禁止标识符隐藏受限名称

ES5 §15.1.1 全局对象的值属性（NaN、Infinity、undefined）以及严格模式限制标识符 eval 和 arguments 被视为 JavaScript 中的限制名称。将它们定义为其他含义可能会产生意想不到的后果，并使其他阅读代码的人感到困惑。例如，没有什么能阻止你写：

¥ES5 §15.1.1 Value Properties of the Global Object (NaN, Infinity, undefined) as well as strict mode restricted identifiers eval and arguments are considered to be restricted names in JavaScript. Defining them to mean something else can have unintended consequences and confuse others reading the code. For example, there’s nothing preventing you from writing:

var undefined = "foo";
1

那么在同一范围内使用的任何代码都不会得到全局 undefined，而是具有非常不同含义的局部版本。

¥Then any code used within the same scope would not get the global undefined, but rather the local version with a very different meaning.

规则详情

¥Rule Details

此规则的错误代码示例：

¥Examples of incorrect code for this rule:

/*eslint no-shadow-restricted-names: "error"*/

function NaN(){}

!function(Infinity){};

var undefined = 5;

try {} catch(eval){}
1
2
3
4
5
6
7
8
9

此规则的正确代码示例：

¥Examples of correct code for this rule:

/*eslint no-shadow-restricted-names: "error"*/

var Object;

function f(a, b){}

// Exception: `undefined` may be shadowed if the variable is never assigned a value.
var undefined;
1
2
3
4
5
6
7
8

相关规则

• no-shadow

版本

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

进阶读物

Annotated ES5
es5.github.io

Annotated ES5
es5.github.io

资源

• 规则源码
• 测试源码