2 * @fileoverview A rule to ensure whitespace before blocks.
3 * @author Mathias Schreck <https://github.com/lo1tuma>
8 const astUtils = require("./utils/ast-utils");
10 //------------------------------------------------------------------------------
12 //------------------------------------------------------------------------------
19 description: "enforce consistent spacing before blocks",
20 category: "Stylistic Issues",
22 url: "https://eslint.org/docs/rules/space-before-blocks"
25 fixable: "whitespace",
31 enum: ["always", "never"]
37 enum: ["always", "never", "off"]
40 enum: ["always", "never", "off"]
43 enum: ["always", "never", "off"]
46 additionalProperties: false
54 const config = context.options[0],
55 sourceCode = context.getSourceCode();
56 let alwaysFunctions = true,
57 alwaysKeywords = true,
59 neverFunctions = false,
60 neverKeywords = false,
63 if (typeof config === "object") {
64 alwaysFunctions = config.functions === "always";
65 alwaysKeywords = config.keywords === "always";
66 alwaysClasses = config.classes === "always";
67 neverFunctions = config.functions === "never";
68 neverKeywords = config.keywords === "never";
69 neverClasses = config.classes === "never";
70 } else if (config === "never") {
71 alwaysFunctions = false;
72 alwaysKeywords = false;
73 alwaysClasses = false;
74 neverFunctions = true;
80 * Checks whether or not a given token is an arrow operator (=>) or a keyword
81 * in order to avoid to conflict with `arrow-spacing` and `keyword-spacing`.
82 * @param {Token} token A token to check.
83 * @returns {boolean} `true` if the token is an arrow operator.
85 function isConflicted(token) {
86 return (token.type === "Punctuator" && token.value === "=>") || token.type === "Keyword";
90 * Checks the given BlockStatement node has a preceding space if it doesn’t start on a new line.
91 * @param {ASTNode|Token} node The AST node of a BlockStatement.
92 * @returns {void} undefined.
94 function checkPrecedingSpace(node) {
95 const precedingToken = sourceCode.getTokenBefore(node);
97 if (precedingToken && !isConflicted(precedingToken) && astUtils.isTokenOnSameLine(precedingToken, node)) {
98 const hasSpace = sourceCode.isSpaceBetweenTokens(precedingToken, node);
99 const parent = context.getAncestors().pop();
103 if (parent.type === "FunctionExpression" || parent.type === "FunctionDeclaration") {
104 requireSpace = alwaysFunctions;
105 requireNoSpace = neverFunctions;
106 } else if (node.type === "ClassBody") {
107 requireSpace = alwaysClasses;
108 requireNoSpace = neverClasses;
110 requireSpace = alwaysKeywords;
111 requireNoSpace = neverKeywords;
114 if (requireSpace && !hasSpace) {
117 message: "Missing space before opening brace.",
119 return fixer.insertTextBefore(node, " ");
122 } else if (requireNoSpace && hasSpace) {
125 message: "Unexpected space before opening brace.",
127 return fixer.removeRange([precedingToken.range[1], node.range[0]]);
135 * Checks if the CaseBlock of an given SwitchStatement node has a preceding space.
136 * @param {ASTNode} node The node of a SwitchStatement.
137 * @returns {void} undefined.
139 function checkSpaceBeforeCaseBlock(node) {
140 const cases = node.cases;
143 if (cases.length > 0) {
144 openingBrace = sourceCode.getTokenBefore(cases[0]);
146 openingBrace = sourceCode.getLastToken(node, 1);
149 checkPrecedingSpace(openingBrace);
153 BlockStatement: checkPrecedingSpace,
154 ClassBody: checkPrecedingSpace,
155 SwitchStatement: checkSpaceBeforeCaseBlock