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

此規則旨在使變數初始化和宣告保持一致性。

選項

此規則採用兩個選項

1. 一個字串，必須為 "always" (預設值) ，以強制在宣告時進行初始化，或 "never" 以禁止在宣告期間進行初始化。此規則適用於 var、let 和 const 變數，但是 "never" 對於 const 變數會被忽略，因為未指派值的 const 會產生語法錯誤。
2. 一個物件，可以進一步控制此規則的行為。目前，唯一可用的參數是 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 中引入的。

資源

• 規則來源
• 測試來源