mocha 8.3.2 → 8.4.0

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+# 8.4.0 / 2021-05-07
+
+## :tada: Enhancements
+
+- [#4502](https://github.com/mochajs/mocha/issues/4502): CLI file parsing errors now have error codes ([**@evaline-ju**](https://github.com/evaline-ju))
+
+## :bug: Fixes
+
+- [#4614](https://github.com/mochajs/mocha/issues/4614): Watch: fix crash when reloading files ([**@outsideris**](https://github.com/outsideris))
+
+## :book: Documentation
+
+- [#4630](https://github.com/mochajs/mocha/issues/4630): Add `options.require` to Mocha constructor for `root hook` plugins on parallel runs ([**@juergba**](https://github.com/juergba))
+- [#4617](https://github.com/mochajs/mocha/issues/4617): Dynamically generating tests with `top-level await` and ESM test files ([**@juergba**](https://github.com/juergba))
+- [#4608](https://github.com/mochajs/mocha/issues/4608): Update default file extensions ([**@outsideris**](https://github.com/outsideris))
+
+Also thanks to [**@outsideris**](https://github.com/outsideris) for various improvements on our GH actions workflows.
+
 # 8.3.2 / 2021-03-12
 
 ## :bug: Fixes

package/README.md

@@ -9,8 +9,8 @@
 <a href="https://coveralls.io/github/mochajs/mocha"><img src="https://coveralls.io/repos/github/mochajs/mocha/badge.svg" alt="Coverage Status"></a>
 <a href="https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmochajs%2Fmocha?ref=badge_shield"><img src="https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmochajs%2Fmocha.svg?type=shield" alt="FOSSA Status"></a>
 <a href="https://gitter.im/mochajs/mocha?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge"><img src="https://badges.gitter.im/Join%20Chat.svg" alt="Gitter"></a>
-<a href="https://github.com/mochajs/mocha#backers"><img src="https://opencollective.com/mochajs/backers/badge.svg" alt="OpenCollective"></a>
-<a href="https://github.com/mochajs/mocha#sponsors"><img src="https://opencollective.com/mochajs/sponsors/badge.svg" alt="OpenCollective"></a>
+<a href="https://github.com/mochajs/mocha#sponsors"><img src="https://opencollective.com/mochajs/tiers/sponsors/badge.svg" alt="OpenCollective"></a>
+<a href="https://github.com/mochajs/mocha#backers"><img src="https://opencollective.com/mochajs/tiers/backers/badge.svg" alt="OpenCollective"></a>
 </p>
 
 <p align="center">
@@ -27,74 +27,28 @@
 - [Code of Conduct](https://github.com/mochajs/mocha/blob/master/.github/CODE_OF_CONDUCT.md)
 - [Contributing](https://github.com/mochajs/mocha/blob/master/.github/CONTRIBUTING.md)
 - [Gitter Chatroom](https://gitter.im/mochajs/mocha) (ask questions here!)
-- [Google Group](https://groups.google.com/group/mochajs)
 - [Issue Tracker](https://github.com/mochajs/mocha/issues)
 
 ## Backers
 
-[Become a backer](https://opencollective.com/mochajs#backer) and show your support to our open source project.
-
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/0/avatar)](https://opencollective.com/mochajs/backer/0/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/1/avatar)](https://opencollective.com/mochajs/backer/1/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/2/avatar)](https://opencollective.com/mochajs/backer/2/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/3/avatar)](https://opencollective.com/mochajs/backer/3/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/4/avatar)](https://opencollective.com/mochajs/backer/4/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/5/avatar)](https://opencollective.com/mochajs/backer/5/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/6/avatar)](https://opencollective.com/mochajs/backer/6/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/7/avatar)](https://opencollective.com/mochajs/backer/7/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/8/avatar)](https://opencollective.com/mochajs/backer/8/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/9/avatar)](https://opencollective.com/mochajs/backer/9/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/10/avatar)](https://opencollective.com/mochajs/backer/10/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/11/avatar)](https://opencollective.com/mochajs/backer/11/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/12/avatar)](https://opencollective.com/mochajs/backer/12/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/13/avatar)](https://opencollective.com/mochajs/backer/13/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/14/avatar)](https://opencollective.com/mochajs/backer/14/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/15/avatar)](https://opencollective.com/mochajs/backer/15/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/16/avatar)](https://opencollective.com/mochajs/backer/16/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/17/avatar)](https://opencollective.com/mochajs/backer/17/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/18/avatar)](https://opencollective.com/mochajs/backer/18/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/19/avatar)](https://opencollective.com/mochajs/backer/19/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/20/avatar)](https://opencollective.com/mochajs/backer/20/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/21/avatar)](https://opencollective.com/mochajs/backer/21/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/22/avatar)](https://opencollective.com/mochajs/backer/22/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/23/avatar)](https://opencollective.com/mochajs/backer/23/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/24/avatar)](https://opencollective.com/mochajs/backer/24/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/25/avatar)](https://opencollective.com/mochajs/backer/25/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/26/avatar)](https://opencollective.com/mochajs/backer/26/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/27/avatar)](https://opencollective.com/mochajs/backer/27/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/28/avatar)](https://opencollective.com/mochajs/backer/28/website)
-[![MochaJS Backer](https://opencollective.com/mochajs/backer/29/avatar)](https://opencollective.com/mochajs/backer/29/website)
+[Become a backer](https://opencollective.com/mochajs) and show your support to our open source project on [our site](https://mochajs.org/#backers).
+
+<a href="https://opencollective.com/mochajs"><img src="https://opencollective.com/mochajs/tiers/backers.svg?limit=30&button=false&avatarHeight=46&width=750"></a>
 
 ## Sponsors
 
-Does your company use Mocha? Ask your manager or marketing team if your company would be interested in supporting our project. Support will allow the maintainers to dedicate more time for maintenance and new features for everyone. Also, your company's logo will show [on GitHub](https://github.com/mochajs/mocha#readme) and on [our site](https://mochajs.org) - who doesn't want a little extra exposure? [Here's the info](https://opencollective.com/mochajs#sponsor).
-
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/0/avatar)](https://opencollective.com/mochajs/sponsor/0/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/1/avatar)](https://opencollective.com/mochajs/sponsor/1/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/2/avatar)](https://opencollective.com/mochajs/sponsor/2/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/3/avatar)](https://opencollective.com/mochajs/sponsor/3/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/4/avatar)](https://opencollective.com/mochajs/sponsor/4/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/5/avatar)](https://opencollective.com/mochajs/sponsor/5/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/6/avatar)](https://opencollective.com/mochajs/sponsor/6/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/7/avatar)](https://opencollective.com/mochajs/sponsor/7/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/8/avatar)](https://opencollective.com/mochajs/sponsor/8/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/9/avatar)](https://opencollective.com/mochajs/sponsor/9/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/10/avatar)](https://opencollective.com/mochajs/sponsor/10/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/11/avatar)](https://opencollective.com/mochajs/sponsor/11/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/12/avatar)](https://opencollective.com/mochajs/sponsor/12/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/13/avatar)](https://opencollective.com/mochajs/sponsor/13/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/14/avatar)](https://opencollective.com/mochajs/sponsor/14/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/15/avatar)](https://opencollective.com/mochajs/sponsor/15/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/16/avatar)](https://opencollective.com/mochajs/sponsor/16/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/17/avatar)](https://opencollective.com/mochajs/sponsor/17/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/18/avatar)](https://opencollective.com/mochajs/sponsor/18/website)
-[![MochaJS Sponsor](https://opencollective.com/mochajs/sponsor/19/avatar)](https://opencollective.com/mochajs/sponsor/19/website)
+Does your company use Mocha? Ask your manager or marketing team if your company would be interested in supporting our project. Support will allow the maintainers to dedicate more time for maintenance and new features for everyone. Also, your company's logo will show [on GitHub](https://github.com/mochajs/mocha#readme) and on [our site](https://mochajs.org#sponsors) - who doesn't want a little extra exposure? [Here's the info](https://opencollective.com/mochajs).
+
+[![MochaJS Sponsor](https://opencollective.com/mochajs/tiers/sponsors/0/avatar)](https://opencollective.com/mochajs/tiers/sponsors/0/website)
+[![MochaJS Sponsor](https://opencollective.com/mochajs/tiers/sponsors/1/avatar)](https://opencollective.com/mochajs/tiers/sponsors/1/website)
+[![MochaJS Sponsor](https://opencollective.com/mochajs/tiers/sponsors/2/avatar)](https://opencollective.com/mochajs/tiers/sponsors/2/website)
+[![MochaJS Sponsor](https://opencollective.com/mochajs/tiers/sponsors/3/avatar)](https://opencollective.com/mochajs/tiers/sponsors/3/website)
 
 ## Development
 
 You might want to know that:
 
-- Mocha is the _most-depended-upon_ module on npm (source: [libraries.io](https://libraries.io/search?order=desc&platforms=NPM&sort=dependents_count)), and
+- Mocha is one of the _most-depended-upon_ modules on npm (source: [libraries.io](https://libraries.io/search?order=desc&platforms=NPM&sort=dependents_count)), and
 - Mocha is an _independent_ open-source project, maintained exclusively by volunteers.
 
 You might want to help:

package/lib/cli/config.js

@@ -11,6 +11,7 @@ const fs = require('fs');
 const path = require('path');
 const debug = require('debug')('mocha:cli:config');
 const findUp = require('find-up');
+const {createUnparsableFileError} = require('../errors');
 const utils = require('../utils');
 
 /**
@@ -81,7 +82,10 @@ exports.loadConfig = filepath => {
       config = parsers.json(filepath);
     }
   } catch (err) {
-    throw new Error(`failed to parse config "${filepath}": ${err}`);
+    throw createUnparsableFileError(
+      `Unable to read/parse ${filepath}: ${err}`,
+      filepath
+    );
   }
   return config;
 };

package/lib/cli/options.js

@@ -18,6 +18,7 @@ const {loadConfig, findConfig} = require('./config');
 const findUp = require('find-up');
 const debug = require('debug')('mocha:cli:options');
 const {isNodeFlag} = require('./node-flags');
+const {createUnparsableFileError} = require('../errors');
 
 /**
  * The `yargs-parser` namespace
@@ -190,7 +191,10 @@ const loadPkgRc = (args = {}) => {
       }
     } catch (err) {
       if (args.package) {
-        throw new Error(`Unable to read/parse ${filepath}: ${err}`);
+        throw createUnparsableFileError(
+          `Unable to read/parse ${filepath}: ${err}`,
+          filepath
+        );
       }
       debug('failed to read default package.json at %s; ignoring', filepath);
     }

package/lib/cli/watch-run.js

@@ -261,17 +261,21 @@ const createRerunner = (mocha, watcher, {beforeRun} = {}) => {
   let rerunScheduled = false;
 
   const run = () => {
-    mocha = beforeRun ? beforeRun({mocha, watcher}) || mocha : mocha;
-    runner = mocha.run(() => {
-      debug('finished watch run');
-      runner = null;
-      blastCache(watcher);
-      if (rerunScheduled) {
-        rerun();
-      } else {
-        console.error(`${logSymbols.info} [mocha] waiting for changes...`);
-      }
-    });
+    try {
+      mocha = beforeRun ? beforeRun({mocha, watcher}) || mocha : mocha;
+      runner = mocha.run(() => {
+        debug('finished watch run');
+        runner = null;
+        blastCache(watcher);
+        if (rerunScheduled) {
+          rerun();
+        } else {
+          console.error(`${logSymbols.info} [mocha] waiting for changes...`);
+        }
+      });
+    } catch (e) {
+      console.error(e.stack);
+    }
   };
 
   const scheduleRun = () => {

package/lib/errors.js

@@ -163,7 +163,14 @@ var constants = {
    * @constant
    * @default
    */
-  TIMEOUT: 'ERR_MOCHA_TIMEOUT'
+  TIMEOUT: 'ERR_MOCHA_TIMEOUT',
+
+  /**
+   * Input file is not able to be parsed
+   * @constant
+   * @default
+   */
+  UNPARSABLE_FILE: 'ERR_MOCHA_UNPARSABLE_FILE'
 };
 
 /**
@@ -495,6 +502,20 @@ function createTimeoutError(msg, timeout, file) {
   return err;
 }
 
+/**
+ * Creates an error object to be thrown when file is unparsable
+ * @public
+ * @static
+ * @param {string} message - Error message to be displayed.
+ * @param {string} filename - File name
+ * @returns {Error} Error with code {@link constants.UNPARSABLE_FILE}
+ */
+function createUnparsableFileError(message, filename) {
+  var err = new Error(message);
+  err.code = constants.UNPARSABLE_FILE;
+  return err;
+}
+
 /**
  * Returns `true` if an error came out of Mocha.
  * _Can suffer from false negatives, but not false positives._
@@ -525,6 +546,7 @@ module.exports = {
   createMultipleDoneError,
   createNoFilesMatchPatternError,
   createTimeoutError,
+  createUnparsableFileError,
   createUnsupportedError,
   deprecate,
   isMochaError,

package/lib/interfaces/bdd.js

@@ -105,13 +105,6 @@ module.exports = function bddInterface(suite) {
     context.xit = context.xspecify = context.it.skip = function(title) {
       return context.it(title);
     };
-
-    /**
-     * Number of attempts to retry.
-     */
-    context.it.retries = function(n) {
-      context.retries(n);
-    };
   });
 };
 

package/lib/interfaces/common.js

@@ -187,15 +187,6 @@ module.exports = function(suites, context, mocha) {
        */
       skip: function(title) {
         context.test(title);
-      },
-
-      /**
-       * Number of retry attempts
-       *
-       * @param {number} n
-       */
-      retries: function(n) {
-        context.retries(n);
       }
     }
   };

package/lib/interfaces/qunit.js

@@ -92,7 +92,6 @@ module.exports = function qUnitInterface(suite) {
     };
 
     context.test.skip = common.test.skip;
-    context.test.retries = common.test.retries;
   });
 };
 

package/lib/interfaces/tdd.js

@@ -99,7 +99,6 @@ module.exports = function(suite) {
     };
 
     context.test.skip = common.test.skip;
-    context.test.retries = common.test.retries;
   });
 };
 

package/lib/mocha.js

@@ -180,10 +180,10 @@ exports.run = function(...args) {
  * @param {number} [options.slow] - Slow threshold value.
  * @param {number|string} [options.timeout] - Timeout threshold value.
  * @param {string} [options.ui] - Interface name.
- * @param {boolean} [options.parallel] - Run jobs in parallel
- * @param {number} [options.jobs] - Max number of worker processes for parallel runs
- * @param {MochaRootHookObject} [options.rootHooks] - Hooks to bootstrap the root
- * suite with
+ * @param {boolean} [options.parallel] - Run jobs in parallel.
+ * @param {number} [options.jobs] - Max number of worker processes for parallel runs.
+ * @param {MochaRootHookObject} [options.rootHooks] - Hooks to bootstrap the root suite with.
+ * @param {string[]} [options.require] - Pathname of `rootHooks` plugin for parallel runs.
  * @param {boolean} [options.isWorker] - Should be `true` if `Mocha` process is running in a worker process.
  */
 function Mocha(options = {}) {

package/mocha.js

@@ -19987,7 +19987,14 @@
 	   * @constant
 	   * @default
 	   */
-	  TIMEOUT: 'ERR_MOCHA_TIMEOUT'
+	  TIMEOUT: 'ERR_MOCHA_TIMEOUT',
+
+	  /**
+	   * Input file is not able to be parsed
+	   * @constant
+	   * @default
+	   */
+	  UNPARSABLE_FILE: 'ERR_MOCHA_UNPARSABLE_FILE'
 	};
 	/**
 	 * A set containing all string values of all Mocha error constants, for use by {@link isMochaError}.
@@ -20331,6 +20338,21 @@
 	  err.file = file;
 	  return err;
 	}
+	/**
+	 * Creates an error object to be thrown when file is unparsable
+	 * @public
+	 * @static
+	 * @param {string} message - Error message to be displayed.
+	 * @param {string} filename - File name
+	 * @returns {Error} Error with code {@link constants.UNPARSABLE_FILE}
+	 */
+
+
+	function createUnparsableFileError(message, filename) {
+	  var err = new Error(message);
+	  err.code = constants.UNPARSABLE_FILE;
+	  return err;
+	}
 	/**
 	 * Returns `true` if an error came out of Mocha.
 	 * _Can suffer from false negatives, but not false positives._
@@ -20364,6 +20386,7 @@
 	  createMultipleDoneError: createMultipleDoneError,
 	  createNoFilesMatchPatternError: createNoFilesMatchPatternError,
 	  createTimeoutError: createTimeoutError,
+	  createUnparsableFileError: createUnparsableFileError,
 	  createUnsupportedError: createUnsupportedError,
 	  deprecate: deprecate$1,
 	  isMochaError: isMochaError,
@@ -27190,7 +27213,7 @@
 	});
 
 	var name = "mocha";
-	var version$2 = "8.3.2";
+	var version$2 = "8.4.0";
 	var homepage = "https://mochajs.org/";
 	var notifyLogo = "https://ibin.co/4QuRuGjXvl36.png";
 	var _package = {
@@ -27784,15 +27807,6 @@
 	       */
 	      skip: function skip(title) {
 	        context.test(title);
-	      },
-
-	      /**
-	       * Number of retry attempts
-	       *
-	       * @param {number} n
-	       */
-	      retries: function retries(n) {
-	        context.retries(n);
 	      }
 	    }
 	  };
@@ -27898,14 +27912,6 @@
 	    context.xit = context.xspecify = context.it.skip = function (title) {
 	      return context.it(title);
 	    };
-	    /**
-	     * Number of attempts to retry.
-	     */
-
-
-	    context.it.retries = function (n) {
-	      context.retries(n);
-	    };
 	  });
 	};
 
@@ -28012,7 +28018,6 @@
 	    };
 
 	    context.test.skip = common.test.skip;
-	    context.test.retries = common.test.retries;
 	  });
 	};
 
@@ -28109,7 +28114,6 @@
 	    };
 
 	    context.test.skip = common.test.skip;
-	    context.test.retries = common.test.retries;
 	  });
 	};
 
@@ -28503,10 +28507,10 @@
 	   * @param {number} [options.slow] - Slow threshold value.
 	   * @param {number|string} [options.timeout] - Timeout threshold value.
 	   * @param {string} [options.ui] - Interface name.
-	   * @param {boolean} [options.parallel] - Run jobs in parallel
-	   * @param {number} [options.jobs] - Max number of worker processes for parallel runs
-	   * @param {MochaRootHookObject} [options.rootHooks] - Hooks to bootstrap the root
-	   * suite with
+	   * @param {boolean} [options.parallel] - Run jobs in parallel.
+	   * @param {number} [options.jobs] - Max number of worker processes for parallel runs.
+	   * @param {MochaRootHookObject} [options.rootHooks] - Hooks to bootstrap the root suite with.
+	   * @param {string[]} [options.require] - Pathname of `rootHooks` plugin for parallel runs.
 	   * @param {boolean} [options.isWorker] - Should be `true` if `Mocha` process is running in a worker process.
 	   */