init-declarations

要求或禁止在变量声明中进行初始化

在 JavaScript 中，变量可以在声明时分配，也可以在以后使用赋值语句在任何时候分配。例如，在以下代码中，foo 在声明时被初始化，而 bar 则在稍后被初始化。

var foo = 1;
var bar;

if (foo) {
    bar = 1;
} else {
    bar = 2;
}
1
2
3
4
5
6
7
8

规则详细信息

此规则旨在强制执行或消除声明期间的变量初始化。例如，在以下代码中，foo 在声明时被初始化，而 bar 则没有。

var foo = 1;
var bar;

bar = 2;
1
2
3
4

此规则旨在为变量初始化和声明带来一致性。

选项

此规则有两个选项

一个字符串，必须是 "always"（默认值），用于强制在声明时进行初始化，或者 "never" 用于禁止在声明时进行初始化。此规则适用于 var、let 和 const 变量，但是 "never" 对 const 变量无效，因为未赋值的 const 会导致解析错误。
一个对象，进一步控制此规则的行为。目前，唯一可用的参数是 ignoreForLoopInit，它指示当设置 "never" 时是否允许在 for 循环中声明时进行初始化，因为它是一个非常典型的用例。

您可以按如下方式配置规则

变量必须在声明时初始化（默认值）

{
    "init-declarations": ["error", "always"],
}
1
2
3

变量必须不在声明时初始化

{
    "init-declarations": ["error", "never"]
}
1
2
3

变量必须不在声明时初始化，除了在允许的 for 循环中

{
    "init-declarations": ["error", "never", { "ignoreForLoopInit": true }]
}
1
2
3

always

对于默认的 "always" 选项，不正确代码的示例

在游乐场中打开

/*eslint init-declarations: ["error", "always"]*/

function foo() {
    var bar;
    let baz;
}
1
2
3
4
5
6

对于默认的 "always" 选项，正确代码的示例

在游乐场中打开

/*eslint init-declarations: ["error", "always"]*/

function foo() {
    var bar = 1;
    let baz = 2;
    const qux = 3;
}
1
2
3
4
5
6
7

never

对于 "never" 选项，不正确代码的示例

在游乐场中打开

/*eslint init-declarations: ["error", "never"]*/

function foo() {
    var bar = 1;
    let baz = 2;

    for (var i = 0; i < 1; i++) {}
}
1
2
3
4
5
6
7
8

对于 "never" 选项，正确代码的示例

在游乐场中打开

/*eslint init-declarations: ["error", "never"]*/

function foo() {
    var bar;
    let baz;
    const buzz = 1;
}
1
2
3
4
5
6
7

"never" 选项忽略 const 变量初始化。

ignoreForLoopInit

对于 "never", { "ignoreForLoopInit": true } 选项，正确代码的示例

在游乐场中打开

/*eslint init-declarations: ["error", "never", { "ignoreForLoopInit": true }]*/
for (var i = 0; i < 1; i++) {}
1
2

何时不使用它

当您对变量的初始化方式无所谓时。

版本

此规则在 ESLint v1.0.0-rc-1 中引入。

资源

编辑此页面