247 lines
12 KiB
Plaintext
247 lines
12 KiB
Plaintext
|
"use strict";
|
||
|
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
||
|
if (k2 === undefined) k2 = k;
|
||
|
var desc = Object.getOwnPropertyDescriptor(m, k);
|
||
|
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
||
|
desc = { enumerable: true, get: function() { return m[k]; } };
|
||
|
}
|
||
|
Object.defineProperty(o, k2, desc);
|
||
|
}) : (function(o, m, k, k2) {
|
||
|
if (k2 === undefined) k2 = k;
|
||
|
o[k2] = m[k];
|
||
|
}));
|
||
|
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
||
|
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
||
|
}) : function(o, v) {
|
||
|
o["default"] = v;
|
||
|
});
|
||
|
var __importStar = (this && this.__importStar) || function (mod) {
|
||
|
if (mod && mod.__esModule) return mod;
|
||
|
var result = {};
|
||
|
if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
|
||
|
__setModuleDefault(result, mod);
|
||
|
return result;
|
||
|
};
|
||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||
|
const utils_1 = require("@typescript-eslint/utils");
|
||
|
const eslint_utils_1 = require("@typescript-eslint/utils/eslint-utils");
|
||
|
const tsutils = __importStar(require("ts-api-utils"));
|
||
|
const ts = __importStar(require("typescript"));
|
||
|
const util_1 = require("../util");
|
||
|
exports.default = (0, util_1.createRule)({
|
||
|
name: 'no-unnecessary-type-assertion',
|
||
|
meta: {
|
||
|
docs: {
|
||
|
description: 'Disallow type assertions that do not change the type of an expression',
|
||
|
recommended: 'recommended',
|
||
|
requiresTypeChecking: true,
|
||
|
},
|
||
|
fixable: 'code',
|
||
|
messages: {
|
||
|
unnecessaryAssertion: 'This assertion is unnecessary since it does not change the type of the expression.',
|
||
|
contextuallyUnnecessary: 'This assertion is unnecessary since the receiver accepts the original type of the expression.',
|
||
|
},
|
||
|
schema: [
|
||
|
{
|
||
|
type: 'object',
|
||
|
additionalProperties: false,
|
||
|
properties: {
|
||
|
typesToIgnore: {
|
||
|
description: 'A list of type names to ignore.',
|
||
|
type: 'array',
|
||
|
items: {
|
||
|
type: 'string',
|
||
|
},
|
||
|
},
|
||
|
},
|
||
|
},
|
||
|
],
|
||
|
type: 'suggestion',
|
||
|
},
|
||
|
defaultOptions: [{}],
|
||
|
create(context, [options]) {
|
||
|
const sourceCode = (0, eslint_utils_1.getSourceCode)(context);
|
||
|
const services = (0, util_1.getParserServices)(context);
|
||
|
const checker = services.program.getTypeChecker();
|
||
|
const compilerOptions = services.program.getCompilerOptions();
|
||
|
/**
|
||
|
* Sometimes tuple types don't have ObjectFlags.Tuple set, like when they're being matched against an inferred type.
|
||
|
* So, in addition, check if there are integer properties 0..n and no other numeric keys
|
||
|
*/
|
||
|
function couldBeTupleType(type) {
|
||
|
const properties = type.getProperties();
|
||
|
if (properties.length === 0) {
|
||
|
return false;
|
||
|
}
|
||
|
let i = 0;
|
||
|
for (; i < properties.length; ++i) {
|
||
|
const name = properties[i].name;
|
||
|
if (String(i) !== name) {
|
||
|
if (i === 0) {
|
||
|
// if there are no integer properties, this is not a tuple
|
||
|
return false;
|
||
|
}
|
||
|
break;
|
||
|
}
|
||
|
}
|
||
|
for (; i < properties.length; ++i) {
|
||
|
if (String(+properties[i].name) === properties[i].name) {
|
||
|
return false; // if there are any other numeric properties, this is not a tuple
|
||
|
}
|
||
|
}
|
||
|
return true;
|
||
|
}
|
||
|
/**
|
||
|
* Returns true if there's a chance the variable has been used before a value has been assigned to it
|
||
|
*/
|
||
|
function isPossiblyUsedBeforeAssigned(node) {
|
||
|
const declaration = (0, util_1.getDeclaration)(services, node);
|
||
|
if (!declaration) {
|
||
|
// don't know what the declaration is for some reason, so just assume the worst
|
||
|
return true;
|
||
|
}
|
||
|
if (
|
||
|
// non-strict mode doesn't care about used before assigned errors
|
||
|
tsutils.isStrictCompilerOptionEnabled(compilerOptions, 'strictNullChecks') &&
|
||
|
// ignore class properties as they are compile time guarded
|
||
|
// also ignore function arguments as they can't be used before defined
|
||
|
ts.isVariableDeclaration(declaration) &&
|
||
|
// is it `const x!: number`
|
||
|
declaration.initializer === undefined &&
|
||
|
declaration.exclamationToken === undefined &&
|
||
|
declaration.type !== undefined) {
|
||
|
// check if the defined variable type has changed since assignment
|
||
|
const declarationType = checker.getTypeFromTypeNode(declaration.type);
|
||
|
const type = (0, util_1.getConstrainedTypeAtLocation)(services, node);
|
||
|
if (declarationType === type) {
|
||
|
// possibly used before assigned, so just skip it
|
||
|
// better to false negative and skip it, than false positive and fix to compile erroring code
|
||
|
//
|
||
|
// no better way to figure this out right now
|
||
|
// https://github.com/Microsoft/TypeScript/issues/31124
|
||
|
return true;
|
||
|
}
|
||
|
}
|
||
|
return false;
|
||
|
}
|
||
|
function isConstAssertion(node) {
|
||
|
return (node.type === utils_1.AST_NODE_TYPES.TSTypeReference &&
|
||
|
node.typeName.type === utils_1.AST_NODE_TYPES.Identifier &&
|
||
|
node.typeName.name === 'const');
|
||
|
}
|
||
|
return {
|
||
|
TSNonNullExpression(node) {
|
||
|
if (node.parent.type === utils_1.AST_NODE_TYPES.AssignmentExpression &&
|
||
|
node.parent.operator === '=') {
|
||
|
if (node.parent.left === node) {
|
||
|
context.report({
|
||
|
node,
|
||
|
messageId: 'contextuallyUnnecessary',
|
||
|
fix(fixer) {
|
||
|
return fixer.removeRange([
|
||
|
node.expression.range[1],
|
||
|
node.range[1],
|
||
|
]);
|
||
|
},
|
||
|
});
|
||
|
}
|
||
|
// for all other = assignments we ignore non-null checks
|
||
|
// this is because non-null assertions can change the type-flow of the code
|
||
|
// so whilst they might be unnecessary for the assignment - they are necessary
|
||
|
// for following code
|
||
|
return;
|
||
|
}
|
||
|
const originalNode = services.esTreeNodeToTSNodeMap.get(node);
|
||
|
const type = (0, util_1.getConstrainedTypeAtLocation)(services, node.expression);
|
||
|
if (!(0, util_1.isNullableType)(type)) {
|
||
|
if (node.expression.type === utils_1.AST_NODE_TYPES.Identifier &&
|
||
|
isPossiblyUsedBeforeAssigned(node.expression)) {
|
||
|
return;
|
||
|
}
|
||
|
context.report({
|
||
|
node,
|
||
|
messageId: 'unnecessaryAssertion',
|
||
|
fix(fixer) {
|
||
|
return fixer.removeRange([node.range[1] - 1, node.range[1]]);
|
||
|
},
|
||
|
});
|
||
|
}
|
||
|
else {
|
||
|
// we know it's a nullable type
|
||
|
// so figure out if the variable is used in a place that accepts nullable types
|
||
|
const contextualType = (0, util_1.getContextualType)(checker, originalNode);
|
||
|
if (contextualType) {
|
||
|
// in strict mode you can't assign null to undefined, so we have to make sure that
|
||
|
// the two types share a nullable type
|
||
|
const typeIncludesUndefined = (0, util_1.isTypeFlagSet)(type, ts.TypeFlags.Undefined);
|
||
|
const typeIncludesNull = (0, util_1.isTypeFlagSet)(type, ts.TypeFlags.Null);
|
||
|
const contextualTypeIncludesUndefined = (0, util_1.isTypeFlagSet)(contextualType, ts.TypeFlags.Undefined);
|
||
|
const contextualTypeIncludesNull = (0, util_1.isTypeFlagSet)(contextualType, ts.TypeFlags.Null);
|
||
|
// make sure that the parent accepts the same types
|
||
|
// i.e. assigning `string | null | undefined` to `string | undefined` is invalid
|
||
|
const isValidUndefined = typeIncludesUndefined
|
||
|
? contextualTypeIncludesUndefined
|
||
|
: true;
|
||
|
const isValidNull = typeIncludesNull
|
||
|
? contextualTypeIncludesNull
|
||
|
: true;
|
||
|
if (isValidUndefined && isValidNull) {
|
||
|
context.report({
|
||
|
node,
|
||
|
messageId: 'contextuallyUnnecessary',
|
||
|
fix(fixer) {
|
||
|
return fixer.removeRange([
|
||
|
node.expression.range[1],
|
||
|
node.range[1],
|
||
|
]);
|
||
|
},
|
||
|
});
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
},
|
||
|
'TSAsExpression, TSTypeAssertion'(node) {
|
||
|
if (options.typesToIgnore?.includes(sourceCode.getText(node.typeAnnotation)) ||
|
||
|
isConstAssertion(node.typeAnnotation)) {
|
||
|
return;
|
||
|
}
|
||
|
const castType = services.getTypeAtLocation(node);
|
||
|
if ((0, util_1.isTypeFlagSet)(castType, ts.TypeFlags.Literal) ||
|
||
|
(tsutils.isObjectType(castType) &&
|
||
|
(tsutils.isObjectFlagSet(castType, ts.ObjectFlags.Tuple) ||
|
||
|
couldBeTupleType(castType)))) {
|
||
|
// It's not always safe to remove a cast to a literal type or tuple
|
||
|
// type, as those types are sometimes widened without the cast.
|
||
|
return;
|
||
|
}
|
||
|
const uncastType = services.getTypeAtLocation(node.expression);
|
||
|
if (uncastType === castType) {
|
||
|
context.report({
|
||
|
node,
|
||
|
messageId: 'unnecessaryAssertion',
|
||
|
fix(fixer) {
|
||
|
if (node.type === utils_1.AST_NODE_TYPES.TSTypeAssertion) {
|
||
|
const closingAngleBracket = sourceCode.getTokenAfter(node.typeAnnotation);
|
||
|
return closingAngleBracket?.value === '>'
|
||
|
? fixer.removeRange([
|
||
|
node.range[0],
|
||
|
closingAngleBracket.range[1],
|
||
|
])
|
||
|
: null;
|
||
|
}
|
||
|
return fixer.removeRange([
|
||
|
node.expression.range[1] +
|
||
|
(node.expression.type === utils_1.AST_NODE_TYPES.CallExpression
|
||
|
? 0
|
||
|
: 1),
|
||
|
node.range[1],
|
||
|
]);
|
||
|
},
|
||
|
});
|
||
|
}
|
||
|
// TODO - add contextually unnecessary check for this
|
||
|
},
|
||
|
};
|
||
|
},
|
||
|
});
|
||
|
//# sourceMappingURL=no-unnecessary-type-assertion.js.map
|