版本

operator-linebreak

強制運算子使用一致的換行樣式

🔧 可修正

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

重要

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

了解更多

當一個陳述式太長而無法放在單行時,通常會在分隔表達式的運算子旁邊插入換行符號。首先想到的樣式是將運算子放在行尾,遵循英文標點符號規則。

var fullHeight = borderTop +
                 innerHeight +
                 borderBottom;

有些開發人員認為將運算子放在行首可以使程式碼更易於閱讀。

var fullHeight = borderTop
               + innerHeight
               + borderBottom;

規則詳細資訊

此規則強制運算子使用一致的換行樣式。

選項

此規則有兩個選項,一個字串選項和一個物件選項。

字串選項

  • "after" 要求換行符號放在運算子之後
  • "before" 要求換行符號放在運算子之前
  • "none" 不允許在運算子的任一側換行

物件選項

  • "overrides" 覆寫指定運算子的全域設定

預設設定為 "after", { "overrides": { "?": "before", ":": "before" } }

after

使用 "after" 選項時,不正確程式碼範例

在 Playground 中開啟
/*eslint operator-linebreak: ["error", "after"]*/

foo = 1
+
2;

foo = 1
    + 2;

foo
    = 5;

if (someCondition
    || otherCondition) {
}

answer = everything
  ? 42
  : foo;

class Foo {
    a
        = 1;
    [b]
        = 2;
    [c
    ]
        = 3;
}

使用 "after" 選項時,正確程式碼範例

在 Playground 中開啟
/*eslint operator-linebreak: ["error", "after"]*/

foo = 1 + 2;

foo = 1 +
      2;

foo =
    5;

if (someCondition ||
    otherCondition) {
}

answer = everything ?
  42 :
  foo;

class Foo {
    a =
        1;
    [b] =
        2;
    [c
    ] =
        3;
    d = 4;
}

before

使用 "before" 選項時,不正確程式碼範例

在 Playground 中開啟
/*eslint operator-linebreak: ["error", "before"]*/

foo = 1 +
      2;

foo =
    5;

if (someCondition ||
    otherCondition) {
}

answer = everything ?
  42 :
  foo;

class Foo {
    a =
        1;
    [b] =
        2;
    [c
    ] =
        3;
}

使用 "before" 選項時,正確程式碼範例

在 Playground 中開啟
/*eslint operator-linebreak: ["error", "before"]*/

foo = 1 + 2;

foo = 1
    + 2;

foo
    = 5;

if (someCondition
    || otherCondition) {
}

answer = everything
  ? 42
  : foo;

class Foo {
    a
        = 1;
    [b]
        = 2;
    [c
    ]
        = 3;
    d = 4;
}

none

使用 "none" 選項時,不正確程式碼範例

在 Playground 中開啟
/*eslint operator-linebreak: ["error", "none"]*/

foo = 1 +
      2;

foo = 1
    + 2;

if (someCondition ||
    otherCondition) {
}

if (someCondition
    || otherCondition) {
}

answer = everything
  ? 42
  : foo;

answer = everything ?
  42 :
  foo;

class Foo {
    a =
        1;
    [b] =
        2;
    [c
    ] =
        3;
    d
        = 4;
    [e]
        = 5;
    [f
    ]
        = 6;
}

使用 "none" 選項時,正確程式碼範例

在 Playground 中開啟
/*eslint operator-linebreak: ["error", "none"]*/

foo = 1 + 2;

foo = 5;

if (someCondition || otherCondition) {
}

answer = everything ? 42 : foo;

class Foo {
    a = 1;
    [b] = 2;
    [c
    ] = 3;
    d = 4;
    [e] = 5;
    [f
    ] = 6;
}

overrides

使用 { "overrides": { "+=": "before" } } 選項時,額外 不正確 程式碼範例

在 Playground 中開啟
/*eslint operator-linebreak: ["error", "after", { "overrides": { "+=": "before" } }]*/

var thing = 'thing';
thing +=
  's';

使用 { "overrides": { "+=": "before" } } 選項時,額外 正確 程式碼範例

在 Playground 中開啟
/*eslint operator-linebreak: ["error", "after", { "overrides": { "+=": "before" } }]*/

var thing = 'thing';
thing
  += 's';

使用 { "overrides": { "?": "ignore", ":": "ignore" } } 選項時,額外 正確 程式碼範例

在 Playground 中開啟
/*eslint operator-linebreak: ["error", "after", { "overrides": { "?": "ignore", ":": "ignore" } }]*/

answer = everything ?
  42
  : foo;

answer = everything
  ?
  42
  :
  foo;

使用預設 "after", { "overrides": { "?": "before", ":": "before" } } 選項時,不正確 程式碼範例

在 Playground 中開啟
/*eslint operator-linebreak: ["error", "after", { "overrides": { "?": "before", ":": "before" } }]*/

foo = 1
+
2;

foo = 1
    + 2;

foo
    = 5;

if (someCondition
    || otherCondition) {
}

answer = everything ?
  42 :
  foo;

使用預設 "after", { "overrides": { "?": "before", ":": "before" } } 選項時,正確 程式碼範例

在 Playground 中開啟
/*eslint operator-linebreak: ["error", "after", { "overrides": { "?": "before", ":": "before" } }]*/

foo = 1 + 2;

foo = 1 +
      2;

foo =
    5;

if (someCondition ||
    otherCondition) {
}

answer = everything
  ? 42
  : foo;

何時不該使用它

如果您的專案不會使用常見的運算子換行樣式,請關閉此規則。

版本

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

資源

變更語言