1 | "use strict";
|
2 | var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
3 | if (k2 === undefined) k2 = k;
|
4 | Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
|
5 | }) : (function(o, m, k, k2) {
|
6 | if (k2 === undefined) k2 = k;
|
7 | o[k2] = m[k];
|
8 | }));
|
9 | var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
10 | Object.defineProperty(o, "default", { enumerable: true, value: v });
|
11 | }) : function(o, v) {
|
12 | o["default"] = v;
|
13 | });
|
14 | var __importStar = (this && this.__importStar) || function (mod) {
|
15 | if (mod && mod.__esModule) return mod;
|
16 | var result = {};
|
17 | if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
|
18 | __setModuleDefault(result, mod);
|
19 | return result;
|
20 | };
|
21 | Object.defineProperty(exports, "__esModule", { value: true });
|
22 | const utils_1 = require("@typescript-eslint/utils");
|
23 | const util = __importStar(require("../util"));
|
24 | exports.default = util.createRule({
|
25 | name: 'prefer-readonly-parameter-types',
|
26 | meta: {
|
27 | type: 'suggestion',
|
28 | docs: {
|
29 | description: 'Requires that function parameters are typed as readonly to prevent accidental mutation of inputs',
|
30 | recommended: false,
|
31 | requiresTypeChecking: true,
|
32 | },
|
33 | schema: [
|
34 | {
|
35 | type: 'object',
|
36 | additionalProperties: false,
|
37 | properties: Object.assign({ checkParameterProperties: {
|
38 | type: 'boolean',
|
39 | }, ignoreInferredTypes: {
|
40 | type: 'boolean',
|
41 | } }, util.readonlynessOptionsSchema.properties),
|
42 | },
|
43 | ],
|
44 | messages: {
|
45 | shouldBeReadonly: 'Parameter should be a read only type.',
|
46 | },
|
47 | },
|
48 | defaultOptions: [
|
49 | Object.assign({ checkParameterProperties: true, ignoreInferredTypes: false }, util.readonlynessOptionsDefaults),
|
50 | ],
|
51 | create(context, [{ checkParameterProperties, ignoreInferredTypes, treatMethodsAsReadonly }]) {
|
52 | const { esTreeNodeToTSNodeMap, program } = util.getParserServices(context);
|
53 | const checker = program.getTypeChecker();
|
54 | return {
|
55 | [[
|
56 | utils_1.AST_NODE_TYPES.ArrowFunctionExpression,
|
57 | utils_1.AST_NODE_TYPES.FunctionDeclaration,
|
58 | utils_1.AST_NODE_TYPES.FunctionExpression,
|
59 | utils_1.AST_NODE_TYPES.TSCallSignatureDeclaration,
|
60 | utils_1.AST_NODE_TYPES.TSConstructSignatureDeclaration,
|
61 | utils_1.AST_NODE_TYPES.TSDeclareFunction,
|
62 | utils_1.AST_NODE_TYPES.TSEmptyBodyFunctionExpression,
|
63 | utils_1.AST_NODE_TYPES.TSFunctionType,
|
64 | utils_1.AST_NODE_TYPES.TSMethodSignature,
|
65 | ].join(', ')](node) {
|
66 | for (const param of node.params) {
|
67 | if (!checkParameterProperties &&
|
68 | param.type === utils_1.AST_NODE_TYPES.TSParameterProperty) {
|
69 | continue;
|
70 | }
|
71 | const actualParam = param.type === utils_1.AST_NODE_TYPES.TSParameterProperty
|
72 | ? param.parameter
|
73 | : param;
|
74 | if (ignoreInferredTypes && actualParam.typeAnnotation == null) {
|
75 | continue;
|
76 | }
|
77 | const tsNode = esTreeNodeToTSNodeMap.get(actualParam);
|
78 | const type = checker.getTypeAtLocation(tsNode);
|
79 | const isReadOnly = util.isTypeReadonly(checker, type, {
|
80 | treatMethodsAsReadonly: treatMethodsAsReadonly,
|
81 | });
|
82 | if (!isReadOnly) {
|
83 | context.report({
|
84 | node: actualParam,
|
85 | messageId: 'shouldBeReadonly',
|
86 | });
|
87 | }
|
88 | }
|
89 | },
|
90 | };
|
91 | },
|
92 | });
|
93 |
|
\ | No newline at end of file |