123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330 |
- "use strict";
- /**
- * @license
- * Copyright 2013 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 utils = require("tsutils");
- var ts = require("typescript");
- var Lint = require("../index");
- var OPTION_ALWAYS = "always";
- var OPTION_NEVER = "never";
- var OPTION_IGNORE_BOUND_CLASS_METHODS = "ignore-bound-class-methods";
- var OPTION_STRICT_BOUND_CLASS_METHODS = "strict-bound-class-methods";
- var OPTION_IGNORE_INTERFACES = "ignore-interfaces";
- var Rule = /** @class */ (function (_super) {
- tslib_1.__extends(Rule, _super);
- function Rule() {
- return _super !== null && _super.apply(this, arguments) || this;
- }
- Rule.prototype.apply = function (sourceFile) {
- var options = {
- boundClassMethods: this.ruleArguments.indexOf(OPTION_STRICT_BOUND_CLASS_METHODS) !== -1
- ? 2 /* Strict */
- : this.ruleArguments.indexOf(OPTION_IGNORE_BOUND_CLASS_METHODS) !== -1
- ? 1 /* Ignore */
- : 0 /* Default */,
- interfaces: this.ruleArguments.indexOf(OPTION_IGNORE_INTERFACES) === -1,
- };
- var Walker = this.ruleArguments.indexOf(OPTION_NEVER) === -1 ? SemicolonAlwaysWalker : SemicolonNeverWalker;
- return this.applyWithWalker(new Walker(sourceFile, this.ruleName, options));
- };
- /* tslint:disable:object-literal-sort-keys */
- Rule.metadata = {
- ruleName: "semicolon",
- description: "Enforces consistent semicolon usage at the end of every statement.",
- hasFix: true,
- optionsDescription: Lint.Utils.dedent(templateObject_1 || (templateObject_1 = tslib_1.__makeTemplateObject(["\n One of the following arguments must be provided:\n\n * `\"", "\"` enforces semicolons at the end of every statement.\n * `\"", "\"` disallows semicolons at the end of every statement except for when they are necessary.\n\n The following arguments may be optionally provided:\n\n * `\"", "\"` skips checking semicolons at the end of interface members.\n * `\"", "\"` skips checking semicolons at the end of bound class methods.\n * `\"", "\"` disables any special handling of bound class methods and treats them as any\n other assignment. This option overrides `\"", "\"`.\n "], ["\n One of the following arguments must be provided:\n\n * \\`\"", "\"\\` enforces semicolons at the end of every statement.\n * \\`\"", "\"\\` disallows semicolons at the end of every statement except for when they are necessary.\n\n The following arguments may be optionally provided:\n\n * \\`\"", "\"\\` skips checking semicolons at the end of interface members.\n * \\`\"", "\"\\` skips checking semicolons at the end of bound class methods.\n * \\`\"", "\"\\` disables any special handling of bound class methods and treats them as any\n other assignment. This option overrides \\`\"", "\"\\`.\n "])), OPTION_ALWAYS, OPTION_NEVER, OPTION_IGNORE_INTERFACES, OPTION_IGNORE_BOUND_CLASS_METHODS, OPTION_STRICT_BOUND_CLASS_METHODS, OPTION_IGNORE_BOUND_CLASS_METHODS),
- options: {
- type: "array",
- items: [
- {
- type: "string",
- enum: [OPTION_ALWAYS, OPTION_NEVER],
- },
- {
- type: "string",
- enum: [OPTION_IGNORE_INTERFACES],
- },
- ],
- additionalItems: false,
- },
- optionExamples: [
- [true, OPTION_ALWAYS],
- [true, OPTION_NEVER],
- [true, OPTION_ALWAYS, OPTION_IGNORE_INTERFACES],
- [true, OPTION_ALWAYS, OPTION_IGNORE_BOUND_CLASS_METHODS],
- ],
- type: "style",
- typescriptOnly: false,
- };
- /* tslint:enable:object-literal-sort-keys */
- Rule.FAILURE_STRING_MISSING = "Missing semicolon";
- Rule.FAILURE_STRING_COMMA = "Properties should be separated by semicolons";
- Rule.FAILURE_STRING_UNNECESSARY = "Unnecessary semicolon";
- return Rule;
- }(Lint.Rules.AbstractRule));
- exports.Rule = Rule;
- var SemicolonWalker = /** @class */ (function (_super) {
- tslib_1.__extends(SemicolonWalker, _super);
- function SemicolonWalker() {
- return _super !== null && _super.apply(this, arguments) || this;
- }
- SemicolonWalker.prototype.walk = function (sourceFile) {
- var _this = this;
- var cb = function (node) {
- _this.visitNode(node);
- return ts.forEachChild(node, cb);
- };
- return ts.forEachChild(sourceFile, cb);
- };
- SemicolonWalker.prototype.visitNode = function (node) {
- switch (node.kind) {
- case ts.SyntaxKind.SemicolonClassElement:
- return this.reportUnnecessary(node.end);
- case ts.SyntaxKind.EmptyStatement:
- return this.checkEmptyStatement(node);
- case ts.SyntaxKind.PropertyDeclaration:
- return this.visitPropertyDeclaration(node);
- }
- };
- SemicolonWalker.prototype.reportUnnecessary = function (pos, noFix) {
- this.addFailure(pos - 1, pos, Rule.FAILURE_STRING_UNNECESSARY, noFix ? undefined : Lint.Replacement.deleteText(pos - 1, 1));
- };
- SemicolonWalker.prototype.checkSemicolonOrLineBreak = function (node) {
- if (this.sourceFile.text[node.end - 1] !== ";") {
- return;
- }
- var nextToken = utils.getNextToken(node, this.sourceFile);
- switch (nextToken.kind) {
- case ts.SyntaxKind.EndOfFileToken:
- case ts.SyntaxKind.CloseBraceToken:
- return this.reportUnnecessary(node.end);
- default:
- if (!utils.isSameLine(this.sourceFile, node.end, nextToken.end)) {
- this.reportUnnecessary(node.end);
- }
- }
- };
- SemicolonWalker.prototype.checkUnnecessary = function (node) {
- if (this.sourceFile.text[node.end - 1] !== ";") {
- return;
- }
- var lastToken = utils.getPreviousToken(node.getLastToken(this.sourceFile), this.sourceFile);
- // yield does not continue on the next line if there is no yielded expression
- if (lastToken.kind === ts.SyntaxKind.YieldKeyword && lastToken.parent.kind === ts.SyntaxKind.YieldExpression ||
- // arrow functions with block as body don't continue on the next line
- lastToken.kind === ts.SyntaxKind.CloseBraceToken && lastToken.parent.kind === ts.SyntaxKind.Block &&
- lastToken.parent.parent.kind === ts.SyntaxKind.ArrowFunction) {
- return this.checkSemicolonOrLineBreak(node);
- }
- var nextToken = utils.getNextToken(node, this.sourceFile);
- switch (nextToken.kind) {
- case ts.SyntaxKind.OpenParenToken:
- case ts.SyntaxKind.OpenBracketToken:
- case ts.SyntaxKind.PlusToken:
- case ts.SyntaxKind.MinusToken:
- case ts.SyntaxKind.RegularExpressionLiteral:
- case ts.SyntaxKind.LessThanToken:
- case ts.SyntaxKind.NoSubstitutionTemplateLiteral:
- case ts.SyntaxKind.TemplateHead:
- break;
- case ts.SyntaxKind.CloseBraceToken:
- case ts.SyntaxKind.EndOfFileToken:
- return this.reportUnnecessary(node.end);
- default:
- if (!utils.isSameLine(this.sourceFile, node.end, nextToken.end)) {
- this.reportUnnecessary(node.end);
- }
- }
- };
- SemicolonWalker.prototype.checkEmptyStatement = function (node) {
- // An empty statement is only ever useful when it is the only statement inside a loop
- if (!utils.isIterationStatement(node.parent)) {
- var parentKind = node.parent.kind;
- // don't remove empty statement if it is a direct child of if, with or a LabeledStatement
- // otherwise this would unintentionally change control flow
- var noFix = parentKind === ts.SyntaxKind.IfStatement ||
- parentKind === ts.SyntaxKind.LabeledStatement ||
- parentKind === ts.SyntaxKind.WithStatement;
- this.reportUnnecessary(node.end, noFix);
- }
- };
- SemicolonWalker.prototype.visitPropertyDeclaration = function (node) {
- // check if this is a multi-line arrow function
- if (this.options.boundClassMethods !== 2 /* Strict */ &&
- node.initializer !== undefined &&
- node.initializer.kind === ts.SyntaxKind.ArrowFunction &&
- !utils.isSameLine(this.sourceFile, node.getStart(this.sourceFile), node.end)) {
- if (this.options.boundClassMethods === 0 /* Default */) {
- this.checkUnnecessary(node);
- }
- }
- else {
- this.checkPropertyDeclaration(node);
- }
- };
- return SemicolonWalker;
- }(Lint.AbstractWalker));
- var SemicolonAlwaysWalker = /** @class */ (function (_super) {
- tslib_1.__extends(SemicolonAlwaysWalker, _super);
- function SemicolonAlwaysWalker() {
- return _super !== null && _super.apply(this, arguments) || this;
- }
- SemicolonAlwaysWalker.prototype.visitNode = function (node) {
- switch (node.kind) {
- case ts.SyntaxKind.VariableStatement:
- case ts.SyntaxKind.ExpressionStatement:
- case ts.SyntaxKind.ReturnStatement:
- case ts.SyntaxKind.BreakStatement:
- case ts.SyntaxKind.ContinueStatement:
- case ts.SyntaxKind.ThrowStatement:
- case ts.SyntaxKind.ImportEqualsDeclaration:
- case ts.SyntaxKind.DoStatement:
- case ts.SyntaxKind.ExportAssignment:
- case ts.SyntaxKind.TypeAliasDeclaration:
- case ts.SyntaxKind.ImportDeclaration:
- case ts.SyntaxKind.ExportDeclaration:
- case ts.SyntaxKind.DebuggerStatement:
- return this.checkMissing(node);
- case ts.SyntaxKind.ModuleDeclaration:
- case ts.SyntaxKind.MethodDeclaration:
- case ts.SyntaxKind.FunctionDeclaration:
- // check shorthand module declarations and method / function signatures
- if (node.body === undefined) {
- this.checkMissing(node);
- }
- break;
- case ts.SyntaxKind.InterfaceDeclaration:
- if (this.options.interfaces) {
- this.checkInterface(node);
- }
- break;
- default:
- return _super.prototype.visitNode.call(this, node);
- }
- };
- SemicolonAlwaysWalker.prototype.checkPropertyDeclaration = function (node) {
- return this.checkMissing(node);
- };
- SemicolonAlwaysWalker.prototype.checkMissing = function (node) {
- if (this.sourceFile.text[node.end - 1] !== ";") {
- this.reportMissing(node.end);
- }
- };
- SemicolonAlwaysWalker.prototype.reportMissing = function (pos) {
- this.addFailureAt(pos, 0, Rule.FAILURE_STRING_MISSING, Lint.Replacement.appendText(pos, ";"));
- };
- SemicolonAlwaysWalker.prototype.checkInterface = function (node) {
- for (var _i = 0, _a = node.members; _i < _a.length; _i++) {
- var member = _a[_i];
- switch (this.sourceFile.text[member.end - 1]) {
- case ";": break;
- case ",":
- this.addFailureAt(member.end - 1, 1, Rule.FAILURE_STRING_COMMA, new Lint.Replacement(member.end - 1, 1, ";"));
- break;
- default:
- this.reportMissing(member.end);
- }
- }
- };
- return SemicolonAlwaysWalker;
- }(SemicolonWalker));
- var SemicolonNeverWalker = /** @class */ (function (_super) {
- tslib_1.__extends(SemicolonNeverWalker, _super);
- function SemicolonNeverWalker() {
- return _super !== null && _super.apply(this, arguments) || this;
- }
- SemicolonNeverWalker.prototype.visitNode = function (node) {
- switch (node.kind) {
- case ts.SyntaxKind.ExpressionStatement:
- case ts.SyntaxKind.ThrowStatement:
- case ts.SyntaxKind.ExportAssignment:
- return this.checkUnnecessary(node);
- case ts.SyntaxKind.VariableStatement:
- return this.checkVariableStatement(node);
- case ts.SyntaxKind.ReturnStatement:
- if (node.expression === undefined) {
- // return does not continue on the next line if the is no returned expression
- return this.checkSemicolonOrLineBreak(node);
- }
- return this.checkUnnecessary(node);
- case ts.SyntaxKind.TypeAliasDeclaration:
- case ts.SyntaxKind.ImportEqualsDeclaration:
- case ts.SyntaxKind.ImportDeclaration:
- case ts.SyntaxKind.ExportDeclaration:
- case ts.SyntaxKind.DebuggerStatement:
- case ts.SyntaxKind.BreakStatement:
- case ts.SyntaxKind.ContinueStatement:
- case ts.SyntaxKind.DoStatement:
- return this.checkSemicolonOrLineBreak(node);
- case ts.SyntaxKind.ModuleDeclaration:
- // shorthand module declaration
- if (node.body === undefined) {
- this.checkShorthandModuleDeclaration(node);
- }
- break;
- case ts.SyntaxKind.MethodDeclaration:
- // check method signature
- if (node.body === undefined) {
- this.checkSemicolonOrLineBreak(node);
- }
- break;
- case ts.SyntaxKind.FunctionDeclaration:
- // check function signature
- if (node.body === undefined) {
- this.checkSemicolonOrLineBreak(node);
- }
- break;
- case ts.SyntaxKind.InterfaceDeclaration:
- if (this.options.interfaces) {
- this.checkInterface(node);
- }
- break;
- default:
- return _super.prototype.visitNode.call(this, node);
- }
- };
- SemicolonNeverWalker.prototype.checkPropertyDeclaration = function (node) {
- if (node.initializer === undefined) {
- return this.checkSemicolonOrLineBreak(node);
- }
- return this.checkUnnecessary(node);
- };
- SemicolonNeverWalker.prototype.checkVariableStatement = function (node) {
- var declarations = node.declarationList.declarations;
- if (declarations[declarations.length - 1].initializer === undefined) {
- // variable declaration does not continue on the next line if it has no initializer
- return this.checkSemicolonOrLineBreak(node);
- }
- return this.checkUnnecessary(node);
- };
- SemicolonNeverWalker.prototype.checkShorthandModuleDeclaration = function (node) {
- var nextStatement = utils.getNextStatement(node);
- if (nextStatement === undefined || nextStatement.kind !== ts.SyntaxKind.Block) {
- this.checkSemicolonOrLineBreak(node);
- }
- };
- SemicolonNeverWalker.prototype.checkInterface = function (node) {
- for (var _i = 0, _a = node.members; _i < _a.length; _i++) {
- var member = _a[_i];
- this.checkSemicolonOrLineBreak(member);
- }
- };
- return SemicolonNeverWalker;
- }(SemicolonWalker));
- var templateObject_1;
|