首页
学习
活动
专区
工具
TVP
发布

padding-line-between-statements

--fix命令行上的选项可以自动修复一些被这条规则反映的问题。

此规则要求或不允许给定2种语句之间的空行。适当的空白行可帮助开发人员理解代码。

例如,以下配置需要变量声明和return语句之间的空行。

/*eslint padding-line-between-statements: [
    "error",
    { blankLine: "always", prev: "var", next: "return" }
]*/

function foo() {
    var a = 1;

    return a;
}

规则细节

如果没有配置,此规则不做任何事

配置是具有3个属性的对象; blankLineprevnext。例如,{ blankLine: "always", prev: "var", next: "return" }意思是“变量声明和return语句之间需要一条或多条空行”。您可以提供任意数量的配置。如果语句对匹配多个配置,则将使用最后一个匹配的配置。

{
    "padding-line-between-statements": [
        "error",
        { "blankLine": LINEBREAK_TYPE, "prev": STATEMENT_TYPE, "next": STATEMENT_TYPE },
        { "blankLine": LINEBREAK_TYPE, "prev": STATEMENT_TYPE, "next": STATEMENT_TYPE },
        { "blankLine": LINEBREAK_TYPE, "prev": STATEMENT_TYPE, "next": STATEMENT_TYPE },
        { "blankLine": LINEBREAK_TYPE, "prev": STATEMENT_TYPE, "next": STATEMENT_TYPE },
        ...
    ]
}
  • LINEBREAK_TYPE 是以下之一。
    • "any" 只是忽略了语句对。
    • "never" 禁止空白行。
    • "always"需要一个或多个空行。请注意,它不会将注释以空行形式存在。
  • STATEMENT_TYPE 是以下内容之一,或者是以下内容之一。
    • "*"是通配符。这匹配任何语句。
    • "block" 是孤独的块。
    • "block-like"是像块状语句。这匹配最后一个标记是块的右括号的语句; 例如{ }if (a) { }while (a) { }
    • "break"break陈述。
    • "case"case标签。
    • "cjs-export"exportCommonJS的陈述; 例如module.exports = 0module.exports.foo = 1exports.foo = 2。这是作业的特殊情况。
    • "cjs-import"importCommonJS的陈述; 例如const foo = require("foo")。这是变量声明的特例。
    • "class"class声明。
    • "const"const变量声明。
    • "continue"continue陈述。
    • "debugger"debugger陈述。
    • "default"default标签。
    • "directive"是指令序幕。这匹配指令; 例如"use strict"
    • "do"do-while陈述。这匹配第一个标记是do关键字的所有语句。
    • "empty" 是空的陈述。
    • "export"export声明。
    • "expression" 是表达式语句。
    • "for"for循环系列。这匹配第一个标记是for关键字的所有语句。
    • "function" 是函数声明。
    • "if"if陈述。
    • "import"import声明。
    • "let"let变量声明。
    • "multiline-block-like"是像块状语句。这与block-like类型相同,但只有块是多行的。
    • "return"return陈述。
    • "switch"switch陈述。
    • "throw"throw陈述。
    • "try"try陈述。
    • "var"var变量声明。
    • "while"while循环语句。
    • "with"with陈述。

例子

此配置在所有return语句之前需要空行,如换行前换行符规则。

配置错误代码示例[{ blankLine: "always", prev: "*", next: "return" }]

/*eslint padding-line-between-statements: [
    "error",
    { blankLine: "always", prev: "*", next: "return" }
]*/

function foo() {
    bar();
    return;
}

正确[{ blankLine: "always", prev: "*", next: "return" }]配置代码示例:

/*eslint padding-line-between-statements: [
    "error",
    { blankLine: "always", prev: "*", next: "return" }
]*/

function foo() {
    bar();

    return;
}

function foo() {
    return;
}

这种配置在变量声明的每个序列之后需要空行,如newline-after-var规则。

配置错误代码示例[{ blankLine: "always", prev: ["const", "let", "var"], next: "*"}, { blankLine: "any", prev: ["const", "let", "var"], next: ["const", "let", "var"]}]

/*eslint padding-line-between-statements: [
    "error",
    { blankLine: "always", prev: ["const", "let", "var"], next: "*"},
    { blankLine: "any",    prev: ["const", "let", "var"], next: ["const", "let", "var"]}
]*/

function foo() {
    var a = 0;
    bar();
}

function foo() {
    let a = 0;
    bar();
}

function foo() {
    const a = 0;
    bar();
}

正确[{ blankLine: "always", prev: ["const", "let", "var"], next: "*"}, { blankLine: "any", prev: ["const", "let", "var"], next: ["const", "let", "var"]}]配置代码示例:

/*eslint padding-line-between-statements: [
    "error",
    { blankLine: "always", prev: ["const", "let", "var"], next: "*"},
    { blankLine: "any",    prev: ["const", "let", "var"], next: ["const", "let", "var"]}
]*/

function foo() {
    var a = 0;
    var b = 0;

    bar();
}

function foo() {
    let a = 0;
    const b = 0;

    bar();
}

function foo() {
    const a = 0;
    const b = 0;

    bar();
}

这种配置在所有的指令序言之后都需要空行,例如lines-around-directive规则。

配置错误代码示例[{ blankLine: "always", prev: "directive", next: "*" }, { blankLine: "any", prev: "directive", next: "directive" }]

/*eslint padding-line-between-statements: [
    "error",
    { blankLine: "always", prev: "directive", next: "*" },
    { blankLine: "any",    prev: "directive", next: "directive" }
]*/

"use strict";
foo();

正确[{ blankLine: "always", prev: "directive", next: "*" }, { blankLine: "any", prev: "directive", next: "directive" }]配置代码示例:

/*eslint padding-line-between-statements: [
    "error",
    { blankLine: "always", prev: "directive", next: "*" },
    { blankLine: "any",    prev: "directive", next: "directive" }
]*/

"use strict";
"use asm";

foo();

兼容性

何时不使用它

如果您不想通知有关换行的警告,那么禁用此规则是安全的。

此规则在ESLint 4.0.0-beta.0中引入。

资源

扫码关注腾讯云开发者

领取腾讯云代金券