mocha 9.0.3 → 9.1.0

package/mocha-es2018.js

@@ -1,4 +1,4 @@
-// mocha@9.0.3 in javascript ES2018
+// mocha@9.1.0 in javascript ES2018
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
   typeof define === 'function' && define.amd ? define(factory) :
@@ -146,38 +146,38 @@
   Item$1.prototype.run = function () {
       this.fun.apply(null, this.array);
   };
-  var title = 'browser';
-  var platform = 'browser';
-  var browser$3 = true;
-  var env = {};
-  var argv = [];
-  var version$1 = ''; // empty string to avoid regexp issues
-  var versions = {};
-  var release = {};
-  var config = {};
-
-  function noop() {}
-
-  var on = noop;
-  var addListener = noop;
-  var once = noop;
-  var off = noop;
-  var removeListener = noop;
-  var removeAllListeners = noop;
-  var emit = noop;
-
-  function binding(name) {
+  var title$1 = 'browser';
+  var platform$1 = 'browser';
+  var browser$4 = true;
+  var env$1 = {};
+  var argv$1 = [];
+  var version$2 = ''; // empty string to avoid regexp issues
+  var versions$1 = {};
+  var release$1 = {};
+  var config$1 = {};
+
+  function noop$1() {}
+
+  var on$1 = noop$1;
+  var addListener$1 = noop$1;
+  var once$1 = noop$1;
+  var off$1 = noop$1;
+  var removeListener$1 = noop$1;
+  var removeAllListeners$1 = noop$1;
+  var emit$1 = noop$1;
+
+  function binding$1(name) {
       throw new Error('process.binding is not supported');
   }
 
-  function cwd () { return '/' }
-  function chdir (dir) {
+  function cwd$1 () { return '/' }
+  function chdir$1 (dir) {
       throw new Error('process.chdir is not supported');
-  }function umask() { return 0; }
+  }function umask$1() { return 0; }
 
   // from https://github.com/kumavis/browser-process-hrtime/blob/master/index.js
   var performance$1 = global$1.performance || {};
-  var performanceNow =
+  var performanceNow$1 =
     performance$1.now        ||
     performance$1.mozNow     ||
     performance$1.msNow      ||
@@ -187,8 +187,8 @@
 
   // generate timestamp or delta
   // see http://nodejs.org/api/process.html#process_process_hrtime
-  function hrtime(previousTimestamp){
-    var clocktime = performanceNow.call(performance$1)*1e-3;
+  function hrtime$1(previousTimestamp){
+    var clocktime = performanceNow$1.call(performance$1)*1e-3;
     var seconds = Math.floor(clocktime);
     var nanoseconds = Math.floor((clocktime%1)*1e9);
     if (previousTimestamp) {
@@ -202,37 +202,37 @@
     return [seconds,nanoseconds]
   }
 
-  var startTime = new Date();
-  function uptime() {
+  var startTime$1 = new Date();
+  function uptime$1() {
     var currentTime = new Date();
-    var dif = currentTime - startTime;
+    var dif = currentTime - startTime$1;
     return dif / 1000;
   }
 
-  var process = {
+  var process$1 = {
     nextTick: nextTick$1,
-    title: title,
-    browser: browser$3,
-    env: env,
-    argv: argv,
-    version: version$1,
-    versions: versions,
-    on: on,
-    addListener: addListener,
-    once: once,
-    off: off,
-    removeListener: removeListener,
-    removeAllListeners: removeAllListeners,
-    emit: emit,
-    binding: binding,
-    cwd: cwd,
-    chdir: chdir,
-    umask: umask,
-    hrtime: hrtime,
-    platform: platform,
-    release: release,
-    config: config,
-    uptime: uptime
+    title: title$1,
+    browser: browser$4,
+    env: env$1,
+    argv: argv$1,
+    version: version$2,
+    versions: versions$1,
+    on: on$1,
+    addListener: addListener$1,
+    once: once$1,
+    off: off$1,
+    removeListener: removeListener$1,
+    removeAllListeners: removeAllListeners$1,
+    emit: emit$1,
+    binding: binding$1,
+    cwd: cwd$1,
+    chdir: chdir$1,
+    umask: umask$1,
+    hrtime: hrtime$1,
+    platform: platform$1,
+    release: release$1,
+    config: config$1,
+    uptime: uptime$1
   };
 
   var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
@@ -2815,16 +2815,97 @@
   Item.prototype.run = function () {
       this.fun.apply(null, this.array);
   };
+  var title = 'browser';
+  var platform = 'browser';
+  var browser$3 = true;
+  var env = {};
+  var argv = [];
+  var version$1 = ''; // empty string to avoid regexp issues
+  var versions = {};
+  var release = {};
+  var config = {};
+
+  function noop() {}
+
+  var on = noop;
+  var addListener = noop;
+  var once = noop;
+  var off = noop;
+  var removeListener = noop;
+  var removeAllListeners = noop;
+  var emit = noop;
+
+  function binding(name) {
+      throw new Error('process.binding is not supported');
+  }
+
+  function cwd () { return '/' }
+  function chdir (dir) {
+      throw new Error('process.chdir is not supported');
+  }function umask() { return 0; }
 
   // from https://github.com/kumavis/browser-process-hrtime/blob/master/index.js
   var performance = global$1.performance || {};
-  performance.now        ||
+  var performanceNow =
+    performance.now        ||
     performance.mozNow     ||
     performance.msNow      ||
     performance.oNow       ||
     performance.webkitNow  ||
     function(){ return (new Date()).getTime() };
 
+  // generate timestamp or delta
+  // see http://nodejs.org/api/process.html#process_process_hrtime
+  function hrtime(previousTimestamp){
+    var clocktime = performanceNow.call(performance)*1e-3;
+    var seconds = Math.floor(clocktime);
+    var nanoseconds = Math.floor((clocktime%1)*1e9);
+    if (previousTimestamp) {
+      seconds = seconds - previousTimestamp[0];
+      nanoseconds = nanoseconds - previousTimestamp[1];
+      if (nanoseconds<0) {
+        seconds--;
+        nanoseconds += 1e9;
+      }
+    }
+    return [seconds,nanoseconds]
+  }
+
+  var startTime = new Date();
+  function uptime() {
+    var currentTime = new Date();
+    var dif = currentTime - startTime;
+    return dif / 1000;
+  }
+
+  var browser$1$1 = {
+    nextTick: nextTick,
+    title: title,
+    browser: browser$3,
+    env: env,
+    argv: argv,
+    version: version$1,
+    versions: versions,
+    on: on,
+    addListener: addListener,
+    once: once,
+    off: off,
+    removeListener: removeListener,
+    removeAllListeners: removeAllListeners,
+    emit: emit,
+    binding: binding,
+    cwd: cwd,
+    chdir: chdir,
+    umask: umask,
+    hrtime: hrtime,
+    platform: platform,
+    release: release,
+    config: config,
+    uptime: uptime
+  };
+
+  var process = browser$1$1;
+
   var inherits$2;
   if (typeof Object.create === 'function'){
     inherits$2 = function inherits(ctor, superCtor) {
@@ -2900,10 +2981,18 @@
       };
     }
 
+    if (process.noDeprecation === true) {
+      return fn;
+    }
+
     var warned = false;
     function deprecated() {
       if (!warned) {
-        {
+        if (process.throwDeprecation) {
+          throw new Error(msg);
+        } else if (process.traceDeprecation) {
+          console.trace(msg);
+        } else {
           console.error(msg);
         }
         warned = true;
@@ -2918,7 +3007,7 @@
   var debugEnviron;
   function debuglog(set) {
     if (isUndefined(debugEnviron))
-      debugEnviron = '';
+      debugEnviron = process.env.NODE_DEBUG || '';
     set = set.toUpperCase();
     if (!debugs[set]) {
       if (new RegExp('\\b' + set + '\\b', 'i').test(debugEnviron)) {
@@ -10290,8 +10379,8 @@
    * @returns {Boolean} whether the current version of Node.JS supports ES Modules in a way that is compatible with Mocha
    */
   exports.supportsEsModules = function(partialSupport) {
-    if (!exports.isBrowser() && process.versions && process.versions.node) {
-      var versionFields = process.versions.node.split('.');
+    if (!exports.isBrowser() && process$1.versions && process$1.versions.node) {
+      var versionFields = process$1.versions.node.split('.');
       var major = +versionFields[0];
       var minor = +versionFields[1];
 
@@ -10310,7 +10399,7 @@
    * @private
    */
   exports.cwd = function cwd() {
-    return process.cwd();
+    return process$1.cwd();
   };
 
   /**
@@ -11058,8 +11147,8 @@
   	}
 
   	// If debug isn't set in LS, and we're in Electron, try to load $DEBUG
-  	if (!r && typeof process !== 'undefined' && 'env' in process) {
-  		r = process.env.DEBUG;
+  	if (!r && typeof process$1 !== 'undefined' && 'env' in process$1) {
+  		r = process$1.env.DEBUG;
   	}
 
   	return r;
@@ -11118,8 +11207,8 @@
    * @ignore
    */
   const emitWarning = (msg, type) => {
-    if (process.emitWarning) {
-      process.emitWarning(msg, type);
+    if (process$1.emitWarning) {
+      process$1.emitWarning(msg, type);
     } else {
       /* istanbul ignore next */
       nextTick$1(function() {
@@ -13045,10 +13134,11 @@
      * @public
      * @class
      * @param {Suite} suite - Root suite
-     * @param {Object|boolean} [opts] - Options. If `boolean` (deprecated), whether or not to delay execution of root suite until ready.
+     * @param {Object|boolean} [opts] - Options. If `boolean` (deprecated), whether to delay execution of root suite until ready.
+     * @param {boolean} [opts.cleanReferencesAfterRun] - Whether to clean references to test fns and hooks when a suite is done.
      * @param {boolean} [opts.delay] - Whether to delay execution of root suite until ready.
      * @param {boolean} [opts.dryRun] - Whether to report tests without running them.
-     * @param {boolean} [opts.cleanReferencesAfterRun] - Whether to clean references to test fns and hooks when a suite is done.
+     * @param {boolean} [options.failZero] - Whether to fail test run if zero tests encountered.
      */
     constructor(suite, opts) {
       super();
@@ -13105,14 +13195,14 @@
             'trapped unhandled rejection from (probably) user code; re-emitting on process'
           );
           this._removeEventListener(
-            process,
+            process$1,
             'unhandledRejection',
             this.unhandled
           );
           try {
-            process.emit('unhandledRejection', reason, promise);
+            process$1.emit('unhandledRejection', reason, promise);
           } finally {
-            this._addEventListener(process, 'unhandledRejection', this.unhandled);
+            this._addEventListener(process$1, 'unhandledRejection', this.unhandled);
           }
         }
       };
@@ -13954,6 +14044,8 @@
     fn = fn || function() {};
 
     const end = () => {
+      if (!this.total && this._opts.failZero) this.failures = 1;
+
       debug('run(): root suite completed; emitting %s', constants$1.EVENT_RUN_END);
       this.emit(constants$1.EVENT_RUN_END);
     };
@@ -13996,10 +14088,10 @@
       fn(this.failures);
     });
 
-    this._removeEventListener(process, 'uncaughtException', this.uncaught);
-    this._removeEventListener(process, 'unhandledRejection', this.unhandled);
-    this._addEventListener(process, 'uncaughtException', this.uncaught);
-    this._addEventListener(process, 'unhandledRejection', this.unhandled);
+    this._removeEventListener(process$1, 'uncaughtException', this.uncaught);
+    this._removeEventListener(process$1, 'unhandledRejection', this.unhandled);
+    this._addEventListener(process$1, 'uncaughtException', this.uncaught);
+    this._addEventListener(process$1, 'unhandledRejection', this.unhandled);
 
     if (this._delay) {
       // for reporters, I guess.
@@ -14214,7 +14306,7 @@
    * Check if both stdio streams are associated with a tty.
    */
 
-  var isatty = isBrowser || (process.stdout.isTTY && process.stderr.isTTY);
+  var isatty = isBrowser || (process$1.stdout.isTTY && process$1.stderr.isTTY);
 
   /**
    * Save log references to avoid tests interfering (see GH-3604).
@@ -14227,7 +14319,7 @@
 
   exports.useColors =
     !isBrowser &&
-    (require$$11.stdout || process.env.MOCHA_COLORS !== undefined);
+    (require$$11.stdout || process$1.env.MOCHA_COLORS !== undefined);
 
   /**
    * Inline diffs instead of +/-
@@ -14269,7 +14361,7 @@
 
   exports.symbols = {
     ok: browser$1.success,
-    err: browser$1.err,
+    err: browser$1.error,
     dot: '.',
     comma: ',',
     bang: '!'
@@ -14305,7 +14397,7 @@
     if (isBrowser) {
       exports.window.width = getBrowserWindowSize()[1];
     } else {
-      exports.window.width = process.stdout.getWindowSize(1)[0];
+      exports.window.width = process$1.stdout.getWindowSize(1)[0];
     }
   }
 
@@ -14315,19 +14407,19 @@
 
   exports.cursor = {
     hide: function() {
-      isatty && process.stdout.write('\u001b[?25l');
+      isatty && process$1.stdout.write('\u001b[?25l');
     },
 
     show: function() {
-      isatty && process.stdout.write('\u001b[?25h');
+      isatty && process$1.stdout.write('\u001b[?25h');
     },
 
     deleteLine: function() {
-      isatty && process.stdout.write('\u001b[2K');
+      isatty && process$1.stdout.write('\u001b[2K');
     },
 
     beginningOfLine: function() {
-      isatty && process.stdout.write('\u001b[0G');
+      isatty && process$1.stdout.write('\u001b[0G');
     },
 
     CR: function() {
@@ -14335,7 +14427,7 @@
         exports.cursor.deleteLine();
         exports.cursor.beginningOfLine();
       } else {
-        process.stdout.write('\r');
+        process$1.stdout.write('\r');
       }
     }
   };
@@ -14757,36 +14849,36 @@
     var n = -1;
 
     runner.on(EVENT_RUN_BEGIN, function() {
-      process.stdout.write('\n');
+      process$1.stdout.write('\n');
     });
 
     runner.on(EVENT_TEST_PENDING, function() {
       if (++n % width === 0) {
-        process.stdout.write('\n  ');
+        process$1.stdout.write('\n  ');
       }
-      process.stdout.write(base.color('pending', base.symbols.comma));
+      process$1.stdout.write(base.color('pending', base.symbols.comma));
     });
 
     runner.on(EVENT_TEST_PASS, function(test) {
       if (++n % width === 0) {
-        process.stdout.write('\n  ');
+        process$1.stdout.write('\n  ');
       }
       if (test.speed === 'slow') {
-        process.stdout.write(base.color('bright yellow', base.symbols.dot));
+        process$1.stdout.write(base.color('bright yellow', base.symbols.dot));
       } else {
-        process.stdout.write(base.color(test.speed, base.symbols.dot));
+        process$1.stdout.write(base.color(test.speed, base.symbols.dot));
       }
     });
 
     runner.on(EVENT_TEST_FAIL, function() {
       if (++n % width === 0) {
-        process.stdout.write('\n  ');
+        process$1.stdout.write('\n  ');
       }
-      process.stdout.write(base.color('fail', base.symbols.bang));
+      process$1.stdout.write(base.color('fail', base.symbols.bang));
     });
 
     runner.once(EVENT_RUN_END, function() {
-      process.stdout.write('\n');
+      process$1.stdout.write('\n');
       self.epilogue();
     });
   }
@@ -14998,7 +15090,7 @@
   function println(format, varArgs) {
     var vargs = Array.from(arguments);
     vargs[0] += '\n';
-    process.stdout.write(sprintf.apply(null, vargs));
+    process$1.stdout.write(sprintf.apply(null, vargs));
   }
 
   /**
@@ -15191,6 +15283,8 @@
   TAP.description = 'TAP-compatible output';
   });
 
+  var fs = {};
+
   var json = createCommonjsModule(function (module, exports) {
   /**
    * @module JSON
@@ -15200,12 +15294,16 @@
    */
 
 
+
+
+  const createUnsupportedError = errors.createUnsupportedError;
+
   var constants = runner.constants;
   var EVENT_TEST_PASS = constants.EVENT_TEST_PASS;
+  var EVENT_TEST_PENDING = constants.EVENT_TEST_PENDING;
   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`.
@@ -15223,7 +15321,7 @@
    * @param {Runner} runner - Instance triggers reporter actions.
    * @param {Object} [options] - runner options
    */
-  function JSONReporter(runner, options) {
+  function JSONReporter(runner, options = {}) {
     base.call(this, runner, options);
 
     var self = this;
@@ -15231,6 +15329,14 @@
     var pending = [];
     var failures = [];
     var passes = [];
+    var output;
+
+    if (options.reporterOption && options.reporterOption.output) {
+      if (utils.isBrowser()) {
+        throw createUnsupportedError('file output not supported in browser');
+      }
+      output = options.reporterOption.output;
+    }
 
     runner.on(EVENT_TEST_END, function(test) {
       tests.push(test);
@@ -15259,7 +15365,20 @@
 
       runner.testResults = obj;
 
-      process.stdout.write(JSON.stringify(obj, null, 2));
+      var json = JSON.stringify(obj, null, 2);
+      if (output) {
+        try {
+          fs.mkdirSync(path.dirname(output), {recursive: true});
+          fs.writeFileSync(output, json);
+        } catch (err) {
+          console.error(
+            `${base.symbols.err} [mocha] writing output to "${output}" failed: ${err.message}\n`
+          );
+          process$1.stdout.write(json);
+        }
+      } else {
+        process$1.stdout.write(json);
+      }
     });
   }
 
@@ -15891,7 +16010,7 @@
     });
 
     runner.on(EVENT_TEST_BEGIN, function(test) {
-      process.stdout.write(color('pass', '    ' + test.fullTitle() + ': '));
+      process$1.stdout.write(color('pass', '    ' + test.fullTitle() + ': '));
     });
 
     runner.on(EVENT_TEST_PENDING, function(test) {
@@ -15962,9 +16081,9 @@
 
     runner.on(EVENT_RUN_BEGIN, function() {
       // clear screen
-      process.stdout.write('\u001b[2J');
+      process$1.stdout.write('\u001b[2J');
       // set cursor position
-      process.stdout.write('\u001b[1;3H');
+      process$1.stdout.write('\u001b[1;3H');
     });
 
     runner.once(EVENT_RUN_END, this.epilogue.bind(this));
@@ -16351,7 +16470,7 @@
    * @param {string} string A message to write to stdout.
    */
   function write(string) {
-    process.stdout.write(string);
+    process$1.stdout.write(string);
   }
 
   NyanCat.description = '"nyan cat"';
@@ -16494,8 +16613,8 @@
   XUnit.prototype.write = function(line) {
     if (this.fileStream) {
       this.fileStream.write(line + '\n');
-    } else if (typeof process === 'object' && process.stdout) {
-      process.stdout.write(line + '\n');
+    } else if (typeof process$1 === 'object' && process$1.stdout) {
+      process$1.stdout.write(line + '\n');
     } else {
       base.consoleLog(line);
     }
@@ -16676,9 +16795,9 @@
     });
 
     runner.once(EVENT_RUN_END, function() {
-      process.stdout.write('# TOC\n');
-      process.stdout.write(generateTOC(runner.suite));
-      process.stdout.write(buf);
+      process$1.stdout.write('# TOC\n');
+      process$1.stdout.write(generateTOC(runner.suite));
+      process$1.stdout.write(buf);
     });
   }
 
@@ -16745,7 +16864,7 @@
 
     // tests started
     runner.on(EVENT_RUN_BEGIN, function() {
-      process.stdout.write('\n');
+      process$1.stdout.write('\n');
       cursor.hide();
     });
 
@@ -16764,13 +16883,13 @@
       lastN = n;
 
       cursor.CR();
-      process.stdout.write('\u001b[J');
-      process.stdout.write(color('progress', '  ' + options.open));
-      process.stdout.write(Array(n).join(options.complete));
-      process.stdout.write(Array(i).join(options.incomplete));
-      process.stdout.write(color('progress', options.close));
+      process$1.stdout.write('\u001b[J');
+      process$1.stdout.write(color('progress', '  ' + options.open));
+      process$1.stdout.write(Array(n).join(options.complete));
+      process$1.stdout.write(Array(i).join(options.incomplete));
+      process$1.stdout.write(color('progress', options.close));
       if (options.verbose) {
-        process.stdout.write(color('progress', ' ' + complete + ' of ' + total));
+        process$1.stdout.write(color('progress', ' ' + complete + ' of ' + total));
       }
     });
 
@@ -16778,7 +16897,7 @@
     // and the failures if any
     runner.once(EVENT_RUN_END, function() {
       cursor.show();
-      process.stdout.write('\n');
+      process$1.stdout.write('\n');
       self.epilogue();
     });
   }
@@ -16849,7 +16968,7 @@
 
     var self = this;
     var width = (base.window.width * 0.75) | 0;
-    var stream = process.stdout;
+    var stream = process$1.stdout;
 
     var plane = color('plane', '✈');
     var crashed = -1;
@@ -16888,15 +17007,15 @@
 
     runner.once(EVENT_RUN_END, function() {
       cursor.show();
-      process.stdout.write('\n');
+      process$1.stdout.write('\n');
       self.epilogue();
     });
 
     // if cursor is hidden when we ctrl-C, then it will remain hidden unless...
-    process.once('SIGINT', function() {
+    process$1.once('SIGINT', function() {
       cursor.show();
       nextTick$1(function() {
-        process.kill(process.pid, 'SIGINT');
+        process$1.kill(process$1.pid, 'SIGINT');
       });
     });
   }
@@ -16978,7 +17097,7 @@
    * @param {JSONStream~MochaEvent} event - Mocha event to be output.
    */
   function writeEvent(event) {
-    process.stdout.write(JSON.stringify(event) + '\n');
+    process$1.stdout.write(JSON.stringify(event) + '\n');
   }
 
   /**
@@ -17025,7 +17144,7 @@
   });
 
   var name = "mocha";
-  var version = "9.0.3";
+  var version = "9.1.0";
   var homepage = "https://mochajs.org/";
   var notifyLogo = "https://ibin.co/4QuRuGjXvl36.png";
   var _package = {
@@ -18274,6 +18393,7 @@
    * @param {boolean} [options.delay] - Delay root suite execution?
    * @param {boolean} [options.diff] - Show diff on failure?
    * @param {boolean} [options.dryRun] - Report tests without running them?
+   * @param {boolean} [options.failZero] - Fail test run if zero tests?
    * @param {string} [options.fgrep] - Test filter given string.
    * @param {boolean} [options.forbidOnly] - Tests marked `only` fail the suite?
    * @param {boolean} [options.forbidPending] - Pending tests fail the suite?
@@ -18333,6 +18453,7 @@
       'delay',
       'diff',
       'dryRun',
+      'failZero',
       'forbidOnly',
       'forbidPending',
       'fullTrace',
@@ -18691,7 +18812,7 @@
   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|)$|.*/);
+      var arg = re.match(/^\/(.*)\/([gimy]{0,4})$|.*/);
       this.options.grep = new RegExp(arg[1] || arg[0], arg[2]);
     } else {
       this.options.grep = re;
@@ -18888,20 +19009,6 @@
     return this;
   };
 
-  /**
-   * Enables or disables running tests in dry-run mode.
-   *
-   * @public
-   * @see [CLI option](../#-dry-run)
-   * @param {boolean} [dryRun=true] - Whether to activate dry-run mode.
-   * @return {Mocha} this
-   * @chainable
-   */
-  Mocha.prototype.dryRun = function(dryRun) {
-    this.options.dryRun = dryRun !== false;
-    return this;
-  };
-
   /**
    * @summary
    * Sets timeout threshold value.
@@ -19028,6 +19135,34 @@
     return this;
   };
 
+  /**
+   * Enables or disables running tests in dry-run mode.
+   *
+   * @public
+   * @see [CLI option](../#-dry-run)
+   * @param {boolean} [dryRun=true] - Whether to activate dry-run mode.
+   * @return {Mocha} this
+   * @chainable
+   */
+  Mocha.prototype.dryRun = function(dryRun) {
+    this.options.dryRun = dryRun !== false;
+    return this;
+  };
+
+  /**
+   * Fails test run if no tests encountered with exit-code 1.
+   *
+   * @public
+   * @see [CLI option](../#-fail-zero)
+   * @param {boolean} [failZero=true] - Whether to fail test run.
+   * @return {Mocha} this
+   * @chainable
+   */
+  Mocha.prototype.failZero = function(failZero) {
+    this.options.failZero = failZero !== false;
+    return this;
+  };
+
   /**
    * Causes tests marked `only` to fail the suite.
    *
@@ -19133,9 +19268,10 @@
     var options = this.options;
     options.files = this.files;
     const runner = new this._runnerClass(suite, {
+      cleanReferencesAfterRun: this._cleanReferencesAfterRun,
       delay: options.delay,
       dryRun: options.dryRun,
-      cleanReferencesAfterRun: this._cleanReferencesAfterRun
+      failZero: options.failZero
     });
     statsCollector(runner);
     var reporter = new this._reporter(runner, options);
@@ -19482,7 +19618,7 @@
    * Shim process.stdout.
    */
 
-  process.stdout = browserStdout({label: false});
+  process$1.stdout = browserStdout({label: false});
 
 
 
@@ -19515,7 +19651,7 @@
    * Revert to original onerror handler if previously defined.
    */
 
-  process.removeListener = function(e, fn) {
+  process$1.removeListener = function(e, fn) {
     if (e === 'uncaughtException') {
       if (originalOnerrorHandler) {
         commonjsGlobal.onerror = originalOnerrorHandler;
@@ -19533,7 +19669,7 @@
    * Implements listenerCount for 'uncaughtException'.
    */
 
-  process.listenerCount = function(name) {
+  process$1.listenerCount = function(name) {
     if (name === 'uncaughtException') {
       return uncaughtExceptionHandlers.length;
     }
@@ -19544,7 +19680,7 @@
    * Implements uncaughtException listener.
    */
 
-  process.on = function(e, fn) {
+  process$1.on = function(e, fn) {
     if (e === 'uncaughtException') {
       commonjsGlobal.onerror = function(err, url, line) {
         fn(new Error(err + ' (' + url + ':' + line + ')'));
@@ -19554,7 +19690,7 @@
     }
   };
 
-  process.listeners = function(e) {
+  process$1.listeners = function(e) {
     if (e === 'uncaughtException') {
       return uncaughtExceptionHandlers;
     }
@@ -19679,7 +19815,7 @@
    * https://github.com/mochajs/mocha/pull/916
    */
 
-  mocha$1.process = process;
+  mocha$1.process = process$1;
 
   /**
    * Expose mocha.