类成员间空行

要求或禁止在类成员之间使用空行

🔧

此规则报告的一些问题可以通过 --fix 命令行选项自动修复

此规则在 ESLint v8.53.0 中被 **弃用**。请使用相应的规则在 @stylistic/eslint-plugin-js 中。

此规则通过在类成员之间强制使用空行来提高可读性。它不会检查第一个成员之前的空行和最后一个成员之后的空行，因为这已经由 padded-blocks 处理。

规则详细信息

此规则 **不正确** 代码示例

/* eslint lines-between-class-members: ["error", "always"]*/
class MyClass {
  x;
  foo() {
    //...
  }
  bar() {
    //...
  }
}
1
2
3
4
5
6
7
8
9
10

此规则 **正确** 代码示例

在游乐场中打开

/* eslint lines-between-class-members: ["error", "always"]*/
class MyClass {
  x;

  foo() {
    //...
  }

  bar() {
    //...
  }
}
1
2
3
4
5
6
7
8
9
10
11
12

此规则的其他 **正确** 代码示例

在游乐场中打开

/* eslint lines-between-class-members: ["error", "always"]*/
class MyClass {
  x = 1

  ;in = 2
}
1
2
3
4
5
6

选项

此规则有两个选项，第一个选项可以是字符串或对象，第二个选项是对象。

第一个选项可以是字符串 "always" 或 "never"，或者是一个具有名为 enforce 的属性的对象

"always"（默认）要求在类成员之后使用空行
"never" 禁止在类成员之后使用空行
对象：一个具有名为 enforce 的属性的对象。enforce 属性应该是一个对象数组，每个对象都指定了在特定类成员对之间强制使用空行的配置。
- enforce：您可以提供任意数量的配置。如果一个成员对匹配多个配置，将使用最后一个匹配的配置。如果一个成员对不匹配任何配置，它将被忽略。每个对象都应该具有以下属性
  - blankLine：可以设置为 "always" 或 "never"，指示在指定的成员之间是否需要或禁止使用空行。
  - prev：指定前一个类成员的类型。它可以是 "method" 用于类方法，"field" 用于类字段，或 "*" 用于任何类成员。
  - next：指定下一个类成员的类型。它遵循与 prev 相同的选项。

第二个选项是一个具有名为 exceptAfterSingleLine 的属性的对象

"exceptAfterSingleLine": false（默认） **不** 跳过检查单行类成员之后的空行
"exceptAfterSingleLine": true 跳过检查单行类成员之后的空行

使用字符串选项的此规则 **不正确** 代码示例

在游乐场中打开

/* eslint lines-between-class-members: ["error", "always"]*/
class Foo{
  x;
  bar(){}
  baz(){}
}
1
2
3
4
5
6

在游乐场中打开

/* eslint lines-between-class-members: ["error", "never"]*/
class Bar{
  x;

  bar(){}

  baz(){}
}
1
2
3
4
5
6
7
8

使用字符串选项的此规则 **正确** 代码示例

在游乐场中打开

/* eslint lines-between-class-members: ["error", "always"]*/
class Foo{
  x;

  bar(){}

  baz(){}
}
1
2
3
4
5
6
7
8

在游乐场中打开

/* eslint lines-between-class-members: ["error", "never"]*/
class Bar{
  x;
  bar(){}
  baz(){}
}
1
2
3
4
5
6

使用配置数组选项的此规则 **不正确** 代码示例

在游乐场中打开

// disallows blank lines between methods
/*eslint lines-between-class-members: [
    "error",
    {
      enforce: [
        { blankLine: "never", prev: "method", next: "method" }
      ]
    },
]*/

class MyClass {
  constructor(height, width) {
      this.height = height;
      this.width = width;
  }

  fieldA = 'Field A';
  #fieldB = 'Field B';

  method1() {}

  get area() {
    return this.method1();
  }

  method2() {}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

在游乐场中打开

// requires blank lines around fields, disallows blank lines between methods
/*eslint lines-between-class-members: [
    "error",
    {
      enforce: [
        { blankLine: "always", prev: "*", next: "field" },
        { blankLine: "always", prev: "field", next: "*" },
        { blankLine: "never", prev: "method", next: "method" }
      ]
    },
]*/

class MyClass {
  constructor(height, width) {
      this.height = height;
      this.width = width;
  }
  fieldA = 'Field A';
  #fieldB = 'Field B';
  method1() {}

  get area() {
    return this.method1();
  }

  method2() {}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

使用配置数组选项的此规则 **正确** 代码示例

在游乐场中打开

// disallows blank lines between methods
/*eslint lines-between-class-members: [
    "error",
    {
      enforce: [
        { blankLine: "never", prev: "method", next: "method" }
      ]
    },
]*/

class MyClass {
  constructor(height, width) {
      this.height = height;
      this.width = width;
  }

  fieldA = 'Field A';

  #fieldB = 'Field B';

  method1() {}
  get area() {
    return this.method1();
  }
  method2() {}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

在游乐场中打开

// requires blank lines around fields, disallows blank lines between methods
/*eslint lines-between-class-members: [
    "error",
    {
      enforce: [
        { blankLine: "always", prev: "*", next: "field" },
        { blankLine: "always", prev: "field", next: "*" },
        { blankLine: "never", prev: "method", next: "method" }
      ]
    },
]*/

class MyClass {
  constructor(height, width) {
      this.height = height;
      this.width = width;
  }

  fieldA = 'Field A';

  #fieldB = 'Field B';

  method1() {}
  get area() {
    return this.method1();
  }
  method2() {}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

使用对象选项的此规则 **正确** 代码示例

在游乐场中打开

/* eslint lines-between-class-members: ["error", "always", { "exceptAfterSingleLine": true }]*/
class Foo{
  x; // single line class member
  bar(){} // single line class member
  baz(){
    // multi line class member
  }

  qux(){}
}
1
2
3
4
5
6
7
8
9
10

在游乐场中打开

/*eslint lines-between-class-members: [
    "error",
    {
      enforce: [
        { blankLine: "always", prev: "*", next: "method" },
        { blankLine: "always", prev: "method", next: "*" },
        { blankLine: "always", prev: "field", next: "field" }
      ]
    },
    { exceptAfterSingleLine: true }
]*/

class MyClass {
  constructor(height, width) {
      this.height = height;
      this.width = width;
  }

  fieldA = 'Field A';
  #fieldB = 'Field B';
  method1() {}
  get area() {
    return this.method1();
  }

  method2() {}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

何时不使用它

如果您不想在类成员之间强制使用空行，可以禁用此规则。

兼容性

版本

此规则是在 ESLint v4.9.0 中引入的。

资源

编辑此页面

类成员间空行

规则详细信息

选项

何时不使用它

兼容性

相关规则

版本

资源