no-shadow-restricted-names

禁止識別符號遮蔽受限名稱

ES5 §15.1.1 全域物件的值屬性 (NaN、Infinity、undefined) 以及嚴格模式限制的識別符號 eval 和 arguments 在 JavaScript 中被視為受限名稱。將它們定義為其他含義可能會產生意想不到的後果，並使閱讀程式碼的其他人感到困惑。例如，沒有什麼可以阻止您編寫

var undefined = "foo";
1

然後，在相同範圍內使用的任何程式碼都將不會獲得全域 undefined，而是具有非常不同含義的本機版本。

規則詳情

此規則的不正確程式碼範例

/*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

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

import NaN from "foo";

import { undefined } from "bar";

class Infinity {}
1
2
3
4
5
6
7

此規則的正確程式碼範例

/*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

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

import { undefined as undef } from "bar";
1
2
3

相關規則

• no-shadow

版本

此規則在 ESLint v0.1.4 中引入。

延伸閱讀

註解 ES5
es5.github.io

註解 ES5
es5.github.io

資源

• 規則來源
• 測試來源