mocha 5.1.1 → 6.0.0

package/lib/reporters/html.js

@@ -12,19 +12,19 @@ var Base = require('./base');
 var utils = require('../utils');
 var Progress = require('../browser/progress');
 var escapeRe = require('escape-string-regexp');
+var constants = require('../runner').constants;
+var EVENT_TEST_PASS = constants.EVENT_TEST_PASS;
+var EVENT_TEST_FAIL = constants.EVENT_TEST_FAIL;
+var EVENT_SUITE_BEGIN = constants.EVENT_SUITE_BEGIN;
+var EVENT_SUITE_END = constants.EVENT_SUITE_END;
+var EVENT_TEST_PENDING = constants.EVENT_TEST_PENDING;
 var escape = utils.escape;
 
 /**
  * Save timer references to avoid Sinon interfering (see GH-237).
  */
 
-/* eslint-disable no-unused-vars, no-native-reassign */
 var Date = global.Date;
-var setTimeout = global.setTimeout;
-var setInterval = global.setInterval;
-var clearTimeout = global.clearTimeout;
-var clearInterval = global.clearInterval;
-/* eslint-enable no-unused-vars, no-native-reassign */
 
 /**
  * Expose `HTML`.
@@ -36,7 +36,8 @@ exports = module.exports = HTML;
  * Stats template.
  */
 
-var statsTemplate = '<ul id="mocha-stats">' +
+var statsTemplate =
+  '<ul id="mocha-stats">' +
   '<li class="progress"><canvas width="40" height="40"></canvas></li>' +
   '<li class="passes"><a href="javascript:void(0);">passes:</a> <em>0</em></li>' +
   '<li class="failures"><a href="javascript:void(0);">failures:</a> <em>0</em></li>' +
@@ -52,10 +53,9 @@ var playIcon = '&#x2023;';
  * @class
  * @memberof Mocha.reporters
  * @extends Mocha.reporters.Base
- * @api public
  * @param {Runner} runner
  */
-function HTML (runner) {
+function HTML(runner) {
   Base.call(this, runner);
 
   var self = this;
@@ -90,10 +90,10 @@ function HTML (runner) {
   }
 
   // pass toggle
-  on(passesLink, 'click', function (evt) {
+  on(passesLink, 'click', function(evt) {
     evt.preventDefault();
     unhide();
-    var name = (/pass/).test(report.className) ? '' : ' pass';
+    var name = /pass/.test(report.className) ? '' : ' pass';
     report.className = report.className.replace(/fail|pass/g, '') + name;
     if (report.className.trim()) {
       hideSuitesWithout('test pass');
@@ -101,10 +101,10 @@ function HTML (runner) {
   });
 
   // failure toggle
-  on(failuresLink, 'click', function (evt) {
+  on(failuresLink, 'click', function(evt) {
     evt.preventDefault();
     unhide();
-    var name = (/fail/).test(report.className) ? '' : ' fail';
+    var name = /fail/.test(report.className) ? '' : ' fail';
     report.className = report.className.replace(/fail|pass/g, '') + name;
     if (report.className.trim()) {
       hideSuitesWithout('test fail');
@@ -118,14 +118,18 @@ function HTML (runner) {
     progress.size(40);
   }
 
-  runner.on('suite', function (suite) {
+  runner.on(EVENT_SUITE_BEGIN, function(suite) {
     if (suite.root) {
       return;
     }
 
     // suite
     var url = self.suiteURL(suite);
-    var el = fragment('<li class="suite"><h1><a href="%s">%s</a></h1></li>', url, escape(suite.title));
+    var el = fragment(
+      '<li class="suite"><h1><a href="%s">%s</a></h1></li>',
+      url,
+      escape(suite.title)
+    );
 
     // container
     stack[0].appendChild(el);
@@ -133,7 +137,7 @@ function HTML (runner) {
     el.appendChild(stack[0]);
   });
 
-  runner.on('suite end', function (suite) {
+  runner.on(EVENT_SUITE_END, function(suite) {
     if (suite.root) {
       updateStats();
       return;
@@ -141,19 +145,27 @@ function HTML (runner) {
     stack.shift();
   });
 
-  runner.on('pass', function (test) {
+  runner.on(EVENT_TEST_PASS, function(test) {
     var url = self.testURL(test);
-    var markup = '<li class="test pass %e"><h2>%e<span class="duration">%ems</span> ' +
-      '<a href="%s" class="replay">' + playIcon + '</a></h2></li>';
+    var markup =
+      '<li class="test pass %e"><h2>%e<span class="duration">%ems</span> ' +
+      '<a href="%s" class="replay">' +
+      playIcon +
+      '</a></h2></li>';
     var el = fragment(markup, test.speed, test.title, test.duration, url);
     self.addCodeToggle(el, test.body);
     appendToStack(el);
     updateStats();
   });
 
-  runner.on('fail', function (test) {
-    var el = fragment('<li class="test fail"><h2>%e <a href="%e" class="replay">' + playIcon + '</a></h2></li>',
-      test.title, self.testURL(test));
+  runner.on(EVENT_TEST_FAIL, function(test) {
+    var el = fragment(
+      '<li class="test fail"><h2>%e <a href="%e" class="replay">' +
+        playIcon +
+        '</a></h2></li>',
+      test.title,
+      self.testURL(test)
+    );
     var stackString; // Note: Includes leading newline
     var message = test.err.toString();
 
@@ -168,7 +180,9 @@ function HTML (runner) {
       if (indexOfMessage === -1) {
         stackString = test.err.stack;
       } else {
-        stackString = test.err.stack.substr(test.err.message.length + indexOfMessage);
+        stackString = test.err.stack.substr(
+          test.err.message.length + indexOfMessage
+        );
       }
     } else if (test.err.sourceURL && test.err.line !== undefined) {
       // Safari doesn't give you a stack. Let's at least provide a source line.
@@ -178,12 +192,21 @@ function HTML (runner) {
     stackString = stackString || '';
 
     if (test.err.htmlMessage && stackString) {
-      el.appendChild(fragment('<div class="html-error">%s\n<pre class="error">%e</pre></div>',
-        test.err.htmlMessage, stackString));
+      el.appendChild(
+        fragment(
+          '<div class="html-error">%s\n<pre class="error">%e</pre></div>',
+          test.err.htmlMessage,
+          stackString
+        )
+      );
     } else if (test.err.htmlMessage) {
-      el.appendChild(fragment('<div class="html-error">%s</div>', test.err.htmlMessage));
+      el.appendChild(
+        fragment('<div class="html-error">%s</div>', test.err.htmlMessage)
+      );
     } else {
-      el.appendChild(fragment('<pre class="error">%e%e</pre>', message, stackString));
+      el.appendChild(
+        fragment('<pre class="error">%e%e</pre>', message, stackString)
+      );
     }
 
     self.addCodeToggle(el, test.body);
@@ -191,22 +214,25 @@ function HTML (runner) {
     updateStats();
   });
 
-  runner.on('pending', function (test) {
-    var el = fragment('<li class="test pass pending"><h2>%e</h2></li>', test.title);
+  runner.on(EVENT_TEST_PENDING, function(test) {
+    var el = fragment(
+      '<li class="test pass pending"><h2>%e</h2></li>',
+      test.title
+    );
     appendToStack(el);
     updateStats();
   });
 
-  function appendToStack (el) {
+  function appendToStack(el) {
     // Don't call .appendChild if #mocha-report was already .shift()'ed off the stack.
     if (stack[0]) {
       stack[0].appendChild(el);
     }
   }
 
-  function updateStats () {
+  function updateStats() {
     // TODO: add to stats
-    var percent = stats.tests / runner.total * 100 | 0;
+    var percent = ((stats.tests / runner.total) * 100) | 0;
     if (progress) {
       progress.update(percent).draw(ctx);
     }
@@ -225,7 +251,7 @@ function HTML (runner) {
  * @param {string} s
  * @return {string} A new URL.
  */
-function makeUrl (s) {
+function makeUrl(s) {
   var search = window.location.search;
 
   // Remove previous grep query parameter if present
@@ -233,7 +259,12 @@ function makeUrl (s) {
     search = search.replace(/[?&]grep=[^&\s]*/g, '').replace(/^&/, '?');
   }
 
-  return window.location.pathname + (search ? search + '&' : '?') + 'grep=' + encodeURIComponent(escapeRe(s));
+  return (
+    window.location.pathname +
+    (search ? search + '&' : '?') +
+    'grep=' +
+    encodeURIComponent(escapeRe(s))
+  );
 }
 
 /**
@@ -241,7 +272,7 @@ function makeUrl (s) {
  *
  * @param {Object} [suite]
  */
-HTML.prototype.suiteURL = function (suite) {
+HTML.prototype.suiteURL = function(suite) {
   return makeUrl(suite.fullTitle());
 };
 
@@ -250,7 +281,7 @@ HTML.prototype.suiteURL = function (suite) {
  *
  * @param {Object} [test]
  */
-HTML.prototype.testURL = function (test) {
+HTML.prototype.testURL = function(test) {
   return makeUrl(test.fullTitle());
 };
 
@@ -260,10 +291,10 @@ HTML.prototype.testURL = function (test) {
  * @param {HTMLLIElement} el
  * @param {string} contents
  */
-HTML.prototype.addCodeToggle = function (el, contents) {
+HTML.prototype.addCodeToggle = function(el, contents) {
   var h2 = el.getElementsByTagName('h2')[0];
 
-  on(h2, 'click', function () {
+  on(h2, 'click', function() {
     pre.style.display = pre.style.display === 'none' ? 'block' : 'none';
   });
 
@@ -277,7 +308,7 @@ HTML.prototype.addCodeToggle = function (el, contents) {
  *
  * @param {string} msg
  */
-function error (msg) {
+function error(msg) {
   document.body.appendChild(fragment('<div id="mocha-error">%s</div>', msg));
 }
 
@@ -286,15 +317,17 @@ function error (msg) {
  *
  * @param {string} html
  */
-function fragment (html) {
+function fragment(html) {
   var args = arguments;
   var div = document.createElement('div');
   var i = 1;
 
-  div.innerHTML = html.replace(/%([se])/g, function (_, type) {
+  div.innerHTML = html.replace(/%([se])/g, function(_, type) {
     switch (type) {
-      case 's': return String(args[i++]);
-      case 'e': return escape(args[i++]);
+      case 's':
+        return String(args[i++]);
+      case 'e':
+        return escape(args[i++]);
       // no default
     }
   });
@@ -308,7 +341,7 @@ function fragment (html) {
  *
  * @param {text} classname
  */
-function hideSuitesWithout (classname) {
+function hideSuitesWithout(classname) {
   var suites = document.getElementsByClassName('suite');
   for (var i = 0; i < suites.length; i++) {
     var els = suites[i].getElementsByClassName(classname);
@@ -321,7 +354,7 @@ function hideSuitesWithout (classname) {
 /**
  * Unhide .hidden suites.
  */
-function unhide () {
+function unhide() {
   var els = document.getElementsByClassName('suite hidden');
   for (var i = 0; i < els.length; ++i) {
     els[i].className = els[i].className.replace('suite hidden', 'suite');
@@ -334,7 +367,7 @@ function unhide () {
  * @param {HTMLElement} el
  * @param {string} contents
  */
-function text (el, contents) {
+function text(el, contents) {
   if (el.textContent) {
     el.textContent = contents;
   } else {
@@ -345,10 +378,12 @@ function text (el, contents) {
 /**
  * Listen on `event` with callback `fn`.
  */
-function on (el, event, fn) {
+function on(el, event, fn) {
   if (el.addEventListener) {
     el.addEventListener(event, fn, false);
   } else {
     el.attachEvent('on' + event, fn);
   }
 }
+
+HTML.browserOnly = true;

package/lib/reporters/json-stream.js

@@ -7,59 +7,77 @@
  */
 
 var Base = require('./base');
+var constants = require('../runner').constants;
+var EVENT_TEST_PASS = constants.EVENT_TEST_PASS;
+var EVENT_TEST_FAIL = constants.EVENT_TEST_FAIL;
+var EVENT_RUN_BEGIN = constants.EVENT_RUN_BEGIN;
+var EVENT_RUN_END = constants.EVENT_RUN_END;
 
 /**
- * Expose `List`.
+ * Expose `JSONStream`.
  */
 
-exports = module.exports = List;
+exports = module.exports = JSONStream;
 
 /**
- * Initialize a new `JSONStream` test reporter.
+ * Constructs a new `JSONStream` reporter instance.
  *
  * @public
- * @name JSONStream
- * @class JSONStream
- * @memberof Mocha.reporters
+ * @class
  * @extends Mocha.reporters.Base
- * @api public
- * @param {Runner} runner
+ * @memberof Mocha.reporters
+ * @param {Runner} runner - Instance triggers reporter actions.
  */
-function List (runner) {
+function JSONStream(runner) {
   Base.call(this, runner);
 
   var self = this;
   var total = runner.total;
 
-  runner.on('start', function () {
-    console.log(JSON.stringify(['start', { total: total }]));
+  runner.once(EVENT_RUN_BEGIN, function() {
+    writeEvent(['start', {total: total}]);
   });
 
-  runner.on('pass', function (test) {
-    console.log(JSON.stringify(['pass', clean(test)]));
+  runner.on(EVENT_TEST_PASS, function(test) {
+    writeEvent(['pass', clean(test)]);
   });
 
-  runner.on('fail', function (test, err) {
+  runner.on(EVENT_TEST_FAIL, function(test, err) {
     test = clean(test);
     test.err = err.message;
     test.stack = err.stack || null;
-    console.log(JSON.stringify(['fail', test]));
+    writeEvent(['fail', test]);
   });
 
-  runner.once('end', function () {
-    process.stdout.write(JSON.stringify(['end', self.stats]));
+  runner.once(EVENT_RUN_END, function() {
+    writeEvent(['end', self.stats]);
   });
 }
 
 /**
- * Return a plain-object representation of `test`
- * free of cyclic properties etc.
+ * Mocha event to be written to the output stream.
+ * @typedef {Array} JSONStream~MochaEvent
+ */
+
+/**
+ * Writes Mocha event to reporter output stream.
  *
- * @api private
- * @param {Object} test
- * @return {Object}
+ * @private
+ * @param {JSONStream~MochaEvent} event - Mocha event to be output.
  */
-function clean (test) {
+function writeEvent(event) {
+  process.stdout.write(JSON.stringify(event) + '\n');
+}
+
+/**
+ * Returns an object literal representation of `test`
+ * free of cyclic properties, etc.
+ *
+ * @private
+ * @param {Test} test - Instance used as data source.
+ * @return {Object} object containing pared-down test instance data
+ */
+function clean(test) {
   return {
     title: test.title,
     fullTitle: test.fullTitle(),
@@ -67,3 +85,5 @@ function clean (test) {
     currentRetry: test.currentRetry()
   };
 }
+
+JSONStream.description = 'newline delimited JSON events';

package/lib/reporters/json.js

@@ -7,6 +7,12 @@
  */
 
 var Base = require('./base');
+var constants = require('../runner').constants;
+var EVENT_TEST_PASS = constants.EVENT_TEST_PASS;
+var EVENT_TEST_FAIL = constants.EVENT_TEST_FAIL;
+var EVENT_TEST_END = constants.EVENT_TEST_END;
+var EVENT_RUN_END = constants.EVENT_RUN_END;
+var EVENT_TEST_PENDING = constants.EVENT_TEST_PENDING;
 
 /**
  * Expose `JSON`.
@@ -21,10 +27,9 @@ exports = module.exports = JSONReporter;
  * @class JSON
  * @memberof Mocha.reporters
  * @extends Mocha.reporters.Base
- * @api public
  * @param {Runner} runner
  */
-function JSONReporter (runner) {
+function JSONReporter(runner) {
   Base.call(this, runner);
 
   var self = this;
@@ -33,23 +38,23 @@ function JSONReporter (runner) {
   var failures = [];
   var passes = [];
 
-  runner.on('test end', function (test) {
+  runner.on(EVENT_TEST_END, function(test) {
     tests.push(test);
   });
 
-  runner.on('pass', function (test) {
+  runner.on(EVENT_TEST_PASS, function(test) {
     passes.push(test);
   });
 
-  runner.on('fail', function (test) {
+  runner.on(EVENT_TEST_FAIL, function(test) {
     failures.push(test);
   });
 
-  runner.on('pending', function (test) {
+  runner.on(EVENT_TEST_PENDING, function(test) {
     pending.push(test);
   });
 
-  runner.once('end', function () {
+  runner.once(EVENT_RUN_END, function() {
     var obj = {
       stats: self.stats,
       tests: tests.map(clean),
@@ -68,11 +73,11 @@ function JSONReporter (runner) {
  * Return a plain-object representation of `test`
  * free of cyclic properties etc.
  *
- * @api private
+ * @private
  * @param {Object} test
  * @return {Object}
  */
-function clean (test) {
+function clean(test) {
   var err = test.err || {};
   if (err instanceof Error) {
     err = errorJSON(err);
@@ -90,36 +95,40 @@ function clean (test) {
 /**
  * Replaces any circular references inside `obj` with '[object Object]'
  *
- * @api private
+ * @private
  * @param {Object} obj
  * @return {Object}
  */
-function cleanCycles (obj) {
+function cleanCycles(obj) {
   var cache = [];
-  return JSON.parse(JSON.stringify(obj, function (key, value) {
-    if (typeof value === 'object' && value !== null) {
-      if (cache.indexOf(value) !== -1) {
-        // Instead of going in a circle, we'll print [object Object]
-        return '' + value;
+  return JSON.parse(
+    JSON.stringify(obj, function(key, value) {
+      if (typeof value === 'object' && value !== null) {
+        if (cache.indexOf(value) !== -1) {
+          // Instead of going in a circle, we'll print [object Object]
+          return '' + value;
+        }
+        cache.push(value);
       }
-      cache.push(value);
-    }
 
-    return value;
-  }));
+      return value;
+    })
+  );
 }
 
 /**
  * Transform an Error object into a JSON object.
  *
- * @api private
+ * @private
  * @param {Error} err
  * @return {Object}
  */
-function errorJSON (err) {
+function errorJSON(err) {
   var res = {};
-  Object.getOwnPropertyNames(err).forEach(function (key) {
+  Object.getOwnPropertyNames(err).forEach(function(key) {
     res[key] = err[key];
   }, err);
   return res;
 }
+
+JSONReporter.description = 'single JSON object';

package/lib/reporters/landing.js

@@ -8,6 +8,12 @@
 
 var Base = require('./base');
 var inherits = require('../utils').inherits;
+var constants = require('../runner').constants;
+var EVENT_RUN_BEGIN = constants.EVENT_RUN_BEGIN;
+var EVENT_RUN_END = constants.EVENT_RUN_END;
+var EVENT_TEST_END = constants.EVENT_TEST_END;
+var STATE_FAILED = require('../runnable').constants.STATE_FAILED;
+
 var cursor = Base.cursor;
 var color = Base.color;
 
@@ -42,36 +48,35 @@ Base.colors.runway = 90;
  * @class
  * @memberof Mocha.reporters
  * @extends Mocha.reporters.Base
- * @api public
  * @param {Runner} runner
  */
-function Landing (runner) {
+function Landing(runner) {
   Base.call(this, runner);
 
   var self = this;
-  var width = Base.window.width * 0.75 | 0;
+  var width = (Base.window.width * 0.75) | 0;
   var total = runner.total;
   var stream = process.stdout;
   var plane = color('plane', '✈');
   var crashed = -1;
   var n = 0;
 
-  function runway () {
+  function runway() {
     var buf = Array(width).join('-');
     return '  ' + color('runway', buf);
   }
 
-  runner.on('start', function () {
+  runner.on(EVENT_RUN_BEGIN, function() {
     stream.write('\n\n\n  ');
     cursor.hide();
   });
 
-  runner.on('test end', function (test) {
+  runner.on(EVENT_TEST_END, function(test) {
     // check if the plane crashed
-    var col = crashed === -1 ? width * ++n / total | 0 : crashed;
+    var col = crashed === -1 ? ((width * ++n) / total) | 0 : crashed;
 
     // show the crash
-    if (test.state === 'failed') {
+    if (test.state === STATE_FAILED) {
       plane = color('plane crash', '✈');
       crashed = col;
     }
@@ -87,7 +92,7 @@ function Landing (runner) {
     stream.write('\u001b[0m');
   });
 
-  runner.once('end', function () {
+  runner.once(EVENT_RUN_END, function() {
     cursor.show();
     console.log();
     self.epilogue();
@@ -98,3 +103,5 @@ function Landing (runner) {
  * Inherit from `Base.prototype`.
  */
 inherits(Landing, Base);
+
+Landing.description = 'Unicode landing strip';