123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778 |
- /**
- * @author Yosuke Ota <https://github.com/ota-meshi>
- * See LICENSE file in root directory for full license.
- */
- "use strict"
- const utils = require("../internal/utils")
- module.exports = {
- meta: {
- docs: {
- description:
- "require include descriptions in ESLint directive-comments",
- category: "Stylistic Issues",
- recommended: false,
- url:
- "https://mysticatea.github.io/eslint-plugin-eslint-comments/rules/require-description.html",
- },
- fixable: null,
- schema: [
- {
- type: "object",
- properties: {
- ignore: {
- type: "array",
- items: {
- enum: [
- "eslint",
- "eslint-disable",
- "eslint-disable-line",
- "eslint-disable-next-line",
- "eslint-enable",
- "eslint-env",
- "exported",
- "global",
- "globals",
- ],
- },
- additionalItems: false,
- uniqueItems: true,
- },
- },
- additionalProperties: false,
- },
- ],
- type: "suggestion",
- },
- create(context) {
- const sourceCode = context.getSourceCode()
- const ignores = new Set(
- (context.options[0] && context.options[0].ignore) || []
- )
- return {
- Program() {
- for (const comment of sourceCode.getAllComments()) {
- const directiveComment = utils.parseDirectiveComment(
- comment
- )
- if (directiveComment == null) {
- continue
- }
- if (ignores.has(directiveComment.kind)) {
- continue
- }
- if (!directiveComment.description) {
- context.report({
- loc: utils.toForceLocation(comment.loc),
- message:
- "Unexpected undescribed directive comment. Include descriptions to explain why the comment is necessary.",
- })
- }
- }
- },
- }
- },
- }
|