/** * @fileoverview Rule to enforce description with the `Symbol` object * @author Jarek Rencz */ "use strict"; //------------------------------------------------------------------------------ // Requirements //------------------------------------------------------------------------------ const astUtils = require("../util/ast-utils"); //------------------------------------------------------------------------------ // Rule Definition //------------------------------------------------------------------------------ module.exports = { meta: { type: "suggestion", docs: { description: "require symbol descriptions", category: "ECMAScript 6", recommended: false, url: "https://eslint.org/docs/rules/symbol-description" }, schema: [] }, create(context) { /** * Reports if node does not conform the rule in case rule is set to * report missing description * * @param {ASTNode} node - A CallExpression node to check. * @returns {void} */ function checkArgument(node) { if (node.arguments.length === 0) { context.report({ node, message: "Expected Symbol to have a description." }); } } return { "Program:exit"() { const scope = context.getScope(); const variable = astUtils.getVariableByName(scope, "Symbol"); if (variable && variable.defs.length === 0) { variable.references.forEach(reference => { const node = reference.identifier; if (astUtils.isCallee(node)) { checkArgument(node.parent); } }); } } }; } };