Blame view

node_modules/eslint/lib/rules/prefer-rest-params.js 3.07 KB
f7563de62   Palak Handa   first commit
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
  /**
   * @fileoverview Rule to
   * @author Toru Nagashima
   */
  
  "use strict";
  
  //------------------------------------------------------------------------------
  // Helpers
  //------------------------------------------------------------------------------
  
  /**
   * Gets the variable object of `arguments` which is defined implicitly.
   * @param {escope.Scope} scope - A scope to get.
   * @returns {escope.Variable} The found variable object.
   */
  function getVariableOfArguments(scope) {
      const variables = scope.variables;
  
      for (let i = 0; i < variables.length; ++i) {
          const variable = variables[i];
  
          if (variable.name === "arguments") {
  
              // If there was a parameter which is named "arguments", the implicit "arguments" is not defined.
              // So does fast return with null.
              return (variable.identifiers.length === 0) ? variable : null;
          }
      }
  
      /* istanbul ignore next : unreachable */
      return null;
  }
  
  /**
   * Checks if the given reference is not normal member access.
   *
   * - arguments         .... true    // not member access
   * - arguments[i]      .... true    // computed member access
   * - arguments[0]      .... true    // computed member access
   * - arguments.length  .... false   // normal member access
   *
   * @param {escope.Reference} reference - The reference to check.
   * @returns {boolean} `true` if the reference is not normal member access.
   */
  function isNotNormalMemberAccess(reference) {
      const id = reference.identifier;
      const parent = id.parent;
  
      return !(
          parent.type === "MemberExpression" &&
          parent.object === id &&
          !parent.computed
      );
  }
  
  //------------------------------------------------------------------------------
  // Rule Definition
  //------------------------------------------------------------------------------
  
  module.exports = {
      meta: {
          docs: {
              description: "require rest parameters instead of `arguments`",
              category: "ECMAScript 6",
              recommended: false
          },
  
          schema: []
      },
  
      create(context) {
  
          /**
           * Reports a given reference.
           *
           * @param {escope.Reference} reference - A reference to report.
           * @returns {void}
           */
          function report(reference) {
              context.report({
                  node: reference.identifier,
                  loc: reference.identifier.loc,
                  message: "Use the rest parameters instead of 'arguments'."
              });
          }
  
          /**
           * Reports references of the implicit `arguments` variable if exist.
           *
           * @returns {void}
           */
          function checkForArguments() {
              const argumentsVar = getVariableOfArguments(context.getScope());
  
              if (argumentsVar) {
                  argumentsVar
                      .references
                      .filter(isNotNormalMemberAccess)
                      .forEach(report);
              }
          }
  
          return {
              "FunctionDeclaration:exit": checkForArguments,
              "FunctionExpression:exit": checkForArguments
          };
      }
  };