no-undef

禁止使用未声明的变量，除非在 /*global */ 注释中提及

✅

在配置文件中使用来自 @eslint/js 的 recommended 配置会启用此规则

此规则可以帮助您找到潜在的 ReferenceError，这些错误可能是由于变量和参数名称拼写错误，或意外的隐式全局变量（例如，忘记了 for 循环初始化器中的 var 关键字）。

规则详情

任何对未声明变量的引用都会导致警告，除非该变量在 /*global ...*/ 注释中显式提及，或在配置文件中的 globals 键中指定。这些的常见用例是如果您有意使用在其他地方定义的全局变量（例如，在从 HTML 来源的脚本中）。

此规则的错误代码示例

在 Playground 中打开

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

const foo = someFunction();
const bar = a + 1;
1
2
3
4

此规则的正确代码示例，带有 global 声明

在 Playground 中打开

/*global someFunction, a*/
/*eslint no-undef: "error"*/

const foo = someFunction();
const bar = a + 1;
1
2
3
4
5

请注意，此规则不允许赋值给只读全局变量。如果您也想禁止这些赋值，请参阅 no-global-assign。

此规则也不禁止重新声明全局变量。如果您也想禁止这些重新声明，请参阅 no-redeclare。

默认 { "typeof": false } 选项的正确代码示例

在 Playground 中打开

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

if (typeof UndefinedIdentifier === "undefined") {
    // do something ...
}
1
2
3
4
5

如果您想阻止对未声明的变量进行 typeof 检查，您可以使用此选项。

{ "typeof": true } 选项的错误代码示例

在 Playground 中打开

/*eslint no-undef: ["error", { "typeof": true }] */

if(typeof a === "string"){}
1
2
3

{ "typeof": true } 选项的正确代码示例，带有 global 声明

在 Playground 中打开

/*global a*/
/*eslint no-undef: ["error", { "typeof": true }] */

if(typeof a === "string"){}
1
2
3
4

如果显式声明全局变量不符合您的口味。

此规则提供与 JSHint 和 JSLint 中全局变量处理的兼容性。

当使用 TypeScript 时，禁用此规则是安全的，因为 TypeScript 的编译器会强制执行此检查。

此规则在 ESLint v0.0.9 中引入。

编辑此页面