72 lines
2 KiB
JavaScript
72 lines
2 KiB
JavaScript
|
/**
|
||
|
|
* @fileoverview Rule to enforce description with the `Symbol` object
|
||
|
|
* @author Jarek Rencz
|
||
|
|
*/
|
||
|
|
|
||
|
|
"use strict";
|
||
|
|
|
||
|
|
//------------------------------------------------------------------------------
|
||
|
|
// Requirements
|
||
|
|
//------------------------------------------------------------------------------
|
||
|
|
|
||
|
|
const astUtils = require("./utils/ast-utils");
|
||
|
|
|
||
|
|
//------------------------------------------------------------------------------
|
||
|
|
// Rule Definition
|
||
|
|
//------------------------------------------------------------------------------
|
||
|
|
|
||
|
|
|
||
|
|
/** @type {import('../shared/types').Rule} */
|
||
|
|
module.exports = {
|
||
|
|
meta: {
|
||
|
|
type: "suggestion",
|
||
|
|
|
||
|
|
docs: {
|
||
|
|
description: "require symbol descriptions",
|
||
|
|
recommended: false,
|
||
|
|
url: "https://eslint.org/docs/rules/symbol-description"
|
||
|
|
},
|
||
|
|
fixable: null,
|
||
|
|
schema: [],
|
||
|
|
messages: {
|
||
|
|
expected: "Expected Symbol to have a description."
|
||
|
|
}
|
||
|
|
},
|
||
|
|
|
||
|
|
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,
|
||
|
|
messageId: "expected"
|
||
|
|
});
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
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);
|
||
|
|
}
|
||
|
|
});
|
||
|
|
}
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
}
|
||
|
|
};
|