mocha 5.1.1 → 5.2.0

package/lib/interfaces/common.js

@@ -10,7 +10,7 @@ var Suite = require('../suite');
  * @param {Mocha} mocha
  * @return {Object} An object containing common functions.
  */
-module.exports = function (suites, context, mocha) {
+module.exports = function(suites, context, mocha) {
   return {
     /**
      * This is only present if flag --delay is passed into Mocha. It triggers
@@ -19,8 +19,8 @@ module.exports = function (suites, context, mocha) {
      * @param {Suite} suite The root suite.
      * @return {Function} A function which runs the root suite
      */
-    runWithSuite: function runWithSuite (suite) {
-      return function run () {
+    runWithSuite: function runWithSuite(suite) {
+      return function run() {
         suite.run();
       };
     },
@@ -31,7 +31,7 @@ module.exports = function (suites, context, mocha) {
      * @param {string} name
      * @param {Function} fn
      */
-    before: function (name, fn) {
+    before: function(name, fn) {
       suites[0].beforeAll(name, fn);
     },
 
@@ -41,7 +41,7 @@ module.exports = function (suites, context, mocha) {
      * @param {string} name
      * @param {Function} fn
      */
-    after: function (name, fn) {
+    after: function(name, fn) {
       suites[0].afterAll(name, fn);
     },
 
@@ -51,7 +51,7 @@ module.exports = function (suites, context, mocha) {
      * @param {string} name
      * @param {Function} fn
      */
-    beforeEach: function (name, fn) {
+    beforeEach: function(name, fn) {
       suites[0].beforeEach(name, fn);
     },
 
@@ -61,7 +61,7 @@ module.exports = function (suites, context, mocha) {
      * @param {string} name
      * @param {Function} fn
      */
-    afterEach: function (name, fn) {
+    afterEach: function(name, fn) {
       suites[0].afterEach(name, fn);
     },
 
@@ -73,7 +73,7 @@ module.exports = function (suites, context, mocha) {
        * @param {Object} opts
        * @returns {Suite}
        */
-      only: function only (opts) {
+      only: function only(opts) {
         opts.isOnly = true;
         return this.create(opts);
       },
@@ -85,7 +85,7 @@ module.exports = function (suites, context, mocha) {
        * @param {Object} opts
        * @returns {Suite}
        */
-      skip: function skip (opts) {
+      skip: function skip(opts) {
         opts.pending = true;
         return this.create(opts);
       },
@@ -100,7 +100,7 @@ module.exports = function (suites, context, mocha) {
        * @param {boolean} [opts.isOnly] Is Suite exclusive?
        * @returns {Suite}
        */
-      create: function create (opts) {
+      create: function create(opts) {
         var suite = Suite.create(suites[0], opts.title);
         suite.pending = Boolean(opts.pending);
         suite.file = opts.file;
@@ -112,7 +112,11 @@ module.exports = function (suites, context, mocha) {
           opts.fn.call(suite);
           suites.shift();
         } else if (typeof opts.fn === 'undefined' && !suite.pending) {
-          throw new Error('Suite "' + suite.fullTitle() + '" was defined but no callback was supplied. Supply a callback or explicitly skip the suite.');
+          throw new Error(
+            'Suite "' +
+              suite.fullTitle() +
+              '" was defined but no callback was supplied. Supply a callback or explicitly skip the suite.'
+          );
         } else if (!opts.fn && suite.pending) {
           suites.shift();
         }
@@ -122,7 +126,6 @@ module.exports = function (suites, context, mocha) {
     },
 
     test: {
-
       /**
        * Exclusive test-case.
        *
@@ -130,7 +133,7 @@ module.exports = function (suites, context, mocha) {
        * @param {Function} test
        * @returns {*}
        */
-      only: function (mocha, test) {
+      only: function(mocha, test) {
         test.parent._onlyTests = test.parent._onlyTests.concat(test);
         return test;
       },
@@ -140,7 +143,7 @@ module.exports = function (suites, context, mocha) {
        *
        * @param {string} title
        */
-      skip: function (title) {
+      skip: function(title) {
         context.test(title);
       },
 
@@ -149,7 +152,7 @@ module.exports = function (suites, context, mocha) {
        *
        * @param {number} n
        */
-      retries: function (n) {
+      retries: function(n) {
         context.retries(n);
       }
     }

package/lib/interfaces/exports.js

@@ -1,9 +1,4 @@
 'use strict';
-
-/**
- * Module dependencies.
- */
-
 var Suite = require('../suite');
 var Test = require('../test');
 
@@ -24,12 +19,12 @@ var Test = require('../test');
  *
  * @param {Suite} suite Root suite.
  */
-module.exports = function (suite) {
+module.exports = function(suite) {
   var suites = [suite];
 
   suite.on('require', visit);
 
-  function visit (obj, file) {
+  function visit(obj, file) {
     var suite;
     for (var key in obj) {
       if (typeof obj[key] === 'function') {

package/lib/interfaces/qunit.js

@@ -1,9 +1,5 @@
 'use strict';
 
-/**
- * Module dependencies.
- */
-
 var Test = require('../test');
 
 /**
@@ -31,10 +27,10 @@ var Test = require('../test');
  *
  * @param {Suite} suite Root suite.
  */
-module.exports = function (suite) {
+module.exports = function qUnitInterface(suite) {
   var suites = [suite];
 
-  suite.on('pre-require', function (context, file, mocha) {
+  suite.on('pre-require', function(context, file, mocha) {
     var common = require('./common')(suites, context, mocha);
 
     context.before = common.before;
@@ -46,7 +42,7 @@ module.exports = function (suite) {
      * Describe a "suite" with the given `title`.
      */
 
-    context.suite = function (title) {
+    context.suite = function(title) {
       if (suites.length > 1) {
         suites.shift();
       }
@@ -61,7 +57,7 @@ module.exports = function (suite) {
      * Exclusive Suite.
      */
 
-    context.suite.only = function (title) {
+    context.suite.only = function(title) {
       if (suites.length > 1) {
         suites.shift();
       }
@@ -78,7 +74,7 @@ module.exports = function (suite) {
      * acting as a thunk.
      */
 
-    context.test = function (title, fn) {
+    context.test = function(title, fn) {
       var test = new Test(title, fn);
       test.file = file;
       suites[0].addTest(test);
@@ -89,7 +85,7 @@ module.exports = function (suite) {
      * Exclusive test-case.
      */
 
-    context.test.only = function (title, fn) {
+    context.test.only = function(title, fn) {
       return common.test.only(mocha, context.test(title, fn));
     };
 

package/lib/interfaces/tdd.js

@@ -1,9 +1,5 @@
 'use strict';
 
-/**
- * Module dependencies.
- */
-
 var Test = require('../test');
 
 /**
@@ -31,10 +27,10 @@ var Test = require('../test');
  *
  * @param {Suite} suite Root suite.
  */
-module.exports = function (suite) {
+module.exports = function(suite) {
   var suites = [suite];
 
-  suite.on('pre-require', function (context, file, mocha) {
+  suite.on('pre-require', function(context, file, mocha) {
     var common = require('./common')(suites, context, mocha);
 
     context.setup = common.beforeEach;
@@ -47,7 +43,7 @@ module.exports = function (suite) {
      * Describe a "suite" with the given `title` and callback `fn` containing
      * nested suites and/or tests.
      */
-    context.suite = function (title, fn) {
+    context.suite = function(title, fn) {
       return common.suite.create({
         title: title,
         file: file,
@@ -58,7 +54,7 @@ module.exports = function (suite) {
     /**
      * Pending suite.
      */
-    context.suite.skip = function (title, fn) {
+    context.suite.skip = function(title, fn) {
       return common.suite.skip({
         title: title,
         file: file,
@@ -69,7 +65,7 @@ module.exports = function (suite) {
     /**
      * Exclusive test-case.
      */
-    context.suite.only = function (title, fn) {
+    context.suite.only = function(title, fn) {
       return common.suite.only({
         title: title,
         file: file,
@@ -81,7 +77,7 @@ module.exports = function (suite) {
      * Describe a specification or test-case with the given `title` and
      * callback `fn` acting as a thunk.
      */
-    context.test = function (title, fn) {
+    context.test = function(title, fn) {
       var suite = suites[0];
       if (suite.isPending()) {
         fn = null;
@@ -96,7 +92,7 @@ module.exports = function (suite) {
      * Exclusive test-case.
      */
 
-    context.test.only = function (title, fn) {
+    context.test.only = function(title, fn) {
       return common.test.only(mocha, context.test(title, fn));
     };
 

package/lib/mocha.js

@@ -5,23 +5,12 @@
  * Copyright(c) 2011 TJ Holowaychuk <tj@vision-media.ca>
  * MIT Licensed
  */
-/**
- * @namespace Mocha
- * @module Mocha
- */
-/**
- * Module dependencies.
- */
 
 var escapeRe = require('escape-string-regexp');
 var path = require('path');
 var reporters = require('./reporters');
 var utils = require('./utils');
 
-/**
- * Expose `Mocha`.
- */
-
 exports = module.exports = Mocha;
 
 /**
@@ -64,12 +53,12 @@ exports.Test = require('./test');
 /**
  * Return image `name` path.
  *
- * @api private
+ * @private
  * @param {string} name
  * @return {string}
  */
-function image (name) {
-  return path.join(__dirname, '../images', name + '.png');
+function image(name) {
+  return path.join(__dirname, '..', 'assets', 'growl', name + '.png');
 }
 
 /**
@@ -88,12 +77,10 @@ function image (name) {
  *   - `fullTrace` display the full stack-trace on failing
  *   - `grep` string or regexp to filter tests with
  *
- * @public
  * @class Mocha
  * @param {Object} options
- * @api public
  */
-function Mocha (options) {
+function Mocha(options) {
   options = options || {};
   this.files = [];
   this.options = options;
@@ -129,7 +116,7 @@ function Mocha (options) {
  * @api public
  * @param {boolean} [bail]
  */
-Mocha.prototype.bail = function (bail) {
+Mocha.prototype.bail = function(bail) {
   if (!arguments.length) {
     bail = true;
   }
@@ -144,7 +131,7 @@ Mocha.prototype.bail = function (bail) {
  * @api public
  * @param {string} file
  */
-Mocha.prototype.addFile = function (file) {
+Mocha.prototype.addFile = function(file) {
   this.files.push(file);
   return this;
 };
@@ -159,7 +146,7 @@ Mocha.prototype.addFile = function (file) {
  * @param {string|Function} reporter name or constructor
  * @param {Object} reporterOptions optional options
  */
-Mocha.prototype.reporter = function (reporter, reporterOptions) {
+Mocha.prototype.reporter = function(reporter, reporterOptions) {
   if (typeof reporter === 'function') {
     this._reporter = reporter;
   } else {
@@ -179,18 +166,28 @@ Mocha.prototype.reporter = function (reporter, reporterOptions) {
           try {
             _reporter = require(path.resolve(process.cwd(), reporter));
           } catch (_err) {
-            err.message.indexOf('Cannot find module') !== -1 ? console.warn('"' + reporter + '" reporter not found')
-              : console.warn('"' + reporter + '" reporter blew up with error:\n' + err.stack);
+            err.message.indexOf('Cannot find module') !== -1
+              ? console.warn('"' + reporter + '" reporter not found')
+              : console.warn(
+                  '"' +
+                    reporter +
+                    '" reporter blew up with error:\n' +
+                    err.stack
+                );
           }
         } else {
-          console.warn('"' + reporter + '" reporter blew up with error:\n' + err.stack);
+          console.warn(
+            '"' + reporter + '" reporter blew up with error:\n' + err.stack
+          );
         }
       }
     }
     if (!_reporter && reporter === 'teamcity') {
-      console.warn('The Teamcity reporter was moved to a package named ' +
-        'mocha-teamcity-reporter ' +
-        '(https://npmjs.org/package/mocha-teamcity-reporter).');
+      console.warn(
+        'The Teamcity reporter was moved to a package named ' +
+          'mocha-teamcity-reporter ' +
+          '(https://npmjs.org/package/mocha-teamcity-reporter).'
+      );
     }
     if (!_reporter) {
       throw new Error('invalid reporter "' + reporter + '"');
@@ -207,7 +204,7 @@ Mocha.prototype.reporter = function (reporter, reporterOptions) {
  * @api public
  * @param {string} bdd
  */
-Mocha.prototype.ui = function (name) {
+Mocha.prototype.ui = function(name) {
   name = name || 'bdd';
   this._ui = exports.interfaces[name];
   if (!this._ui) {
@@ -219,7 +216,7 @@ Mocha.prototype.ui = function (name) {
   }
   this._ui = this._ui(this.suite);
 
-  this.suite.on('pre-require', function (context) {
+  this.suite.on('pre-require', function(context) {
     exports.afterEach = context.afterEach || context.teardown;
     exports.after = context.after || context.suiteTeardown;
     exports.beforeEach = context.beforeEach || context.setup;
@@ -244,10 +241,10 @@ Mocha.prototype.ui = function (name) {
  *
  * @api private
  */
-Mocha.prototype.loadFiles = function (fn) {
+Mocha.prototype.loadFiles = function(fn) {
   var self = this;
   var suite = this.suite;
-  this.files.forEach(function (file) {
+  this.files.forEach(function(file) {
     file = path.resolve(file);
     suite.emit('pre-require', global, file, self);
     suite.emit('require', require(file), file, self);
@@ -261,14 +258,14 @@ Mocha.prototype.loadFiles = function (fn) {
  *
  * @api private
  */
-Mocha.prototype._growl = function (runner, reporter) {
+Mocha.prototype._growl = function(runner, reporter) {
   var notify = require('growl');
 
-  runner.on('end', function () {
+  runner.on('end', function() {
     var stats = reporter.stats;
     if (stats.failures) {
       var msg = stats.failures + ' of ' + runner.total + ' tests failed';
-      notify(msg, { name: 'mocha', title: 'Failed', image: image('error') });
+      notify(msg, {name: 'mocha', title: 'Failed', image: image('error')});
     } else {
       notify(stats.passes + ' tests passed in ' + stats.duration + 'ms', {
         name: 'mocha',
@@ -287,7 +284,7 @@ Mocha.prototype._growl = function (runner, reporter) {
  * @param str
  * @returns {Mocha}
  */
-Mocha.prototype.fgrep = function (str) {
+Mocha.prototype.fgrep = function(str) {
   return this.grep(new RegExp(escapeRe(str)));
 };
 
@@ -301,7 +298,7 @@ Mocha.prototype.fgrep = function (str) {
  * @param {RegExp|string} re
  * @return {Mocha}
  */
-Mocha.prototype.grep = function (re) {
+Mocha.prototype.grep = function(re) {
   if (utils.isString(re)) {
     // extract args if it's regex-like, i.e: [string, pattern, flag]
     var arg = re.match(/^\/(.*)\/(g|i|)$|.*/);
@@ -318,7 +315,7 @@ Mocha.prototype.grep = function (re) {
  * @return {Mocha}
  * @api public
  */
-Mocha.prototype.invert = function () {
+Mocha.prototype.invert = function() {
   this.options.invert = true;
   return this;
 };
@@ -333,7 +330,7 @@ Mocha.prototype.invert = function () {
  * @param {boolean} ignore
  * @return {Mocha}
  */
-Mocha.prototype.ignoreLeaks = function (ignore) {
+Mocha.prototype.ignoreLeaks = function(ignore) {
   this.options.ignoreLeaks = Boolean(ignore);
   return this;
 };
@@ -345,7 +342,7 @@ Mocha.prototype.ignoreLeaks = function (ignore) {
  * @api public
  * @public
  */
-Mocha.prototype.checkLeaks = function () {
+Mocha.prototype.checkLeaks = function() {
   this.options.ignoreLeaks = false;
   return this;
 };
@@ -357,7 +354,7 @@ Mocha.prototype.checkLeaks = function () {
  * @api public
  * @public
  */
-Mocha.prototype.fullTrace = function () {
+Mocha.prototype.fullTrace = function() {
   this.options.fullStackTrace = true;
   return this;
 };
@@ -369,7 +366,7 @@ Mocha.prototype.fullTrace = function () {
  * @api public
  * @public
  */
-Mocha.prototype.growl = function () {
+Mocha.prototype.growl = function() {
   this.options.growl = true;
   return this;
 };
@@ -384,7 +381,7 @@ Mocha.prototype.growl = function () {
  * @param {Array|string} globals
  * @return {Mocha}
  */
-Mocha.prototype.globals = function (globals) {
+Mocha.prototype.globals = function(globals) {
   this.options.globals = (this.options.globals || []).concat(globals);
   return this;
 };
@@ -399,7 +396,7 @@ Mocha.prototype.globals = function (globals) {
  * @param {boolean} colors
  * @return {Mocha}
  */
-Mocha.prototype.useColors = function (colors) {
+Mocha.prototype.useColors = function(colors) {
   if (colors !== undefined) {
     this.options.useColors = colors;
   }
@@ -416,7 +413,7 @@ Mocha.prototype.useColors = function (colors) {
  * @param {boolean} inlineDiffs
  * @return {Mocha}
  */
-Mocha.prototype.useInlineDiffs = function (inlineDiffs) {
+Mocha.prototype.useInlineDiffs = function(inlineDiffs) {
   this.options.useInlineDiffs = inlineDiffs !== undefined && inlineDiffs;
   return this;
 };
@@ -431,7 +428,7 @@ Mocha.prototype.useInlineDiffs = function (inlineDiffs) {
  * @param {boolean} hideDiff
  * @return {Mocha}
  */
-Mocha.prototype.hideDiff = function (hideDiff) {
+Mocha.prototype.hideDiff = function(hideDiff) {
   this.options.hideDiff = hideDiff !== undefined && hideDiff;
   return this;
 };
@@ -446,7 +443,7 @@ Mocha.prototype.hideDiff = function (hideDiff) {
  * @param {number} timeout
  * @return {Mocha}
  */
-Mocha.prototype.timeout = function (timeout) {
+Mocha.prototype.timeout = function(timeout) {
   this.suite.timeout(timeout);
   return this;
 };
@@ -459,7 +456,7 @@ Mocha.prototype.timeout = function (timeout) {
  * @api public
  * @public
  */
-Mocha.prototype.retries = function (n) {
+Mocha.prototype.retries = function(n) {
   this.suite.retries(n);
   return this;
 };
@@ -474,7 +471,7 @@ Mocha.prototype.retries = function (n) {
  * @param {number} slow
  * @return {Mocha}
  */
-Mocha.prototype.slow = function (slow) {
+Mocha.prototype.slow = function(slow) {
   this.suite.slow(slow);
   return this;
 };
@@ -489,8 +486,10 @@ Mocha.prototype.slow = function (slow) {
  * @param {boolean} enabled
  * @return {Mocha}
  */
-Mocha.prototype.enableTimeouts = function (enabled) {
-  this.suite.enableTimeouts(arguments.length && enabled !== undefined ? enabled : true);
+Mocha.prototype.enableTimeouts = function(enabled) {
+  this.suite.enableTimeouts(
+    arguments.length && enabled !== undefined ? enabled : true
+  );
   return this;
 };
 
@@ -501,7 +500,7 @@ Mocha.prototype.enableTimeouts = function (enabled) {
  * @api public
  * @public
  */
-Mocha.prototype.asyncOnly = function () {
+Mocha.prototype.asyncOnly = function() {
   this.options.asyncOnly = true;
   return this;
 };
@@ -512,7 +511,7 @@ Mocha.prototype.asyncOnly = function () {
  * @api public
  * @public
  */
-Mocha.prototype.noHighlighting = function () {
+Mocha.prototype.noHighlighting = function() {
   this.options.noHighlighting = true;
   return this;
 };
@@ -524,7 +523,7 @@ Mocha.prototype.noHighlighting = function () {
  * @api public
  * @public
  */
-Mocha.prototype.allowUncaught = function () {
+Mocha.prototype.allowUncaught = function() {
   this.options.allowUncaught = true;
   return this;
 };
@@ -533,7 +532,7 @@ Mocha.prototype.allowUncaught = function () {
  * Delay root suite execution.
  * @returns {Mocha}
  */
-Mocha.prototype.delay = function delay () {
+Mocha.prototype.delay = function delay() {
   this.options.delay = true;
   return this;
 };
@@ -542,7 +541,7 @@ Mocha.prototype.delay = function delay () {
  * Tests marked only fail the suite
  * @returns {Mocha}
  */
-Mocha.prototype.forbidOnly = function () {
+Mocha.prototype.forbidOnly = function() {
   this.options.forbidOnly = true;
   return this;
 };
@@ -551,7 +550,7 @@ Mocha.prototype.forbidOnly = function () {
  * Pending tests and tests marked skip fail the suite
  * @returns {Mocha}
  */
-Mocha.prototype.forbidPending = function () {
+Mocha.prototype.forbidPending = function() {
   this.options.forbidPending = true;
   return this;
 };
@@ -572,7 +571,7 @@ Mocha.prototype.forbidPending = function () {
  * @param {Function} fn
  * @return {Runner}
  */
-Mocha.prototype.run = function (fn) {
+Mocha.prototype.run = function(fn) {
   if (this.files.length) {
     this.loadFiles();
   }
@@ -602,7 +601,7 @@ Mocha.prototype.run = function (fn) {
   exports.reporters.Base.inlineDiffs = options.useInlineDiffs;
   exports.reporters.Base.hideDiff = options.hideDiff;
 
-  function done (failures) {
+  function done(failures) {
     if (reporter.done) {
       reporter.done(failures, fn);
     } else {

package/lib/ms.js

@@ -21,7 +21,7 @@ var y = d * 365.25;
  * @param {string|number} val
  * @return {string|number}
  */
-module.exports = function (val) {
+module.exports = function(val) {
   if (typeof val === 'string') {
     return parse(val);
   }
@@ -35,8 +35,10 @@ module.exports = function (val) {
  * @param {string} str
  * @return {number}
  */
-function parse (str) {
-  var match = (/^((?:\d+)?\.?\d+) *(ms|seconds?|s|minutes?|m|hours?|h|days?|d|years?|y)?$/i).exec(str);
+function parse(str) {
+  var match = /^((?:\d+)?\.?\d+) *(ms|seconds?|s|minutes?|m|hours?|h|days?|d|years?|y)?$/i.exec(
+    str
+  );
   if (!match) {
     return;
   }
@@ -66,7 +68,7 @@ function parse (str) {
     case 'ms':
       return n;
     default:
-      // No default case
+    // No default case
   }
 }
 
@@ -77,7 +79,7 @@ function parse (str) {
  * @param {number} ms
  * @return {string}
  */
-function format (ms) {
+function format(ms) {
   if (ms >= d) {
     return Math.round(ms / d) + 'd';
   }

package/lib/pending.js

@@ -1,9 +1,5 @@
 'use strict';
 
-/**
- * Expose `Pending`.
- */
-
 module.exports = Pending;
 
 /**
@@ -11,6 +7,6 @@ module.exports = Pending;
  *
  * @param {string} message
  */
-function Pending (message) {
+function Pending(message) {
   this.message = message;
 }