104 lines
		
	
	
		
			3.1 KiB
		
	
	
	
		
			JavaScript
		
	
	
	
	
	
			
		
		
	
	
			104 lines
		
	
	
		
			3.1 KiB
		
	
	
	
		
			JavaScript
		
	
	
	
	
	
/**
 | 
						|
 * @fileoverview Rule to flag use of an empty block statement
 | 
						|
 * @author Nicholas C. Zakas
 | 
						|
 */
 | 
						|
"use strict";
 | 
						|
 | 
						|
//------------------------------------------------------------------------------
 | 
						|
// Requirements
 | 
						|
//------------------------------------------------------------------------------
 | 
						|
 | 
						|
const astUtils = require("./utils/ast-utils");
 | 
						|
 | 
						|
//------------------------------------------------------------------------------
 | 
						|
// Rule Definition
 | 
						|
//------------------------------------------------------------------------------
 | 
						|
 | 
						|
/** @type {import('../shared/types').Rule} */
 | 
						|
module.exports = {
 | 
						|
    meta: {
 | 
						|
        hasSuggestions: true,
 | 
						|
        type: "suggestion",
 | 
						|
 | 
						|
        docs: {
 | 
						|
            description: "Disallow empty block statements",
 | 
						|
            recommended: true,
 | 
						|
            url: "https://eslint.org/docs/latest/rules/no-empty"
 | 
						|
        },
 | 
						|
 | 
						|
        schema: [
 | 
						|
            {
 | 
						|
                type: "object",
 | 
						|
                properties: {
 | 
						|
                    allowEmptyCatch: {
 | 
						|
                        type: "boolean",
 | 
						|
                        default: false
 | 
						|
                    }
 | 
						|
                },
 | 
						|
                additionalProperties: false
 | 
						|
            }
 | 
						|
        ],
 | 
						|
 | 
						|
        messages: {
 | 
						|
            unexpected: "Empty {{type}} statement.",
 | 
						|
            suggestComment: "Add comment inside empty {{type}} statement."
 | 
						|
        }
 | 
						|
    },
 | 
						|
 | 
						|
    create(context) {
 | 
						|
        const options = context.options[0] || {},
 | 
						|
            allowEmptyCatch = options.allowEmptyCatch || false;
 | 
						|
 | 
						|
        const sourceCode = context.sourceCode;
 | 
						|
 | 
						|
        return {
 | 
						|
            BlockStatement(node) {
 | 
						|
 | 
						|
                // if the body is not empty, we can just return immediately
 | 
						|
                if (node.body.length !== 0) {
 | 
						|
                    return;
 | 
						|
                }
 | 
						|
 | 
						|
                // a function is generally allowed to be empty
 | 
						|
                if (astUtils.isFunction(node.parent)) {
 | 
						|
                    return;
 | 
						|
                }
 | 
						|
 | 
						|
                if (allowEmptyCatch && node.parent.type === "CatchClause") {
 | 
						|
                    return;
 | 
						|
                }
 | 
						|
 | 
						|
                // any other block is only allowed to be empty, if it contains a comment
 | 
						|
                if (sourceCode.getCommentsInside(node).length > 0) {
 | 
						|
                    return;
 | 
						|
                }
 | 
						|
 | 
						|
                context.report({
 | 
						|
                    node,
 | 
						|
                    messageId: "unexpected",
 | 
						|
                    data: { type: "block" },
 | 
						|
                    suggest: [
 | 
						|
                        {
 | 
						|
                            messageId: "suggestComment",
 | 
						|
                            data: { type: "block" },
 | 
						|
                            fix(fixer) {
 | 
						|
                                const range = [node.range[0] + 1, node.range[1] - 1];
 | 
						|
 | 
						|
                                return fixer.replaceTextRange(range, " /* empty */ ");
 | 
						|
                            }
 | 
						|
                        }
 | 
						|
                    ]
 | 
						|
                });
 | 
						|
            },
 | 
						|
 | 
						|
            SwitchStatement(node) {
 | 
						|
 | 
						|
                if (typeof node.cases === "undefined" || node.cases.length === 0) {
 | 
						|
                    context.report({ node, messageId: "unexpected", data: { type: "switch" } });
 | 
						|
                }
 | 
						|
            }
 | 
						|
        };
 | 
						|
 | 
						|
    }
 | 
						|
};
 |