| /** | |
|  * @fileoverview Rule to flag use of function declaration identifiers as variables. | |
|  * @author Ian Christian Myers | |
|  */ | |
| 
 | |
| "use strict"; | |
| 
 | |
| const astUtils = require("./utils/ast-utils"); | |
| 
 | |
| //------------------------------------------------------------------------------ | |
| // Rule Definition | |
| //------------------------------------------------------------------------------ | |
|  | |
| /** @type {import('../shared/types').Rule} */ | |
| module.exports = { | |
|     meta: { | |
|         type: "problem", | |
| 
 | |
|         docs: { | |
|             description: "Disallow reassigning `function` declarations", | |
|             recommended: true, | |
|             url: "https://eslint.org/docs/latest/rules/no-func-assign" | |
|         }, | |
| 
 | |
|         schema: [], | |
| 
 | |
|         messages: { | |
|             isAFunction: "'{{name}}' is a function." | |
|         } | |
|     }, | |
| 
 | |
|     create(context) { | |
| 
 | |
|         const sourceCode = context.sourceCode; | |
| 
 | |
|         /** | |
|          * Reports a reference if is non initializer and writable. | |
|          * @param {References} references Collection of reference to check. | |
|          * @returns {void} | |
|          */ | |
|         function checkReference(references) { | |
|             astUtils.getModifyingReferences(references).forEach(reference => { | |
|                 context.report({ | |
|                     node: reference.identifier, | |
|                     messageId: "isAFunction", | |
|                     data: { | |
|                         name: reference.identifier.name | |
|                     } | |
|                 }); | |
|             }); | |
|         } | |
| 
 | |
|         /** | |
|          * Finds and reports references that are non initializer and writable. | |
|          * @param {Variable} variable A variable to check. | |
|          * @returns {void} | |
|          */ | |
|         function checkVariable(variable) { | |
|             if (variable.defs[0].type === "FunctionName") { | |
|                 checkReference(variable.references); | |
|             } | |
|         } | |
| 
 | |
|         /** | |
|          * Checks parameters of a given function node. | |
|          * @param {ASTNode} node A function node to check. | |
|          * @returns {void} | |
|          */ | |
|         function checkForFunction(node) { | |
|             sourceCode.getDeclaredVariables(node).forEach(checkVariable); | |
|         } | |
| 
 | |
|         return { | |
|             FunctionDeclaration: checkForFunction, | |
|             FunctionExpression: checkForFunction | |
|         }; | |
|     } | |
| };
 |