mocha 5.1.1 → 5.2.0

package/lib/suite.js

@@ -31,7 +31,7 @@ exports = module.exports = Suite;
  * @param {string} title
  * @return {Suite}
  */
-exports.create = function (parent, title) {
+exports.create = function(parent, title) {
   var suite = new Suite(title, parent.ctx);
   suite.parent = parent;
   title = suite.fullTitle();
@@ -48,12 +48,16 @@ exports.create = function (parent, title) {
  * @param {string} title
  * @param {Context} parentContext
  */
-function Suite (title, parentContext) {
+function Suite(title, parentContext) {
   if (!utils.isString(title)) {
-    throw new Error('Suite `title` should be a "string" but "' + typeof title + '" was given instead.');
+    throw new Error(
+      'Suite `title` should be a "string" but "' +
+        typeof title +
+        '" was given instead.'
+    );
   }
   this.title = title;
-  function Context () {}
+  function Context() {}
   Context.prototype = parentContext;
   this.ctx = new Context();
   this.suites = [];
@@ -85,7 +89,7 @@ inherits(Suite, EventEmitter);
  * @api private
  * @return {Suite}
  */
-Suite.prototype.clone = function () {
+Suite.prototype.clone = function() {
   var suite = new Suite(this.title);
   debug('clone');
   suite.ctx = this.ctx;
@@ -104,7 +108,7 @@ Suite.prototype.clone = function () {
  * @param {number|string} ms
  * @return {Suite|number} for chaining
  */
-Suite.prototype.timeout = function (ms) {
+Suite.prototype.timeout = function(ms) {
   if (!arguments.length) {
     return this._timeout;
   }
@@ -126,7 +130,7 @@ Suite.prototype.timeout = function (ms) {
  * @param {number|string} n
  * @return {Suite|number} for chaining
  */
-Suite.prototype.retries = function (n) {
+Suite.prototype.retries = function(n) {
   if (!arguments.length) {
     return this._retries;
   }
@@ -136,13 +140,13 @@ Suite.prototype.retries = function (n) {
 };
 
 /**
-  * Set or get timeout to `enabled`.
-  *
-  * @api private
-  * @param {boolean} enabled
-  * @return {Suite|boolean} self or enabled
-  */
-Suite.prototype.enableTimeouts = function (enabled) {
+ * Set or get timeout to `enabled`.
+ *
+ * @api private
+ * @param {boolean} enabled
+ * @return {Suite|boolean} self or enabled
+ */
+Suite.prototype.enableTimeouts = function(enabled) {
   if (!arguments.length) {
     return this._enableTimeouts;
   }
@@ -158,7 +162,7 @@ Suite.prototype.enableTimeouts = function (enabled) {
  * @param {number|string} ms
  * @return {Suite|number} for chaining
  */
-Suite.prototype.slow = function (ms) {
+Suite.prototype.slow = function(ms) {
   if (!arguments.length) {
     return this._slow;
   }
@@ -177,7 +181,7 @@ Suite.prototype.slow = function (ms) {
  * @param {boolean} bail
  * @return {Suite|number} for chaining
  */
-Suite.prototype.bail = function (bail) {
+Suite.prototype.bail = function(bail) {
   if (!arguments.length) {
     return this._bail;
   }
@@ -191,7 +195,7 @@ Suite.prototype.bail = function (bail) {
  *
  * @api private
  */
-Suite.prototype.isPending = function () {
+Suite.prototype.isPending = function() {
   return this.pending || (this.parent && this.parent.isPending());
 };
 
@@ -202,7 +206,7 @@ Suite.prototype.isPending = function () {
  * @param {Function} fn - Hook callback
  * @returns {Hook} A new hook
  */
-Suite.prototype._createHook = function (title, fn) {
+Suite.prototype._createHook = function(title, fn) {
   var hook = new Hook(title, fn);
   hook.parent = this;
   hook.timeout(this.timeout());
@@ -222,7 +226,7 @@ Suite.prototype._createHook = function (title, fn) {
  * @param {Function} fn
  * @return {Suite} for chaining
  */
-Suite.prototype.beforeAll = function (title, fn) {
+Suite.prototype.beforeAll = function(title, fn) {
   if (this.isPending()) {
     return this;
   }
@@ -246,7 +250,7 @@ Suite.prototype.beforeAll = function (title, fn) {
  * @param {Function} fn
  * @return {Suite} for chaining
  */
-Suite.prototype.afterAll = function (title, fn) {
+Suite.prototype.afterAll = function(title, fn) {
   if (this.isPending()) {
     return this;
   }
@@ -270,7 +274,7 @@ Suite.prototype.afterAll = function (title, fn) {
  * @param {Function} fn
  * @return {Suite} for chaining
  */
-Suite.prototype.beforeEach = function (title, fn) {
+Suite.prototype.beforeEach = function(title, fn) {
   if (this.isPending()) {
     return this;
   }
@@ -294,7 +298,7 @@ Suite.prototype.beforeEach = function (title, fn) {
  * @param {Function} fn
  * @return {Suite} for chaining
  */
-Suite.prototype.afterEach = function (title, fn) {
+Suite.prototype.afterEach = function(title, fn) {
   if (this.isPending()) {
     return this;
   }
@@ -317,7 +321,7 @@ Suite.prototype.afterEach = function (title, fn) {
  * @param {Suite} suite
  * @return {Suite} for chaining
  */
-Suite.prototype.addSuite = function (suite) {
+Suite.prototype.addSuite = function(suite) {
   suite.parent = this;
   suite.timeout(this.timeout());
   suite.retries(this.retries());
@@ -336,7 +340,7 @@ Suite.prototype.addSuite = function (suite) {
  * @param {Test} test
  * @return {Suite} for chaining
  */
-Suite.prototype.addTest = function (test) {
+Suite.prototype.addTest = function(test) {
   test.parent = this;
   test.timeout(this.timeout());
   test.retries(this.retries());
@@ -357,7 +361,7 @@ Suite.prototype.addTest = function (test) {
  * @api public
  * @return {string}
  */
-Suite.prototype.fullTitle = function () {
+Suite.prototype.fullTitle = function() {
   return this.titlePath().join(' ');
 };
 
@@ -370,7 +374,7 @@ Suite.prototype.fullTitle = function () {
  * @api public
  * @return {string}
  */
-Suite.prototype.titlePath = function () {
+Suite.prototype.titlePath = function() {
   var result = [];
   if (this.parent) {
     result = result.concat(this.parent.titlePath());
@@ -389,10 +393,12 @@ Suite.prototype.titlePath = function () {
  * @api public
  * @return {number}
  */
-Suite.prototype.total = function () {
-  return this.suites.reduce(function (sum, suite) {
-    return sum + suite.total();
-  }, 0) + this.tests.length;
+Suite.prototype.total = function() {
+  return (
+    this.suites.reduce(function(sum, suite) {
+      return sum + suite.total();
+    }, 0) + this.tests.length
+  );
 };
 
 /**
@@ -403,9 +409,9 @@ Suite.prototype.total = function () {
  * @param {Function} fn
  * @return {Suite}
  */
-Suite.prototype.eachTest = function (fn) {
+Suite.prototype.eachTest = function(fn) {
   this.tests.forEach(fn);
-  this.suites.forEach(function (suite) {
+  this.suites.forEach(function(suite) {
     suite.eachTest(fn);
   });
   return this;
@@ -414,7 +420,7 @@ Suite.prototype.eachTest = function (fn) {
 /**
  * This will run the root suite if we happen to be running in delayed mode.
  */
-Suite.prototype.run = function run () {
+Suite.prototype.run = function run() {
   if (this.root) {
     this.emit('run');
   }

package/lib/test.js

@@ -1,29 +1,25 @@
 'use strict';
-
-/**
- * Module dependencies.
- */
-
 var Runnable = require('./runnable');
 var utils = require('./utils');
 var isString = utils.isString;
 
-/**
- * Expose `Test`.
- */
-
 module.exports = Test;
 
 /**
  * Initialize a new `Test` with the given `title` and callback `fn`.
  *
- * @api private
+ * @class
+ * @extends Runnable
  * @param {String} title
  * @param {Function} fn
  */
-function Test (title, fn) {
+function Test(title, fn) {
   if (!isString(title)) {
-    throw new Error('Test `title` should be a "string" but "' + typeof title + '" was given instead.');
+    throw new Error(
+      'Test `title` should be a "string" but "' +
+        typeof title +
+        '" was given instead.'
+    );
   }
   Runnable.call(this, title, fn);
   this.pending = !fn;
@@ -35,7 +31,7 @@ function Test (title, fn) {
  */
 utils.inherits(Test, Runnable);
 
-Test.prototype.clone = function () {
+Test.prototype.clone = function() {
   var test = new Test(this.title, this.fn);
   test.timeout(this.timeout());
   test.slow(this.slow());