requireDescriptionCompleteSentence: To detect and ignore HTML content

kepta · qfox · commit ecc73da88614 · 2016-03-22T16:15:22.000+03:00
This rule has been flagging comments with html tags.
In this patch the html is sanitized with *** so that it doesn't
interfere with the regular regex tests. The htmlSanitizer function
is padding all strings with 'x.' so that RE_NEW_LINE_START_WITH_UPPER_CASE
doesnt fail. This will need to be improved after discussing with owner if he/she
thinks so.

Fixes #2056
diff --git a/lib/rules/validate-jsdoc/require-description-complete-sentence.js b/lib/rules/validate-jsdoc/require-description-complete-sentence.js
@@ -56,6 +56,10 @@ function requireDescriptionCompleteSentence(node, err) {
         .replace(/(`)([^`]+)\1/, quotedSanitizer)
         .replace(/(')([^']+)\1/, quotedSanitizer)
         .replace(/(")([^"]+)\1/, quotedSanitizer)
+        // sanitize HTML tags which close
+        .replace(/<([^ >]+)[^>]*>[\s\S]*?.*?<\/\1>|<[^\/]+\/>/g, htmlSanitizer)
+        // sanitize self-closing HTML tags eg <br>
+        .replace(/<([^ >]+)[^>]*>/g, htmlSanitizer)
         .replace(/\{([^}]+)\}/, function(_, m) {
             return '{' + (new Array(m.length + 1)).join('*') + '}';
         })
@@ -179,3 +183,19 @@ function quotedSanitizer(_, q, m) {
     var endsWithDot = /\.\s*$/.test(m);
     return q + (new Array(m.length + (endsWithDot ? 0 : 1))).join('*') + q + (endsWithDot ? '.' : '');
 }
+
+/**
+ * HTML part sanitizer.
+ * To prevent RE_NEW_LINE_START_WITH_UPPER_CASE
+ * return string will padded by 'x.'
+ *
+ * @private
+ * @param {string} _ - Full matched string
+ * @returns {string} - Sanitized string
+ */
+function htmlSanitizer(_) {
+  return _.split('').map(function(token, iterator) {
+    if (iterator === _.length - 1) { return 'x.'}
+    return token === '\n' ? '\n' : '*';
+  }).join('');
+}
diff --git a/test/lib/rules/validate-jsdoc/require-description-complete-sentence.js b/test/lib/rules/validate-jsdoc/require-description-complete-sentence.js
@@ -232,6 +232,28 @@ describe('lib/rules/validate-jsdoc/require-description-complete-sentence', funct
                      */
                     function quux() {}
                 }
+            }, {
+                it: 'should not report sentences with html tags inside',
+                code: function () {
+                    /**
+                     * A foo is assigned the boolean value <p>true</p>.
+                     */
+                    function fun(p) {}
+                }
+            }, {
+                it: 'should not report sentences that are html code',
+                code: function () {
+                  /**
+                   * The html code here
+                   * <body>
+                   *  <p> Hello world!</p>
+                   * </body>
+                   * Should always be there.
+                   * And the first letter of this line is in
+                   * uppercase.
+                   */
+                  function fun(p) {}
+                }
             }
             /* jshint ignore:end */
         ]);
