Blame view

node_modules/eslint/lib/rules/line-comment-position.js 3.92 KB
ce4c83ff   wxy   初始提交
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
  /**
   * @fileoverview Rule to enforce the position of line comments
   * @author Alberto Rodríguez
   */
  "use strict";
  
  const astUtils = require("../ast-utils");
  
  //------------------------------------------------------------------------------
  // Rule Definition
  //------------------------------------------------------------------------------
  
  module.exports = {
      meta: {
          docs: {
              description: "enforce position of line comments",
              category: "Stylistic Issues",
              recommended: false,
              url: "https://eslint.org/docs/rules/line-comment-position"
          },
  
          schema: [
              {
                  oneOf: [
                      {
                          enum: ["above", "beside"]
                      },
                      {
                          type: "object",
                          properties: {
                              position: {
                                  enum: ["above", "beside"]
                              },
                              ignorePattern: {
                                  type: "string"
                              },
                              applyDefaultPatterns: {
                                  type: "boolean"
                              },
                              applyDefaultIgnorePatterns: {
                                  type: "boolean"
                              }
                          },
                          additionalProperties: false
                      }
                  ]
              }
          ]
      },
  
      create(context) {
          const options = context.options[0];
  
          let above,
              ignorePattern,
              applyDefaultIgnorePatterns = true;
  
          if (!options || typeof options === "string") {
              above = !options || options === "above";
  
          } else {
              above = options.position === "above";
              ignorePattern = options.ignorePattern;
  
              if (options.hasOwnProperty("applyDefaultIgnorePatterns")) {
                  applyDefaultIgnorePatterns = options.applyDefaultIgnorePatterns !== false;
              } else {
                  applyDefaultIgnorePatterns = options.applyDefaultPatterns !== false;
              }
          }
  
          const defaultIgnoreRegExp = astUtils.COMMENTS_IGNORE_PATTERN;
          const fallThroughRegExp = /^\s*falls?\s?through/;
          const customIgnoreRegExp = new RegExp(ignorePattern);
          const sourceCode = context.getSourceCode();
  
          //--------------------------------------------------------------------------
          // Public
          //--------------------------------------------------------------------------
  
          return {
              Program() {
                  const comments = sourceCode.getAllComments();
  
                  comments.filter(token => token.type === "Line").forEach(node => {
                      if (applyDefaultIgnorePatterns && (defaultIgnoreRegExp.test(node.value) || fallThroughRegExp.test(node.value))) {
                          return;
                      }
  
                      if (ignorePattern && customIgnoreRegExp.test(node.value)) {
                          return;
                      }
  
                      const previous = sourceCode.getTokenBefore(node, { includeComments: true });
                      const isOnSameLine = previous && previous.loc.end.line === node.loc.start.line;
  
                      if (above) {
                          if (isOnSameLine) {
                              context.report({
                                  node,
                                  message: "Expected comment to be above code."
                              });
                          }
                      } else {
                          if (!isOnSameLine) {
                              context.report({
                                  node,
                                  message: "Expected comment to be beside code."
                              });
                          }
                      }
                  });
              }
          };
      }
  };