123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230 |
- "use strict";
- /**
- * @license
- * Copyright 2016 Palantir Technologies, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
- Object.defineProperty(exports, "__esModule", { value: true });
- var tslib_1 = require("tslib");
- var tsutils_1 = require("tsutils");
- var ts = require("typescript");
- var Lint = require("../index");
- var Rule = /** @class */ (function (_super) {
- tslib_1.__extends(Rule, _super);
- function Rule() {
- return _super !== null && _super.apply(this, arguments) || this;
- }
- /* tslint:enable:object-literal-sort-keys */
- Rule.FAILURE_STRING = function (name, message) {
- return name + " is deprecated" + (message === "" ? "." : ": " + message.trim());
- };
- Rule.prototype.applyWithProgram = function (sourceFile, program) {
- return this.applyWithFunction(sourceFile, walk, undefined, program.getTypeChecker());
- };
- /* tslint:disable:object-literal-sort-keys */
- Rule.metadata = {
- ruleName: "deprecation",
- description: "Warns when deprecated APIs are used.",
- descriptionDetails: Lint.Utils.dedent(templateObject_1 || (templateObject_1 = tslib_1.__makeTemplateObject(["Any usage of an identifier\n with the @deprecated JSDoc annotation will trigger a warning.\n See http://usejsdoc.org/tags-deprecated.html"], ["Any usage of an identifier\n with the @deprecated JSDoc annotation will trigger a warning.\n See http://usejsdoc.org/tags-deprecated.html"]))),
- rationale: "Deprecated APIs should be avoided, and usage updated.",
- optionsDescription: "",
- options: null,
- optionExamples: [true],
- type: "maintainability",
- typescriptOnly: false,
- requiresTypeInfo: true,
- };
- return Rule;
- }(Lint.Rules.TypedRule));
- exports.Rule = Rule;
- function walk(ctx, tc) {
- return ts.forEachChild(ctx.sourceFile, function cb(node) {
- if (tsutils_1.isIdentifier(node)) {
- if (!isDeclaration(node)) {
- var deprecation = getDeprecation(node, tc);
- if (deprecation !== undefined) {
- ctx.addFailureAtNode(node, Rule.FAILURE_STRING(node.text, deprecation));
- }
- }
- }
- else {
- switch (node.kind) {
- case ts.SyntaxKind.ImportDeclaration:
- case ts.SyntaxKind.ImportEqualsDeclaration:
- case ts.SyntaxKind.ExportDeclaration:
- case ts.SyntaxKind.ExportAssignment:
- return;
- }
- return ts.forEachChild(node, cb);
- }
- });
- }
- function isDeclaration(identifier) {
- var parent = identifier.parent;
- switch (parent.kind) {
- case ts.SyntaxKind.ClassDeclaration:
- case ts.SyntaxKind.ClassExpression:
- case ts.SyntaxKind.InterfaceDeclaration:
- case ts.SyntaxKind.TypeParameter:
- case ts.SyntaxKind.FunctionExpression:
- case ts.SyntaxKind.FunctionDeclaration:
- case ts.SyntaxKind.LabeledStatement:
- case ts.SyntaxKind.JsxAttribute:
- case ts.SyntaxKind.MethodDeclaration:
- case ts.SyntaxKind.MethodSignature:
- case ts.SyntaxKind.PropertySignature:
- case ts.SyntaxKind.TypeAliasDeclaration:
- case ts.SyntaxKind.GetAccessor:
- case ts.SyntaxKind.SetAccessor:
- case ts.SyntaxKind.EnumDeclaration:
- case ts.SyntaxKind.ModuleDeclaration:
- return true;
- case ts.SyntaxKind.VariableDeclaration:
- case ts.SyntaxKind.Parameter:
- case ts.SyntaxKind.PropertyDeclaration:
- case ts.SyntaxKind.EnumMember:
- case ts.SyntaxKind.ImportEqualsDeclaration:
- return parent.name === identifier;
- case ts.SyntaxKind.PropertyAssignment:
- return parent.name === identifier &&
- !tsutils_1.isReassignmentTarget(identifier.parent.parent);
- case ts.SyntaxKind.BindingElement:
- // return true for `b` in `const {a: b} = obj"`
- return parent.name === identifier &&
- parent.propertyName !== undefined;
- default:
- return false;
- }
- }
- function getCallExpresion(node) {
- var parent = node.parent;
- if (tsutils_1.isPropertyAccessExpression(parent) && parent.name === node) {
- node = parent;
- parent = node.parent;
- }
- return tsutils_1.isTaggedTemplateExpression(parent) || (tsutils_1.isCallExpression(parent) || tsutils_1.isNewExpression(parent)) && parent.expression === node
- ? parent
- : undefined;
- }
- function getDeprecation(node, tc) {
- var callExpression = getCallExpresion(node);
- if (callExpression !== undefined) {
- var result = getSignatureDeprecation(tc.getResolvedSignature(callExpression));
- if (result !== undefined) {
- return result;
- }
- }
- var symbol;
- var parent = node.parent;
- if (parent.kind === ts.SyntaxKind.BindingElement) {
- symbol = tc.getTypeAtLocation(parent.parent).getProperty(node.text);
- }
- else if (tsutils_1.isPropertyAssignment(parent) && parent.name === node ||
- tsutils_1.isShorthandPropertyAssignment(parent) && parent.name === node && tsutils_1.isReassignmentTarget(node)) {
- symbol = tc.getPropertySymbolOfDestructuringAssignment(node);
- }
- else {
- symbol = tc.getSymbolAtLocation(node);
- }
- if (symbol !== undefined && tsutils_1.isSymbolFlagSet(symbol, ts.SymbolFlags.Alias)) {
- symbol = tc.getAliasedSymbol(symbol);
- }
- if (symbol === undefined ||
- // if this is a CallExpression and the declaration is a function or method,
- // stop here to avoid collecting JsDoc of all overload signatures
- callExpression !== undefined && isFunctionOrMethod(symbol.declarations)) {
- return undefined;
- }
- return getSymbolDeprecation(symbol);
- }
- function findDeprecationTag(tags) {
- for (var _i = 0, tags_1 = tags; _i < tags_1.length; _i++) {
- var tag = tags_1[_i];
- if (tag.name === "deprecated") {
- return tag.text === undefined ? "" : tag.text;
- }
- }
- return undefined;
- }
- function getSymbolDeprecation(symbol) {
- if (symbol.getJsDocTags !== undefined) {
- return findDeprecationTag(symbol.getJsDocTags());
- }
- // for compatibility with typescript@<2.3.0
- return getDeprecationFromDeclarations(symbol.declarations);
- }
- function getSignatureDeprecation(signature) {
- if (signature === undefined) {
- return undefined;
- }
- if (signature.getJsDocTags !== undefined) {
- return findDeprecationTag(signature.getJsDocTags());
- }
- // for compatibility with typescript@<2.3.0
- return signature.declaration === undefined ? undefined : getDeprecationFromDeclaration(signature.declaration);
- }
- function getDeprecationFromDeclarations(declarations) {
- if (declarations === undefined) {
- return undefined;
- }
- var declaration;
- for (var _i = 0, declarations_1 = declarations; _i < declarations_1.length; _i++) {
- declaration = declarations_1[_i];
- if (tsutils_1.isBindingElement(declaration)) {
- declaration = tsutils_1.getDeclarationOfBindingElement(declaration);
- }
- if (tsutils_1.isVariableDeclaration(declaration)) {
- declaration = declaration.parent;
- }
- if (tsutils_1.isVariableDeclarationList(declaration)) {
- declaration = declaration.parent;
- }
- var result = getDeprecationFromDeclaration(declaration);
- if (result !== undefined) {
- return result;
- }
- }
- return undefined;
- }
- function getDeprecationFromDeclaration(declaration) {
- for (var _i = 0, _a = tsutils_1.getJsDoc(declaration); _i < _a.length; _i++) {
- var comment = _a[_i];
- if (comment.tags === undefined) {
- continue;
- }
- for (var _b = 0, _c = comment.tags; _b < _c.length; _b++) {
- var tag = _c[_b];
- if (tag.tagName.text === "deprecated") {
- return tag.comment === undefined ? "" : tag.comment;
- }
- }
- }
- return undefined;
- }
- function isFunctionOrMethod(declarations) {
- if (declarations === undefined || declarations.length === 0) {
- return false;
- }
- switch (declarations[0].kind) {
- case ts.SyntaxKind.MethodDeclaration:
- case ts.SyntaxKind.FunctionDeclaration:
- case ts.SyntaxKind.FunctionExpression:
- case ts.SyntaxKind.MethodSignature:
- return true;
- default:
- return false;
- }
- }
- var templateObject_1;
|