jsdocFormatRule.js 4.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788
  1. "use strict";
  2. var __extends = (this && this.__extends) || function (d, b) {
  3. for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p];
  4. function __() { this.constructor = d; }
  5. d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
  6. };
  7. var ts = require("typescript");
  8. var Lint = require("../lint");
  9. var Rule = (function (_super) {
  10. __extends(Rule, _super);
  11. function Rule() {
  12. _super.apply(this, arguments);
  13. }
  14. Rule.prototype.apply = function (sourceFile) {
  15. return this.applyWithWalker(new JsdocWalker(sourceFile, this.getOptions()));
  16. };
  17. Rule.ALIGNMENT_FAILURE_STRING = "asterisks in jsdoc must be aligned";
  18. Rule.FORMAT_FAILURE_STRING = "jsdoc is not formatted correctly on this line";
  19. return Rule;
  20. }(Lint.Rules.AbstractRule));
  21. exports.Rule = Rule;
  22. var JsdocWalker = (function (_super) {
  23. __extends(JsdocWalker, _super);
  24. function JsdocWalker() {
  25. _super.apply(this, arguments);
  26. }
  27. JsdocWalker.prototype.visitSourceFile = function (node) {
  28. var _this = this;
  29. _super.prototype.visitSourceFile.call(this, node);
  30. Lint.scanAllTokens(ts.createScanner(ts.ScriptTarget.ES5, false, ts.LanguageVariant.Standard, node.text), function (scanner) {
  31. var startPos = scanner.getStartPos();
  32. if (_this.tokensToSkipStartEndMap[startPos] != null) {
  33. scanner.setTextPos(_this.tokensToSkipStartEndMap[startPos]);
  34. return;
  35. }
  36. if (scanner.getToken() === ts.SyntaxKind.MultiLineCommentTrivia) {
  37. var commentText = scanner.getTokenText();
  38. var startPosition = scanner.getTokenPos();
  39. _this.findFailuresForJsdocComment(commentText, startPosition, node);
  40. }
  41. });
  42. };
  43. JsdocWalker.prototype.findFailuresForJsdocComment = function (commentText, startingPosition, sourceFile) {
  44. var currentPosition = startingPosition;
  45. var lines = commentText.split(/\r?\n/);
  46. var firstLine = lines[0];
  47. var jsdocPosition = currentPosition;
  48. var isJsdocMatch = firstLine.match(/^\s*\/\*\*/);
  49. if (isJsdocMatch != null) {
  50. if (lines.length === 1) {
  51. var firstLineMatch = firstLine.match(/^\s*\/\*\* (.* )?\*\/$/);
  52. if (firstLineMatch == null) {
  53. this.addFailureAt(jsdocPosition, firstLine.length, Rule.FORMAT_FAILURE_STRING);
  54. }
  55. return;
  56. }
  57. var indexToMatch = firstLine.indexOf("**") + sourceFile.getLineAndCharacterOfPosition(currentPosition).character;
  58. var otherLines = lines.splice(1, lines.length - 2);
  59. jsdocPosition += firstLine.length + 1;
  60. for (var _i = 0, otherLines_1 = otherLines; _i < otherLines_1.length; _i++) {
  61. var line = otherLines_1[_i];
  62. var asteriskMatch = line.match(/^\s*\*( |$)/);
  63. if (asteriskMatch == null) {
  64. this.addFailureAt(jsdocPosition, line.length, Rule.FORMAT_FAILURE_STRING);
  65. }
  66. var asteriskIndex = line.indexOf("*");
  67. if (asteriskIndex !== indexToMatch) {
  68. this.addFailureAt(jsdocPosition, line.length, Rule.ALIGNMENT_FAILURE_STRING);
  69. }
  70. jsdocPosition += line.length + 1;
  71. }
  72. var lastLine = lines[lines.length - 1];
  73. var endBlockCommentMatch = lastLine.match(/^\s*\*\/$/);
  74. if (endBlockCommentMatch == null) {
  75. this.addFailureAt(jsdocPosition, lastLine.length, Rule.FORMAT_FAILURE_STRING);
  76. }
  77. var lastAsteriskIndex = lastLine.indexOf("*");
  78. if (lastAsteriskIndex !== indexToMatch) {
  79. this.addFailureAt(jsdocPosition, lastLine.length, Rule.ALIGNMENT_FAILURE_STRING);
  80. }
  81. }
  82. };
  83. JsdocWalker.prototype.addFailureAt = function (currentPosition, width, failureString) {
  84. var failure = this.createFailure(currentPosition, width, failureString);
  85. this.addFailure(failure);
  86. };
  87. return JsdocWalker;
  88. }(Lint.SkippableTokenAwareRuleWalker));