no-undefined

禁止使用 undefined 作为标识符

JavaScript 中的 undefined 变量实际上是全局对象的属性。因此，在 ECMAScript 3 中，可以覆盖 undefined 的值。虽然 ECMAScript 5 不允许覆盖 undefined，但仍然可以遮蔽 undefined，例如

function doSomething(data) {
    var undefined = "hi";

    // doesn't do what you think it does
    if (data === undefined) {
        // ...
    }

}
1
2
3
4
5
6
7
8
9

由于 undefined 可以被覆盖或遮蔽，读取 undefined 可能会得到意外的值。（这与 null 不同，null 是一个关键字，始终产生相同的值。）为了防止这种情况，您可以避免所有使用 undefined 的情况，一些代码风格指南建议这样做，本规则也是这样强制执行的。这些代码风格指南还建议

• 应该为 undefined 的变量不进行初始化。（所有未初始化的变量在 JavaScript 中自动获得 undefined 的值。）
• 检查值是否为 undefined 应该使用 typeof。
• 使用 void 运算符在必要时生成 undefined 的值。

作为替代方案，您可以使用 no-global-assign 和 no-shadow-restricted-names 规则来防止 undefined 被遮蔽或分配不同的值。这确保 undefined 将始终保持其原始的、预期值。

规则详细信息

本规则旨在消除 undefined 的使用，因此每当使用它时就会生成警告。

此规则的不正确代码示例

/*eslint no-undefined: "error"*/

var foo = undefined;

var undefined = "foo";

if (foo === undefined) {
    // ...
}

function baz(undefined) {
    // ...
}

bar(undefined, "lorem");
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

此规则的正确代码示例

/*eslint no-undefined: "error"*/

var foo = void 0;

var Undefined = "foo";

if (typeof foo === "undefined") {
    // ...
}

global.undefined = "foo";

bar(void 0, "lorem");
1
2
3
4
5
6
7
8
9
10
11
12
13

何时不使用它

如果您想允许在您的代码中使用 undefined，那么您可以安全地关闭此规则。

相关规则

• no-undef-init
• no-void
• no-shadow-restricted-names
• no-global-assign

版本

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

进一步阅读

undefined - JavaScript | MDN
developer.mozilla.org

了解 JavaScript 的“undefined”
javascriptweblog.wordpress.com

带注释的 ES5
es5.github.io

资源

• 规则来源
• 测试来源