mocha 5.1.1 → 5.2.0

package/lib/runnable.js

@@ -1,10 +1,4 @@
 'use strict';
-/**
- * @module Runnable
- */
-/**
- * Module dependencies.
- */
 var EventEmitter = require('events').EventEmitter;
 var Pending = require('./pending');
 var debug = require('debug')('mocha:runnable');
@@ -23,28 +17,19 @@ var clearTimeout = global.clearTimeout;
 var clearInterval = global.clearInterval;
 /* eslint-enable no-unused-vars, no-native-reassign */
 
-/**
- * Object#toString().
- */
-
 var toString = Object.prototype.toString;
 
-/**
- * Expose `Runnable`.
- */
-
 module.exports = Runnable;
 
 /**
  * Initialize a new `Runnable` with the given `title` and callback `fn`.  Derived from [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
  *
- * @memberof Mocha
- * @public
  * @class
+ * @extends EventEmitter
  * @param {String} title
  * @param {Function} fn
  */
-function Runnable (title, fn) {
+function Runnable(title, fn) {
   this.title = title;
   this.fn = fn;
   this.body = (fn || '').toString();
@@ -71,7 +56,7 @@ utils.inherits(Runnable, EventEmitter);
  * @param {number|string} ms
  * @return {Runnable|number} ms or Runnable instance.
  */
-Runnable.prototype.timeout = function (ms) {
+Runnable.prototype.timeout = function(ms) {
   if (!arguments.length) {
     return this._timeout;
   }
@@ -97,7 +82,7 @@ Runnable.prototype.timeout = function (ms) {
  * @param {number|string} ms
  * @return {Runnable|number} ms or Runnable instance.
  */
-Runnable.prototype.slow = function (ms) {
+Runnable.prototype.slow = function(ms) {
   if (!arguments.length || typeof ms === 'undefined') {
     return this._slow;
   }
@@ -116,7 +101,7 @@ Runnable.prototype.slow = function (ms) {
  * @param {boolean} enabled
  * @return {Runnable|boolean} enabled or Runnable instance.
  */
-Runnable.prototype.enableTimeouts = function (enabled) {
+Runnable.prototype.enableTimeouts = function(enabled) {
   if (!arguments.length) {
     return this._enableTimeouts;
   }
@@ -132,7 +117,7 @@ Runnable.prototype.enableTimeouts = function (enabled) {
  * @public
  * @api public
  */
-Runnable.prototype.skip = function () {
+Runnable.prototype.skip = function() {
   throw new Pending('sync skip');
 };
 
@@ -141,7 +126,7 @@ Runnable.prototype.skip = function () {
  *
  * @api private
  */
-Runnable.prototype.isPending = function () {
+Runnable.prototype.isPending = function() {
   return this.pending || (this.parent && this.parent.isPending());
 };
 
@@ -150,7 +135,7 @@ Runnable.prototype.isPending = function () {
  * @return {boolean}
  * @private
  */
-Runnable.prototype.isFailed = function () {
+Runnable.prototype.isFailed = function() {
   return !this.isPending() && this.state === 'failed';
 };
 
@@ -159,7 +144,7 @@ Runnable.prototype.isFailed = function () {
  * @return {boolean}
  * @private
  */
-Runnable.prototype.isPassed = function () {
+Runnable.prototype.isPassed = function() {
   return !this.isPending() && this.state === 'passed';
 };
 
@@ -168,7 +153,7 @@ Runnable.prototype.isPassed = function () {
  *
  * @api private
  */
-Runnable.prototype.retries = function (n) {
+Runnable.prototype.retries = function(n) {
   if (!arguments.length) {
     return this._retries;
   }
@@ -180,7 +165,7 @@ Runnable.prototype.retries = function (n) {
  *
  * @api private
  */
-Runnable.prototype.currentRetry = function (n) {
+Runnable.prototype.currentRetry = function(n) {
   if (!arguments.length) {
     return this._currentRetry;
   }
@@ -196,7 +181,7 @@ Runnable.prototype.currentRetry = function (n) {
  * @api public
  * @return {string}
  */
-Runnable.prototype.fullTitle = function () {
+Runnable.prototype.fullTitle = function() {
   return this.titlePath().join(' ');
 };
 
@@ -208,7 +193,7 @@ Runnable.prototype.fullTitle = function () {
  * @api public
  * @return {string}
  */
-Runnable.prototype.titlePath = function () {
+Runnable.prototype.titlePath = function() {
   return this.parent.titlePath().concat([this.title]);
 };
 
@@ -217,7 +202,7 @@ Runnable.prototype.titlePath = function () {
  *
  * @api private
  */
-Runnable.prototype.clearTimeout = function () {
+Runnable.prototype.clearTimeout = function() {
   clearTimeout(this.timer);
 };
 
@@ -227,19 +212,23 @@ Runnable.prototype.clearTimeout = function () {
  * @api private
  * @return {string}
  */
-Runnable.prototype.inspect = function () {
-  return JSON.stringify(this, function (key, val) {
-    if (key[0] === '_') {
-      return;
-    }
-    if (key === 'parent') {
-      return '#<Suite>';
-    }
-    if (key === 'ctx') {
-      return '#<Context>';
-    }
-    return val;
-  }, 2);
+Runnable.prototype.inspect = function() {
+  return JSON.stringify(
+    this,
+    function(key, val) {
+      if (key[0] === '_') {
+        return;
+      }
+      if (key === 'parent') {
+        return '#<Suite>';
+      }
+      if (key === 'ctx') {
+        return '#<Context>';
+      }
+      return val;
+    },
+    2
+  );
 };
 
 /**
@@ -247,7 +236,7 @@ Runnable.prototype.inspect = function () {
  *
  * @api private
  */
-Runnable.prototype.resetTimeout = function () {
+Runnable.prototype.resetTimeout = function() {
   var self = this;
   var ms = this.timeout() || 1e9;
 
@@ -255,7 +244,7 @@ Runnable.prototype.resetTimeout = function () {
     return;
   }
   this.clearTimeout();
-  this.timer = setTimeout(function () {
+  this.timer = setTimeout(function() {
     if (!self._enableTimeouts) {
       return;
     }
@@ -270,7 +259,7 @@ Runnable.prototype.resetTimeout = function () {
  * @api private
  * @param {string[]} globals
  */
-Runnable.prototype.globals = function (globals) {
+Runnable.prototype.globals = function(globals) {
   if (!arguments.length) {
     return this._allowedGlobals;
   }
@@ -283,7 +272,7 @@ Runnable.prototype.globals = function (globals) {
  * @param {Function} fn
  * @api private
  */
-Runnable.prototype.run = function (fn) {
+Runnable.prototype.run = function(fn) {
   var self = this;
   var start = new Date();
   var ctx = this.ctx;
@@ -296,7 +285,7 @@ Runnable.prototype.run = function (fn) {
   }
 
   // called multiple times
-  function multiple (err) {
+  function multiple(err) {
     if (emitted) {
       return;
     }
@@ -311,7 +300,7 @@ Runnable.prototype.run = function (fn) {
   }
 
   // finished
-  function done (err) {
+  function done(err) {
     var ms = self.timeout();
     if (self.timedOut) {
       return;
@@ -338,7 +327,7 @@ Runnable.prototype.run = function (fn) {
     this.resetTimeout();
 
     // allows skip() to be used in an explicit async context
-    this.skip = function asyncSkip () {
+    this.skip = function asyncSkip() {
       done(new Pending('async skip call'));
       // halt execution.  the Runnable will be marked pending
       // by the previous call, and the uncaught handler will ignore
@@ -379,43 +368,53 @@ Runnable.prototype.run = function (fn) {
     done(utils.getError(err));
   }
 
-  function callFn (fn) {
+  function callFn(fn) {
     var result = fn.call(ctx);
     if (result && typeof result.then === 'function') {
       self.resetTimeout();
-      result
-        .then(function () {
+      result.then(
+        function() {
           done();
           // Return null so libraries like bluebird do not warn about
           // subsequently constructed Promises.
           return null;
         },
-        function (reason) {
+        function(reason) {
           done(reason || new Error('Promise rejected with no or falsy reason'));
-        });
+        }
+      );
     } else {
       if (self.asyncOnly) {
-        return done(new Error('--async-only option in use without declaring `done()` or returning a promise'));
+        return done(
+          new Error(
+            '--async-only option in use without declaring `done()` or returning a promise'
+          )
+        );
       }
 
       done();
     }
   }
 
-  function callFnAsync (fn) {
-    var result = fn.call(ctx, function (err) {
+  function callFnAsync(fn) {
+    var result = fn.call(ctx, function(err) {
       if (err instanceof Error || toString.call(err) === '[object Error]') {
         return done(err);
       }
       if (err) {
         if (Object.prototype.toString.call(err) === '[object Object]') {
-          return done(new Error('done() invoked with non-Error: ' +
-            JSON.stringify(err)));
+          return done(
+            new Error('done() invoked with non-Error: ' + JSON.stringify(err))
+          );
         }
         return done(new Error('done() invoked with non-Error: ' + err));
       }
       if (result && utils.isPromise(result)) {
-        return done(new Error('Resolution method is overspecified. Specify a callback *or* return a Promise; not both.'));
+        return done(
+          new Error(
+            'Resolution method is overspecified. Specify a callback *or* return a Promise; not both.'
+          )
+        );
       }
 
       done();
@@ -430,8 +429,11 @@ Runnable.prototype.run = function (fn) {
  * @returns {Error} a "timeout" error
  * @private
  */
-Runnable.prototype._timeoutError = function (ms) {
-  var msg = 'Timeout of ' + ms + 'ms exceeded. For async tests and hooks, ensure "done()" is called; if returning a Promise, ensure it resolves.';
+Runnable.prototype._timeoutError = function(ms) {
+  var msg =
+    'Timeout of ' +
+    ms +
+    'ms exceeded. For async tests and hooks, ensure "done()" is called; if returning a Promise, ensure it resolves.';
   if (this.file) {
     msg += ' (' + this.file + ')';
   }