newline-after-var

要求或禁止在變數宣告後使用空行

🔧

此規則回報的一些問題可以透過 --fix 命令列選項自動修正

重要

此規則在 ESLint v4.0.0 中已棄用。請使用 @stylistic/eslint-plugin-js 中的對應規則。

了解更多

至今，在將變數宣告與程式碼其餘部分分開方面沒有一致性。有些開發人員在 var 語句和程式碼其餘部分之間留空行，例如

var foo;

// do something with foo
1
2
3

然而，其他開發人員則完全不留任何空行。

var foo;
// do something with foo
1
2

問題是當這些開發人員在同一個專案中一起工作時。此規則強制執行一種編碼風格，其中允許或不允許在 var、let 或 const 語句之後使用空行。這有助於使整個專案中的程式碼看起來一致。

規則詳情

此規則強制執行一種編碼風格，其中要求或禁止在 var、let 或 const 語句之後使用空行，以在整個專案中實現一致的編碼風格。

選項

此規則有一個字串選項

"always" (預設) 要求在 var、let 或 const 之後使用空行

在 var 語句之後直接在一行上的註解會被視為額外的 var 語句。
"never" 禁止在 var、let 或 const 之後使用空行

always

使用預設 "always" 選項時，此規則的錯誤程式碼範例

在 Playground 中開啟

/*eslint newline-after-var: ["error", "always"]*/

var greet = "hello,",
    name = "world";
console.log(greet, name);

let hello = "hello,",
    world = "world";
console.log(hello, world);

var greet = "hello,";
const NAME = "world";
console.log(greet, NAME);

var greet = "hello,";
var name = "world";
// var name = require("world");
console.log(greet, name);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

使用預設 "always" 選項時，此規則的正確程式碼範例

在 Playground 中開啟

/*eslint newline-after-var: ["error", "always"]*/

var greet = "hello,",
    name = "world";

console.log(greet, name);

let hello = "hello,",
    world = "world";

console.log(hello, world);

var greet = "hello,";
const NAME = "world";

console.log(greet, NAME);

var greet = "hello,";
var name = "world";
// var name = require("world");

console.log(greet, name);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

never

使用 "never" 選項時，此規則的錯誤程式碼範例

在 Playground 中開啟

/*eslint newline-after-var: ["error", "never"]*/

var greet = "hello,",
    name = "world";

console.log(greet, name);

let hello = "hello,",
    world = "world";

console.log(hello, world);

var greet = "hello,";
const NAME = "world";

console.log(greet, NAME);

var greet = "hello,";
var name = "world";
// var name = require("world");

console.log(greet, name);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

使用 "never" 選項時，此規則的正確程式碼範例

在 Playground 中開啟

/*eslint newline-after-var: ["error", "never"]*/

var greet = "hello,",
    name = "world";
console.log(greet, name);

let hello = "hello,",
    world = "world";
console.log(hello, world);

var greet = "hello,";
const NAME = "world";
console.log(greet, NAME);

var greet = "hello,";
var name = "world";
// var name = require("world");
console.log(greet, name);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

版本

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

資源

編輯此頁面