mocha 5.0.4 → 5.2.0

package/lib/reporters/list.js

@@ -1,5 +1,7 @@
 'use strict';
-
+/**
+ * @module List
+ */
 /**
  * Module dependencies.
  */
@@ -18,38 +20,42 @@ exports = module.exports = List;
 /**
  * Initialize a new `List` test reporter.
  *
+ * @public
+ * @class
+ * @memberof Mocha.reporters
+ * @extends Mocha.reporters.Base
  * @api public
  * @param {Runner} runner
  */
-function List (runner) {
+function List(runner) {
   Base.call(this, runner);
 
   var self = this;
   var n = 0;
 
-  runner.on('start', function () {
+  runner.on('start', function() {
     console.log();
   });
 
-  runner.on('test', function (test) {
+  runner.on('test', function(test) {
     process.stdout.write(color('pass', '    ' + test.fullTitle() + ': '));
   });
 
-  runner.on('pending', function (test) {
-    var fmt = color('checkmark', '  -') +
-      color('pending', ' %s');
+  runner.on('pending', function(test) {
+    var fmt = color('checkmark', '  -') + color('pending', ' %s');
     console.log(fmt, test.fullTitle());
   });
 
-  runner.on('pass', function (test) {
-    var fmt = color('checkmark', '  ' + Base.symbols.ok) +
+  runner.on('pass', function(test) {
+    var fmt =
+      color('checkmark', '  ' + Base.symbols.ok) +
       color('pass', ' %s: ') +
       color(test.speed, '%dms');
     cursor.CR();
     console.log(fmt, test.fullTitle(), test.duration);
   });
 
-  runner.on('fail', function (test) {
+  runner.on('fail', function(test) {
     cursor.CR();
     console.log(color('fail', '  %d) %s'), ++n, test.fullTitle());
   });

package/lib/reporters/markdown.js

@@ -1,5 +1,7 @@
 'use strict';
-
+/**
+ * @module Markdown
+ */
 /**
  * Module dependencies.
  */
@@ -22,32 +24,36 @@ exports = module.exports = Markdown;
 /**
  * Initialize a new `Markdown` reporter.
  *
+ * @public
+ * @class
+ * @memberof Mocha.reporters
+ * @extends Mocha.reporters.Base
  * @api public
  * @param {Runner} runner
  */
-function Markdown (runner) {
+function Markdown(runner) {
   Base.call(this, runner);
 
   var level = 0;
   var buf = '';
 
-  function title (str) {
+  function title(str) {
     return Array(level).join('#') + ' ' + str;
   }
 
-  function mapTOC (suite, obj) {
+  function mapTOC(suite, obj) {
     var ret = obj;
     var key = SUITE_PREFIX + suite.title;
 
-    obj = obj[key] = obj[key] || { suite: suite };
-    suite.suites.forEach(function (suite) {
+    obj = obj[key] = obj[key] || {suite: suite};
+    suite.suites.forEach(function(suite) {
       mapTOC(suite, obj);
     });
 
     return ret;
   }
 
-  function stringifyTOC (obj, level) {
+  function stringifyTOC(obj, level) {
     ++level;
     var buf = '';
     var link;
@@ -65,25 +71,25 @@ function Markdown (runner) {
     return buf;
   }
 
-  function generateTOC (suite) {
+  function generateTOC(suite) {
     var obj = mapTOC(suite, {});
     return stringifyTOC(obj, 0);
   }
 
   generateTOC(runner.suite);
 
-  runner.on('suite', function (suite) {
+  runner.on('suite', function(suite) {
     ++level;
     var slug = utils.slug(suite.fullTitle());
     buf += '<a name="' + slug + '"></a>' + '\n';
     buf += title(suite.title) + '\n';
   });
 
-  runner.on('suite end', function () {
+  runner.on('suite end', function() {
     --level;
   });
 
-  runner.on('pass', function (test) {
+  runner.on('pass', function(test) {
     var code = utils.clean(test.body);
     buf += test.title + '.\n';
     buf += '\n```js\n';
@@ -91,7 +97,7 @@ function Markdown (runner) {
     buf += '```\n\n';
   });
 
-  runner.once('end', function () {
+  runner.once('end', function() {
     process.stdout.write('# TOC\n');
     process.stdout.write(generateTOC(runner.suite));
     process.stdout.write(buf);

package/lib/reporters/min.js

@@ -1,5 +1,7 @@
 'use strict';
-
+/**
+ * @module Min
+ */
 /**
  * Module dependencies.
  */
@@ -16,13 +18,17 @@ exports = module.exports = Min;
 /**
  * Initialize a new `Min` minimal test reporter (best used with --watch).
  *
+ * @public
+ * @class
+ * @memberof Mocha.reporters
+ * @extends Mocha.reporters.Base
  * @api public
  * @param {Runner} runner
  */
-function Min (runner) {
+function Min(runner) {
   Base.call(this, runner);
 
-  runner.on('start', function () {
+  runner.on('start', function() {
     // clear screen
     process.stdout.write('\u001b[2J');
     // set cursor position

package/lib/reporters/nyan.js

@@ -1,5 +1,7 @@
 'use strict';
-
+/**
+ * @module Nyan
+ */
 /**
  * Module dependencies.
  */
@@ -18,14 +20,18 @@ exports = module.exports = NyanCat;
  *
  * @param {Runner} runner
  * @api public
+ * @public
+ * @class Nyan
+ * @memberof Mocha.reporters
+ * @extends Mocha.reporters.Base
  */
 
-function NyanCat (runner) {
+function NyanCat(runner) {
   Base.call(this, runner);
 
   var self = this;
-  var width = Base.window.width * 0.75 | 0;
-  var nyanCatWidth = this.nyanCatWidth = 11;
+  var width = (Base.window.width * 0.75) | 0;
+  var nyanCatWidth = (this.nyanCatWidth = 11);
 
   this.colorIndex = 0;
   this.numberOfLines = 4;
@@ -33,26 +39,26 @@ function NyanCat (runner) {
   this.scoreboardWidth = 5;
   this.tick = 0;
   this.trajectories = [[], [], [], []];
-  this.trajectoryWidthMax = (width - nyanCatWidth);
+  this.trajectoryWidthMax = width - nyanCatWidth;
 
-  runner.on('start', function () {
+  runner.on('start', function() {
     Base.cursor.hide();
     self.draw();
   });
 
-  runner.on('pending', function () {
+  runner.on('pending', function() {
     self.draw();
   });
 
-  runner.on('pass', function () {
+  runner.on('pass', function() {
     self.draw();
   });
 
-  runner.on('fail', function () {
+  runner.on('fail', function() {
     self.draw();
   });
 
-  runner.once('end', function () {
+  runner.once('end', function() {
     Base.cursor.show();
     for (var i = 0; i < self.numberOfLines; i++) {
       write('\n');
@@ -72,7 +78,7 @@ inherits(NyanCat, Base);
  * @api private
  */
 
-NyanCat.prototype.draw = function () {
+NyanCat.prototype.draw = function() {
   this.appendRainbow();
   this.drawScoreboard();
   this.drawRainbow();
@@ -87,10 +93,10 @@ NyanCat.prototype.draw = function () {
  * @api private
  */
 
-NyanCat.prototype.drawScoreboard = function () {
+NyanCat.prototype.drawScoreboard = function() {
   var stats = this.stats;
 
-  function draw (type, n) {
+  function draw(type, n) {
     write(' ');
     write(Base.color(type, n));
     write('\n');
@@ -110,7 +116,7 @@ NyanCat.prototype.drawScoreboard = function () {
  * @api private
  */
 
-NyanCat.prototype.appendRainbow = function () {
+NyanCat.prototype.appendRainbow = function() {
   var segment = this.tick ? '_' : '-';
   var rainbowified = this.rainbowify(segment);
 
@@ -129,10 +135,10 @@ NyanCat.prototype.appendRainbow = function () {
  * @api private
  */
 
-NyanCat.prototype.drawRainbow = function () {
+NyanCat.prototype.drawRainbow = function() {
   var self = this;
 
-  this.trajectories.forEach(function (line) {
+  this.trajectories.forEach(function(line) {
     write('\u001b[' + self.scoreboardWidth + 'C');
     write(line.join(''));
     write('\n');
@@ -146,7 +152,7 @@ NyanCat.prototype.drawRainbow = function () {
  *
  * @api private
  */
-NyanCat.prototype.drawNyanCat = function () {
+NyanCat.prototype.drawNyanCat = function() {
   var self = this;
   var startWidth = this.scoreboardWidth + this.trajectories[0].length;
   var dist = '\u001b[' + startWidth + 'C';
@@ -182,7 +188,7 @@ NyanCat.prototype.drawNyanCat = function () {
  * @return {string}
  */
 
-NyanCat.prototype.face = function () {
+NyanCat.prototype.face = function() {
   var stats = this.stats;
   if (stats.failures) {
     return '( x .x)';
@@ -201,7 +207,7 @@ NyanCat.prototype.face = function () {
  * @param {number} n
  */
 
-NyanCat.prototype.cursorUp = function (n) {
+NyanCat.prototype.cursorUp = function(n) {
   write('\u001b[' + n + 'A');
 };
 
@@ -212,7 +218,7 @@ NyanCat.prototype.cursorUp = function (n) {
  * @param {number} n
  */
 
-NyanCat.prototype.cursorDown = function (n) {
+NyanCat.prototype.cursorDown = function(n) {
   write('\u001b[' + n + 'B');
 };
 
@@ -222,12 +228,12 @@ NyanCat.prototype.cursorDown = function (n) {
  * @api private
  * @return {Array}
  */
-NyanCat.prototype.generateColors = function () {
+NyanCat.prototype.generateColors = function() {
   var colors = [];
 
-  for (var i = 0; i < (6 * 7); i++) {
+  for (var i = 0; i < 6 * 7; i++) {
     var pi3 = Math.floor(Math.PI / 3);
-    var n = (i * (1.0 / 6));
+    var n = i * (1.0 / 6);
     var r = Math.floor(3 * Math.sin(n) + 3);
     var g = Math.floor(3 * Math.sin(n + 2 * pi3) + 3);
     var b = Math.floor(3 * Math.sin(n + 4 * pi3) + 3);
@@ -244,7 +250,7 @@ NyanCat.prototype.generateColors = function () {
  * @param {string} str
  * @return {string}
  */
-NyanCat.prototype.rainbowify = function (str) {
+NyanCat.prototype.rainbowify = function(str) {
   if (!Base.useColors) {
     return str;
   }
@@ -258,6 +264,6 @@ NyanCat.prototype.rainbowify = function (str) {
  *
  * @param {string} string A message to write to stdout.
  */
-function write (string) {
+function write(string) {
   process.stdout.write(string);
 }

package/lib/reporters/progress.js

@@ -1,5 +1,7 @@
 'use strict';
-
+/**
+ * @module Progress
+ */
 /**
  * Module dependencies.
  */
@@ -24,15 +26,19 @@ Base.colors.progress = 90;
 /**
  * Initialize a new `Progress` bar test reporter.
  *
+ * @public
+ * @class
+ * @memberof Mocha.reporters
+ * @extends Mocha.reporters.Base
  * @api public
  * @param {Runner} runner
  * @param {Object} options
  */
-function Progress (runner, options) {
+function Progress(runner, options) {
   Base.call(this, runner);
 
   var self = this;
-  var width = Base.window.width * 0.50 | 0;
+  var width = (Base.window.width * 0.5) | 0;
   var total = runner.total;
   var complete = 0;
   var lastN = -1;
@@ -48,17 +54,17 @@ function Progress (runner, options) {
   options.verbose = reporterOptions.verbose || false;
 
   // tests started
-  runner.on('start', function () {
+  runner.on('start', function() {
     console.log();
     cursor.hide();
   });
 
   // tests complete
-  runner.on('test end', function () {
+  runner.on('test end', function() {
     complete++;
 
     var percent = complete / total;
-    var n = width * percent | 0;
+    var n = (width * percent) | 0;
     var i = width - n;
 
     if (n === lastN && !options.verbose) {
@@ -80,7 +86,7 @@ function Progress (runner, options) {
 
   // tests are complete, output some stats
   // and the failures if any
-  runner.once('end', function () {
+  runner.once('end', function() {
     cursor.show();
     console.log();
     self.epilogue();

package/lib/reporters/spec.js

@@ -1,5 +1,7 @@
 'use strict';
-
+/**
+ * @module Spec
+ */
 /**
  * Module dependencies.
  */
@@ -17,50 +19,56 @@ exports = module.exports = Spec;
 /**
  * Initialize a new `Spec` test reporter.
  *
+ * @public
+ * @class
+ * @memberof Mocha.reporters
+ * @extends Mocha.reporters.Base
  * @api public
  * @param {Runner} runner
  */
-function Spec (runner) {
+function Spec(runner) {
   Base.call(this, runner);
 
   var self = this;
   var indents = 0;
   var n = 0;
 
-  function indent () {
+  function indent() {
     return Array(indents).join('  ');
   }
 
-  runner.on('start', function () {
+  runner.on('start', function() {
     console.log();
   });
 
-  runner.on('suite', function (suite) {
+  runner.on('suite', function(suite) {
     ++indents;
     console.log(color('suite', '%s%s'), indent(), suite.title);
   });
 
-  runner.on('suite end', function () {
+  runner.on('suite end', function() {
     --indents;
     if (indents === 1) {
       console.log();
     }
   });
 
-  runner.on('pending', function (test) {
+  runner.on('pending', function(test) {
     var fmt = indent() + color('pending', '  - %s');
     console.log(fmt, test.title);
   });
 
-  runner.on('pass', function (test) {
+  runner.on('pass', function(test) {
     var fmt;
     if (test.speed === 'fast') {
-      fmt = indent() +
+      fmt =
+        indent() +
         color('checkmark', '  ' + Base.symbols.ok) +
         color('pass', ' %s');
       console.log(fmt, test.title);
     } else {
-      fmt = indent() +
+      fmt =
+        indent() +
         color('checkmark', '  ' + Base.symbols.ok) +
         color('pass', ' %s') +
         color(test.speed, ' (%dms)');
@@ -68,7 +76,7 @@ function Spec (runner) {
     }
   });
 
-  runner.on('fail', function (test) {
+  runner.on('fail', function(test) {
     console.log(indent() + color('fail', '  %d) %s'), ++n, test.title);
   });
 

package/lib/reporters/tap.js

@@ -1,5 +1,7 @@
 'use strict';
-
+/**
+ * @module TAP
+ */
 /**
  * Module dependencies.
  */
@@ -15,35 +17,39 @@ exports = module.exports = TAP;
 /**
  * Initialize a new `TAP` reporter.
  *
+ * @public
+ * @class
+ * @memberof Mocha.reporters
+ * @extends Mocha.reporters.Base
  * @api public
  * @param {Runner} runner
  */
-function TAP (runner) {
+function TAP(runner) {
   Base.call(this, runner);
 
   var n = 1;
   var passes = 0;
   var failures = 0;
 
-  runner.on('start', function () {
+  runner.on('start', function() {
     var total = runner.grepTotal(runner.suite);
     console.log('%d..%d', 1, total);
   });
 
-  runner.on('test end', function () {
+  runner.on('test end', function() {
     ++n;
   });
 
-  runner.on('pending', function (test) {
+  runner.on('pending', function(test) {
     console.log('ok %d %s # SKIP -', n, title(test));
   });
 
-  runner.on('pass', function (test) {
+  runner.on('pass', function(test) {
     passes++;
     console.log('ok %d %s', n, title(test));
   });
 
-  runner.on('fail', function (test, err) {
+  runner.on('fail', function(test, err) {
     failures++;
     console.log('not ok %d %s', n, title(test));
     if (err.stack) {
@@ -51,7 +57,7 @@ function TAP (runner) {
     }
   });
 
-  runner.once('end', function () {
+  runner.once('end', function() {
     console.log('# tests ' + (passes + failures));
     console.log('# pass ' + passes);
     console.log('# fail ' + failures);
@@ -65,6 +71,6 @@ function TAP (runner) {
  * @param {Object} test
  * @return {String}
  */
-function title (test) {
+function title(test) {
   return test.fullTitle().replace(/#/g, '');
 }