mocha 8.2.0 → 8.3.2

package/CHANGELOG.md

@@ -1,4 +1,59 @@
-# 8.2.0 / 2020-10-15
+# 8.3.2 / 2021-03-12
+
+## :bug: Fixes
+
+- [#4599](https://github.com/mochajs/mocha/issues/4599): Fix regression in `require` interface ([**@alexander-fenster**](https://github.com/alexander-fenster))
+
+## :book: Documentation
+
+- [#4601](https://github.com/mochajs/mocha/issues/4601): Add build to GH actions run ([**@christian-bromann**](https://github.com/christian-bromann))
+- [#4596](https://github.com/mochajs/mocha/issues/4596): Filter active sponsors/backers ([**@juergba**](https://github.com/juergba))
+- [#4225](https://github.com/mochajs/mocha/issues/4225): Update config file examples ([**@pkuczynski**](https://github.com/pkuczynski))
+
+# 8.3.1 / 2021-03-06
+
+## :bug: Fixes
+
+- [#4577](https://github.com/mochajs/mocha/issues/4577): Browser: fix `EvalError` caused by regenerator-runtime ([**@snoack**](https://github.com/snoack))
+- [#4574](https://github.com/mochajs/mocha/issues/4574): ESM: allow `import` from mocha in parallel mode ([**@nicojs**](https://github.com/nicojs))
+
+# 8.3.0 / 2021-02-11
+
+## :tada: Enhancements
+
+- [#4506](https://github.com/mochajs/mocha/issues/4506): Add error code for test timeout errors ([**@boneskull**](https://github.com/boneskull))
+- [#4112](https://github.com/mochajs/mocha/issues/4112): Add BigInt support to stringify util function ([**@JosejeSinohui**](https://github.com/JosejeSinohui))
+
+## :bug: Fixes
+
+- [#4557](https://github.com/mochajs/mocha/issues/4557): Add file location when SyntaxError happens in ESM ([**@giltayar**](https://github.com/giltayar))
+- [#4521](https://github.com/mochajs/mocha/issues/4521): Fix `require` error when bundling Mocha with Webpack ([**@devhazem**](https://github.com/devhazem))
+
+## :book: Documentation
+
+- [#4507](https://github.com/mochajs/mocha/issues/4507): Add support for typescript-style docstrings ([**@boneskull**](https://github.com/boneskull))
+- [#4503](https://github.com/mochajs/mocha/issues/4503): Add GH Actions workflow status badge ([**@outsideris**](https://github.com/outsideris))
+- [#4494](https://github.com/mochajs/mocha/issues/4494): Add example of generating tests dynamically with a closure ([**@maxwellgerber**](https://github.com/maxwellgerber))
+
+## :nut_and_bolt: Other
+
+- [#4556](https://github.com/mochajs/mocha/issues/4556): Upgrade all dependencies to latest stable ([**@AviVahl**](https://github.com/AviVahl))
+- [#4543](https://github.com/mochajs/mocha/issues/4543): Update dependencies yargs and yargs-parser ([**@juergba**](https://github.com/juergba))
+
+Also thanks to [**@outsideris**](https://github.com/outsideris) and [**@HyunSangHan**](https://github.com/HyunSangHan) for various fixes to our website and documentation.
+
+# 8.2.1 / 2020-11-02
+
+Fixed stuff.
+
+## :bug: Fixes
+
+- [#4489](https://github.com/mochajs/mocha/issues/4489): Fix problematic handling of otherwise-unhandled `Promise` rejections and erroneous "`done()` called twice" errors ([**@boneskull**](https://github.com/boneskull))
+- [#4496](https://github.com/mochajs/mocha/issues/4496): Avoid `MaxListenersExceededWarning` in watch mode ([**@boneskull**](https://github.com/boneskull))
+
+Also thanks to [**@akeating**](https://github.com/akeating) for a documentation fix!
+
+# 8.2.0 / 2020-10-16
 
 The major feature added in v8.2.0 is addition of support for [_global fixtures_](https://mochajs.org/#global-fixtures).
 

package/LICENSE

@@ -1,6 +1,6 @@
 (The MIT License)
 
-Copyright (c) 2011-2020 OpenJS Foundation and contributors, https://openjsf.org
+Copyright (c) 2011-2021 OpenJS Foundation and contributors, https://openjsf.org
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

package/README.md

@@ -4,10 +4,19 @@
 
 <p align="center">☕️ Simple, flexible, fun JavaScript test framework for Node.js & The Browser ☕️</p>
 
-<p align="center"><a href="http://travis-ci.org/mochajs/mocha"><img src="https://api.travis-ci.org/mochajs/mocha.svg?branch=master" alt="Build Status"></a>  <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>
+<p align="center">
+<a href="https://github.com/mochajs/mocha/actions?query=workflow%3ATests+branch%3Amaster"><img src="https://github.com/mochajs/mocha/workflows/Tests/badge.svg?branch=master" alt="GitHub Actions Build Status"></a>
+<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>
 </p>
 
-<p align="center"><a href="https://www.npmjs.com/package/mocha"><img src="https://img.shields.io/npm/v/mocha.svg" alt="NPM Version"></a>  <a href="https://github.com/mochajs/mocha"><img src="https://img.shields.io/node/v/mocha.svg" alt="Node Version"></a></p>
+<p align="center">
+<a href="https://www.npmjs.com/package/mocha"><img src="https://img.shields.io/npm/v/mocha.svg" alt="NPM Version"></a>
+<a href="https://github.com/mochajs/mocha"><img src="https://img.shields.io/node/v/mocha.svg" alt="Node Version"></a>
+</p>
 
 <p align="center"><br><img alt="Mocha Browser Support h/t SauceLabs" src="https://saucelabs.com/browser-matrix/mochajs.svg" width="354"></p>
 
@@ -102,6 +111,6 @@ Finally, come [chat with the maintainers](https://gitter.im/mochajs/contributors
 
 ## License
 
-Copyright 2011-2020 OpenJS Foundation and contributors. Licensed [MIT](https://github.com/mochajs/mocha/blob/master/LICENSE).
+Copyright 2011-2021 OpenJS Foundation and contributors. Licensed [MIT](https://github.com/mochajs/mocha/blob/master/LICENSE).
 
 [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmochajs%2Fmocha.svg?type=large)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmochajs%2Fmocha?ref=badge_large)

package/bin/mocha

@@ -36,8 +36,6 @@ const disableTimeouts = value => {
   if (impliesNoTimeouts(value)) {
     debug('option %s disabled timeouts', value);
     mochaArgs.timeout = 0;
-    delete mochaArgs.timeouts;
-    delete mochaArgs.t;
   }
 };
 
@@ -93,7 +91,6 @@ if (mochaArgs.require && mochaArgs.require.includes('esm')) {
   if (!mochaArgs.require.length) {
     delete mochaArgs.require;
   }
-  delete mochaArgs.r;
 }
 
 if (Object.keys(nodeArgs).length) {

package/lib/browser/growl.js

@@ -125,7 +125,7 @@ function display(runner) {
     cross: '\u274C',
     tick: '\u2705'
   };
-  var logo = require('../../package').notifyLogo;
+  var logo = require('../../package.json').notifyLogo;
   var _message;
   var message;
   var title;

package/lib/cli/collect-files.js

@@ -6,6 +6,7 @@ const debug = require('debug')('mocha:cli:run:helpers');
 const minimatch = require('minimatch');
 const {NO_FILES_MATCH_PATTERN} = require('../errors').constants;
 const lookupFiles = require('./lookup-files');
+const {castArray} = require('../utils');
 
 /**
  * Exports a function that collects test files from CLI parameters.
@@ -21,45 +22,44 @@ const lookupFiles = require('./lookup-files');
  * @returns {string[]} List of files to test
  * @private
  */
-module.exports = ({ignore, extension, file, recursive, sort, spec} = {}) => {
-  let files = [];
+module.exports = ({
+  ignore,
+  extension,
+  file: fileArgs,
+  recursive,
+  sort,
+  spec
+} = {}) => {
   const unmatched = [];
-  spec.forEach(arg => {
-    let newFiles;
+  const specFiles = spec.reduce((specFiles, arg) => {
     try {
-      newFiles = lookupFiles(arg, extension, recursive);
+      const moreSpecFiles = castArray(lookupFiles(arg, extension, recursive))
+        .filter(filename =>
+          ignore.every(pattern => !minimatch(filename, pattern))
+        )
+        .map(filename => path.resolve(filename));
+      return [...specFiles, ...moreSpecFiles];
     } catch (err) {
       if (err.code === NO_FILES_MATCH_PATTERN) {
         unmatched.push({message: err.message, pattern: err.pattern});
-        return;
+        return specFiles;
       }
 
       throw err;
     }
-
-    if (typeof newFiles !== 'undefined') {
-      if (typeof newFiles === 'string') {
-        newFiles = [newFiles];
-      }
-      newFiles = newFiles.filter(fileName =>
-        ignore.every(pattern => !minimatch(fileName, pattern))
-      );
-    }
-
-    files = files.concat(newFiles);
-  });
-
-  const fileArgs = file.map(filepath => path.resolve(filepath));
-  files = files.map(filepath => path.resolve(filepath));
+  }, []);
 
   // ensure we don't sort the stuff from fileArgs; order is important!
   if (sort) {
-    files.sort();
+    specFiles.sort();
   }
 
   // add files given through --file to be ran first
-  files = fileArgs.concat(files);
-  debug('files (in order): ', files);
+  const files = [
+    ...fileArgs.map(filepath => path.resolve(filepath)),
+    ...specFiles
+  ];
+  debug('test files (in order): ', files);
 
   if (!files.length) {
     // give full message details when only 1 file is missing
@@ -70,7 +70,7 @@ module.exports = ({ignore, extension, file, recursive, sort, spec} = {}) => {
     console.error(ansi.red(noneFoundMsg));
     process.exit(1);
   } else {
-    // print messages as an warning
+    // print messages as a warning
     unmatched.forEach(warning => {
       console.warn(ansi.yellow(`Warning: ${warning.message}`));
     });

package/lib/cli/config.js

@@ -38,8 +38,7 @@ const isModuleNotFoundError = err =>
  * returns an object (but could throw)
  */
 const parsers = (exports.parsers = {
-  yaml: filepath =>
-    require('js-yaml').safeLoad(fs.readFileSync(filepath, 'utf8')),
+  yaml: filepath => require('js-yaml').load(fs.readFileSync(filepath, 'utf8')),
   js: filepath => {
     const cwdFilepath = path.resolve(filepath);
     try {

package/lib/cli/options.js

@@ -38,7 +38,8 @@ const {isNodeFlag} = require('./node-flags');
 const YARGS_PARSER_CONFIG = {
   'combine-arrays': true,
   'short-option-groups': false,
-  'dot-notation': false
+  'dot-notation': false,
+  'strip-aliased': true
 };
 
 /**

package/lib/cli/watch-run.js

@@ -41,6 +41,9 @@ exports.watchParallelRun = (
       // I don't know why we're cloning the root suite.
       const rootSuite = mocha.suite.clone();
 
+      // ensure we aren't leaking event listeners
+      mocha.dispose();
+
       // this `require` is needed because the require cache has been cleared.  the dynamic
       // exports set via the below call to `mocha.ui()` won't work properly if a
       // test depends on this module (see `required-tokens.spec.js`).
@@ -100,6 +103,9 @@ exports.watchRun = (mocha, {watchFiles, watchIgnore}, fileCollectParams) => {
       // I don't know why we're cloning the root suite.
       const rootSuite = mocha.suite.clone();
 
+      // ensure we aren't leaking event listeners
+      mocha.dispose();
+
       // this `require` is needed because the require cache has been cleared.  the dynamic
       // exports set via the below call to `mocha.ui()` won't work properly if a
       // test depends on this module (see `required-tokens.spec.js`).

package/lib/errors.js

@@ -17,6 +17,7 @@ const emitWarning = (msg, type) => {
   if (process.emitWarning) {
     process.emitWarning(msg, type);
   } else {
+    /* istanbul ignore next */
     process.nextTick(function() {
       console.warn(type + ': ' + msg);
     });
@@ -53,86 +54,129 @@ const warn = msg => {
 };
 
 /**
- * When Mocha throw exceptions (or otherwise errors), it attempts to assign a
- * `code` property to the `Error` object, for easier handling.  These are the
- * potential values of `code`.
+ * When Mocha throws exceptions (or rejects `Promise`s), it attempts to assign a `code` property to the `Error` object, for easier handling. These are the potential values of `code`.
+ * @public
+ * @namespace
+ * @memberof module:lib/errors
  */
 var constants = {
   /**
    * An unrecoverable error.
+   * @constant
+   * @default
    */
   FATAL: 'ERR_MOCHA_FATAL',
 
   /**
    * The type of an argument to a function call is invalid
+   * @constant
+   * @default
    */
   INVALID_ARG_TYPE: 'ERR_MOCHA_INVALID_ARG_TYPE',
 
   /**
    * The value of an argument to a function call is invalid
+   * @constant
+   * @default
    */
   INVALID_ARG_VALUE: 'ERR_MOCHA_INVALID_ARG_VALUE',
 
   /**
    * Something was thrown, but it wasn't an `Error`
+   * @constant
+   * @default
    */
   INVALID_EXCEPTION: 'ERR_MOCHA_INVALID_EXCEPTION',
 
   /**
    * An interface (e.g., `Mocha.interfaces`) is unknown or invalid
+   * @constant
+   * @default
    */
   INVALID_INTERFACE: 'ERR_MOCHA_INVALID_INTERFACE',
 
   /**
    * A reporter (.e.g, `Mocha.reporters`) is unknown or invalid
+   * @constant
+   * @default
    */
   INVALID_REPORTER: 'ERR_MOCHA_INVALID_REPORTER',
 
   /**
    * `done()` was called twice in a `Test` or `Hook` callback
+   * @constant
+   * @default
    */
   MULTIPLE_DONE: 'ERR_MOCHA_MULTIPLE_DONE',
 
   /**
    * No files matched the pattern provided by the user
+   * @constant
+   * @default
    */
   NO_FILES_MATCH_PATTERN: 'ERR_MOCHA_NO_FILES_MATCH_PATTERN',
 
   /**
    * Known, but unsupported behavior of some kind
+   * @constant
+   * @default
    */
   UNSUPPORTED: 'ERR_MOCHA_UNSUPPORTED',
 
   /**
    * Invalid state transition occurring in `Mocha` instance
+   * @constant
+   * @default
    */
   INSTANCE_ALREADY_RUNNING: 'ERR_MOCHA_INSTANCE_ALREADY_RUNNING',
 
   /**
    * Invalid state transition occurring in `Mocha` instance
+   * @constant
+   * @default
    */
   INSTANCE_ALREADY_DISPOSED: 'ERR_MOCHA_INSTANCE_ALREADY_DISPOSED',
 
   /**
    * Use of `only()` w/ `--forbid-only` results in this error.
+   * @constant
+   * @default
    */
   FORBIDDEN_EXCLUSIVITY: 'ERR_MOCHA_FORBIDDEN_EXCLUSIVITY',
 
   /**
    * To be thrown when a user-defined plugin implementation (e.g., `mochaHooks`) is invalid
+   * @constant
+   * @default
    */
   INVALID_PLUGIN_IMPLEMENTATION: 'ERR_MOCHA_INVALID_PLUGIN_IMPLEMENTATION',
 
   /**
    * To be thrown when a builtin or third-party plugin definition (the _definition_ of `mochaHooks`) is invalid
+   * @constant
+   * @default
+   */
+  INVALID_PLUGIN_DEFINITION: 'ERR_MOCHA_INVALID_PLUGIN_DEFINITION',
+
+  /**
+   * When a runnable exceeds its allowed run time.
+   * @constant
+   * @default
    */
-  INVALID_PLUGIN_DEFINITION: 'ERR_MOCHA_INVALID_PLUGIN_DEFINITION'
+  TIMEOUT: 'ERR_MOCHA_TIMEOUT'
 };
 
+/**
+ * A set containing all string values of all Mocha error constants, for use by {@link isMochaError}.
+ * @private
+ */
+const MOCHA_ERRORS = new Set(Object.values(constants));
+
 /**
  * Creates an error object to be thrown when no files to be tested could be found using specified pattern.
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @param {string} pattern - User-specified argument value.
  * @returns {Error} instance detailing the error condition
@@ -163,6 +207,7 @@ function createInvalidReporterError(message, reporter) {
  * Creates an error object to be thrown when the interface specified in the options was not found.
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @param {string} ui - User-specified interface value.
  * @returns {Error} instance detailing the error condition
@@ -178,6 +223,7 @@ function createInvalidInterfaceError(message, ui) {
  * Creates an error object to be thrown when a behavior, option, or parameter is unsupported.
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @returns {Error} instance detailing the error condition
  */
@@ -191,6 +237,7 @@ function createUnsupportedError(message) {
  * Creates an error object to be thrown when an argument is missing.
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @param {string} argument - Argument name.
  * @param {string} expected - Expected argument datatype.
@@ -204,6 +251,7 @@ function createMissingArgumentError(message, argument, expected) {
  * Creates an error object to be thrown when an argument did not use the supported type
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @param {string} argument - Argument name.
  * @param {string} expected - Expected argument datatype.
@@ -222,6 +270,7 @@ function createInvalidArgumentTypeError(message, argument, expected) {
  * Creates an error object to be thrown when an argument did not use the supported value
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @param {string} argument - Argument name.
  * @param {string} value - Argument value.
@@ -241,6 +290,7 @@ function createInvalidArgumentValueError(message, argument, value, reason) {
  * Creates an error object to be thrown when an exception was caught, but the `Error` is falsy or undefined.
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @returns {Error} instance detailing the error condition
  */
@@ -256,6 +306,7 @@ function createInvalidExceptionError(message, value) {
  * Creates an error object to be thrown when an unrecoverable error occurs.
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @returns {Error} instance detailing the error condition
  */
@@ -274,6 +325,7 @@ function createFatalError(message, value) {
  * @param {string} [pluginId] - Name/path of plugin, if any
  * @throws When `pluginType` is not known
  * @public
+ * @static
  * @returns {Error}
  */
 function createInvalidLegacyPluginError(message, pluginType, pluginId) {
@@ -295,6 +347,7 @@ function createInvalidLegacyPluginError(message, pluginType, pluginId) {
  * @param {string} [pluginId] - Name/path of plugin, if any
  * @throws When `pluginType` is not known
  * @public
+ * @static
  * @returns {Error}
  */
 function createInvalidPluginError(...args) {
@@ -307,6 +360,7 @@ function createInvalidPluginError(...args) {
  * @param {string} message The error message to be displayed.
  * @param {boolean} cleanReferencesAfterRun the value of `cleanReferencesAfterRun`
  * @param {Mocha} instance the mocha instance that throw this error
+ * @static
  */
 function createMochaInstanceAlreadyDisposedError(
   message,
@@ -323,6 +377,8 @@ function createMochaInstanceAlreadyDisposedError(
 /**
  * Creates an error object to be thrown when a mocha object's `run` method is called while a test run is in progress.
  * @param {string} message The error message to be displayed.
+ * @static
+ * @public
  */
 function createMochaInstanceAlreadyRunningError(message, instance) {
   var err = new Error(message);
@@ -331,13 +387,14 @@ function createMochaInstanceAlreadyRunningError(message, instance) {
   return err;
 }
 
-/*
+/**
  * Creates an error object to be thrown when done() is called multiple times in a test
  *
  * @public
  * @param {Runnable} runnable - Original runnable
  * @param {Error} [originalErr] - Original error, if any
  * @returns {Error} instance detailing the error condition
+ * @static
  */
 function createMultipleDoneError(runnable, originalErr) {
   var title;
@@ -371,6 +428,7 @@ function createMultipleDoneError(runnable, originalErr) {
 /**
  * Creates an error object to be thrown when `.only()` is used with
  * `--forbid-only`.
+ * @static
  * @public
  * @param {Mocha} mocha - Mocha instance
  * @returns {Error} Error with code {@link constants.FORBIDDEN_EXCLUSIVITY}
@@ -387,6 +445,7 @@ function createForbiddenExclusivityError(mocha) {
 
 /**
  * Creates an error object to be thrown when a plugin definition is invalid
+ * @static
  * @param {string} msg - Error message
  * @param {PluginDefinition} [pluginDef] - Problematic plugin definition
  * @public
@@ -401,6 +460,7 @@ function createInvalidPluginDefinitionError(msg, pluginDef) {
 
 /**
  * Creates an error object to be thrown when a plugin implementation (user code) is invalid
+ * @static
  * @param {string} msg - Error message
  * @param {Object} [opts] - Plugin definition and user-supplied implementation
  * @param {PluginDefinition} [opts.pluginDef] - Plugin Definition
@@ -419,6 +479,33 @@ function createInvalidPluginImplementationError(
   return err;
 }
 
+/**
+ * Creates an error object to be thrown when a runnable exceeds its allowed run time.
+ * @static
+ * @param {string} msg - Error message
+ * @param {number} [timeout] - Timeout in ms
+ * @param {string} [file] - File, if given
+ * @returns {MochaTimeoutError}
+ */
+function createTimeoutError(msg, timeout, file) {
+  const err = new Error(msg);
+  err.code = constants.TIMEOUT;
+  err.timeout = timeout;
+  err.file = file;
+  return err;
+}
+
+/**
+ * Returns `true` if an error came out of Mocha.
+ * _Can suffer from false negatives, but not false positives._
+ * @static
+ * @public
+ * @param {*} err - Error, or anything
+ * @returns {boolean}
+ */
+const isMochaError = err =>
+  Boolean(err && typeof err === 'object' && MOCHA_ERRORS.has(err.code));
+
 module.exports = {
   constants,
   createFatalError,
@@ -437,7 +524,18 @@ module.exports = {
   createMochaInstanceAlreadyRunningError,
   createMultipleDoneError,
   createNoFilesMatchPatternError,
+  createTimeoutError,
   createUnsupportedError,
   deprecate,
+  isMochaError,
   warn
 };
+
+/**
+ * The error thrown when a Runnable times out
+ * @memberof module:lib/errors
+ * @typedef {Error} MochaTimeoutError
+ * @property {constants.TIMEOUT} code - Error code
+ * @property {number?} timeout Timeout in ms
+ * @property {string?} file Filepath, if given
+ */

package/lib/esm-utils.js

@@ -3,7 +3,29 @@ const url = require('url');
 
 const formattedImport = async file => {
   if (path.isAbsolute(file)) {
-    return import(url.pathToFileURL(file));
+    try {
+      return await import(url.pathToFileURL(file));
+    } catch (err) {
+      // This is a hack created because ESM in Node.js (at least in Node v15.5.1) does not emit
+      // the location of the syntax error in the error thrown.
+      // This is problematic because the user can't see what file has the problem,
+      // so we add the file location to the error.
+      // This `if` should be removed once Node.js fixes the problem.
+      if (
+        err instanceof SyntaxError &&
+        err.message &&
+        err.stack &&
+        !err.stack.includes(file)
+      ) {
+        const newErrorWithFilename = new SyntaxError(err.message);
+        newErrorWithFilename.stack = err.stack.replace(
+          /^SyntaxError/,
+          `SyntaxError[ @${file} ]`
+        );
+        throw newErrorWithFilename;
+      }
+      throw err;
+    }
   }
   return import(file);
 };