mocha 11.7.4 → 11.7.6

package/lib/cli/config.js

@@ -1,4 +1,4 @@
-'use strict';
+"use strict";
 
 /**
  * Responsible for loading / finding Mocha's "rc" files.
@@ -7,12 +7,12 @@
  * @module
  */
 
-const fs = require('node:fs');
-const path = require('node:path');
-const debug = require('debug')('mocha:cli:config');
-const findUp = require('find-up');
-const {createUnparsableFileError} = require('../errors');
-const utils = require('../utils');
+const fs = require("node:fs");
+const path = require("node:path");
+const debug = require("debug")("mocha:cli:config");
+const findUp = require("find-up");
+const { createUnparsableFileError } = require("../errors");
+const utils = require("../utils");
 
 /**
  * These are the valid config files, in order of precedence;
@@ -22,12 +22,12 @@ const utils = require('../utils');
  * @private
  */
 exports.CONFIG_FILES = [
-  '.mocharc.cjs',
-  '.mocharc.js',
-  '.mocharc.yaml',
-  '.mocharc.yml',
-  '.mocharc.jsonc',
-  '.mocharc.json'
+  ".mocharc.cjs",
+  ".mocharc.js",
+  ".mocharc.yaml",
+  ".mocharc.yml",
+  ".mocharc.jsonc",
+  ".mocharc.json",
 ];
 
 /**
@@ -35,8 +35,9 @@ exports.CONFIG_FILES = [
  * returns an object (but could throw)
  */
 const parsers = (exports.parsers = {
-  yaml: filepath => require('js-yaml').load(fs.readFileSync(filepath, 'utf8')),
-  js: filepath => {
+  yaml: (filepath) =>
+    require("js-yaml").load(fs.readFileSync(filepath, "utf8")),
+  js: (filepath) => {
     let cwdFilepath;
     try {
       debug('parsers: load cwd-relative path: "%s"', path.resolve(filepath));
@@ -49,10 +50,10 @@ const parsers = (exports.parsers = {
       return require(filepath);
     }
   },
-  json: filepath =>
+  json: (filepath) =>
     JSON.parse(
-      require('strip-json-comments')(fs.readFileSync(filepath, 'utf8'))
-    )
+      require("strip-json-comments")(fs.readFileSync(filepath, "utf8")),
+    ),
 });
 
 /**
@@ -63,15 +64,15 @@ const parsers = (exports.parsers = {
  * @param {string} filepath - Config file path to load
  * @returns {Object} Parsed config object
  */
-exports.loadConfig = filepath => {
+exports.loadConfig = (filepath) => {
   let config = {};
-  debug('loadConfig: trying to parse config at %s', filepath);
+  debug("loadConfig: trying to parse config at %s", filepath);
 
   const ext = path.extname(filepath);
   try {
-    if (ext === '.yml' || ext === '.yaml') {
+    if (ext === ".yml" || ext === ".yaml") {
       config = parsers.yaml(filepath);
-    } else if (ext === '.js' || ext === '.cjs') {
+    } else if (ext === ".js" || ext === ".cjs") {
       config = parsers.js(filepath);
     } else {
       config = parsers.json(filepath);
@@ -79,7 +80,7 @@ exports.loadConfig = filepath => {
   } catch (err) {
     throw createUnparsableFileError(
       `Unable to read/parse ${filepath}: ${err}`,
-      filepath
+      filepath,
     );
   }
   return config;
@@ -92,9 +93,9 @@ exports.loadConfig = filepath => {
  * @returns {string|null} Filepath to config, if found
  */
 exports.findConfig = (cwd = utils.cwd()) => {
-  const filepath = findUp.sync(exports.CONFIG_FILES, {cwd});
+  const filepath = findUp.sync(exports.CONFIG_FILES, { cwd });
   if (filepath) {
-    debug('findConfig: found config file %s', filepath);
+    debug("findConfig: found config file %s", filepath);
   }
   return filepath;
 };

package/lib/cli/index.js

@@ -1,3 +1,3 @@
-'use strict';
+"use strict";
 
-module.exports = require('./cli');
+module.exports = require("./cli");

package/lib/cli/init.js

@@ -1,4 +1,4 @@
-'use strict';
+"use strict";
 
 /**
  * Command module for "init" command
@@ -7,30 +7,30 @@
  * @module
  */
 
-const fs = require('node:fs');
-const path = require('node:path');
+const fs = require("node:fs");
+const path = require("node:path");
 
-exports.command = 'init <path>';
+exports.command = "init <path>";
 
-exports.description = 'create a client-side Mocha setup at <path>';
+exports.description = "create a client-side Mocha setup at <path>";
 
-exports.builder = yargs =>
-  yargs.positional('path', {
-    type: 'string',
-    normalize: true
+exports.builder = (yargs) =>
+  yargs.positional("path", {
+    type: "string",
+    normalize: true,
   });
 
-exports.handler = argv => {
+exports.handler = (argv) => {
   const destdir = argv.path;
-  const srcdir = path.join(__dirname, '..', '..');
-  fs.mkdirSync(destdir, {recursive: true});
-  const css = fs.readFileSync(path.join(srcdir, 'mocha.css'));
-  const js = fs.readFileSync(path.join(srcdir, 'mocha.js'));
+  const srcdir = path.join(__dirname, "..", "..");
+  fs.mkdirSync(destdir, { recursive: true });
+  const css = fs.readFileSync(path.join(srcdir, "mocha.css"));
+  const js = fs.readFileSync(path.join(srcdir, "mocha.js"));
   const tmpl = fs.readFileSync(
-    path.join(srcdir, 'lib', 'browser', 'template.html')
+    path.join(srcdir, "lib", "browser", "template.html"),
   );
-  fs.writeFileSync(path.join(destdir, 'mocha.css'), css);
-  fs.writeFileSync(path.join(destdir, 'mocha.js'), js);
-  fs.writeFileSync(path.join(destdir, 'tests.spec.js'), '');
-  fs.writeFileSync(path.join(destdir, 'index.html'), tmpl);
+  fs.writeFileSync(path.join(destdir, "mocha.css"), css);
+  fs.writeFileSync(path.join(destdir, "mocha.js"), js);
+  fs.writeFileSync(path.join(destdir, "tests.spec.js"), "");
+  fs.writeFileSync(path.join(destdir, "index.html"), tmpl);
 };

package/lib/cli/lookup-files.js

@@ -1,17 +1,17 @@
-'use strict';
+"use strict";
 /**
  * Contains `lookupFiles`, which takes some globs/dirs/options and returns a list of files.
  * @module
  * @private
  */
 
-var fs = require('node:fs');
-var path = require('node:path');
-var glob = require('glob');
-var errors = require('../errors');
+var fs = require("node:fs");
+var path = require("node:path");
+var glob = require("glob");
+var errors = require("../errors");
 var createNoFilesMatchPatternError = errors.createNoFilesMatchPatternError;
 var createMissingArgumentError = errors.createMissingArgumentError;
-const debug = require('debug')('mocha:cli:lookup-files');
+const debug = require("debug")("mocha:cli:lookup-files");
 
 /**
  * Determines if pathname would be a "hidden" file (or directory) on UN*X.
@@ -28,7 +28,7 @@ const debug = require('debug')('mocha:cli:lookup-files');
  * @example
  * isHiddenOnUnix('.profile'); // => true
  */
-const isHiddenOnUnix = pathname => path.basename(pathname).startsWith('.');
+const isHiddenOnUnix = (pathname) => path.basename(pathname).startsWith(".");
 
 /**
  * Determines if pathname has a matching file extension.
@@ -46,8 +46,8 @@ const isHiddenOnUnix = pathname => path.basename(pathname).startsWith('.');
  */
 const hasMatchingExtname = (pathname, exts = []) =>
   exts
-    .map(ext => (ext.startsWith('.') ? ext : `.${ext}`))
-    .some(ext => pathname.endsWith(ext));
+    .map((ext) => (ext.startsWith(".") ? ext : `.${ext}`))
+    .some((ext) => pathname.endsWith(ext));
 
 /**
  * Lookup file names at the given `path`.
@@ -68,39 +68,39 @@ const hasMatchingExtname = (pathname, exts = []) =>
 module.exports = function lookupFiles(
   filepath,
   extensions = [],
-  recursive = false
+  recursive = false,
 ) {
   const files = [];
   let stat;
 
   if (!fs.existsSync(filepath)) {
     let pattern;
-    if (glob.hasMagic(filepath, {windowsPathsNoEscape: true})) {
+    if (glob.hasMagic(filepath, { windowsPathsNoEscape: true })) {
       // Handle glob as is without extensions
       pattern = filepath;
     } else {
       // glob pattern e.g. 'filepath+(.js|.ts)'
       const strExtensions = extensions
-        .map(ext => (ext.startsWith('.') ? ext : `.${ext}`))
-        .join('|');
+        .map((ext) => (ext.startsWith(".") ? ext : `.${ext}`))
+        .join("|");
       pattern = `${filepath}+(${strExtensions})`;
-      debug('looking for files using glob pattern: %s', pattern);
+      debug("looking for files using glob pattern: %s", pattern);
     }
     files.push(
       ...glob
         .sync(pattern, {
           nodir: true,
-          windowsPathsNoEscape: true
+          windowsPathsNoEscape: true,
         })
         // glob@8 and earlier sorted results in en; glob@9 depends on OS sorting.
         // This preserves the older glob behavior.
         // https://github.com/mochajs/mocha/pull/5250/files#r1840469747
-        .sort((a, b) => a.localeCompare(b, 'en'))
+        .sort((a, b) => a.localeCompare(b, "en")),
     );
     if (!files.length) {
       throw createNoFilesMatchPatternError(
         `Cannot find any files matching pattern "${filepath}"`,
-        filepath
+        filepath,
       );
     }
     return files;
@@ -118,7 +118,7 @@ module.exports = function lookupFiles(
   }
 
   // Handle directory
-  fs.readdirSync(filepath).forEach(dirent => {
+  fs.readdirSync(filepath).forEach((dirent) => {
     const pathname = path.join(filepath, dirent);
     let stat;
 
@@ -136,8 +136,8 @@ module.exports = function lookupFiles(
     if (!extensions.length) {
       throw createMissingArgumentError(
         `Argument '${extensions}' required when argument '${filepath}' is a directory`,
-        'extensions',
-        'array'
+        "extensions",
+        "array",
       );
     }
 

package/lib/cli/node-flags.js

@@ -1,4 +1,4 @@
-'use strict';
+"use strict";
 
 /**
  * Some settings and code related to Mocha's handling of Node.js/V8 flags.
@@ -7,15 +7,15 @@
  */
 
 const nodeFlags = process.allowedNodeEnvironmentFlags;
-const {isMochaFlag} = require('./run-option-metadata');
-const unparse = require('yargs-unparser');
+const { isMochaFlag } = require("./run-option-metadata");
+const unparse = require("yargs-unparser");
 
 /**
  * These flags are considered "debug" flags.
  * @see {@link impliesNoTimeouts}
  * @private
  */
-const debugFlags = new Set(['inspect', 'inspect-brk']);
+const debugFlags = new Set(["inspect", "inspect-brk"]);
 
 /**
  * Mocha has historical support for various `node` and V8 flags which might not
@@ -41,7 +41,7 @@ exports.isNodeFlag = (flag, bareword = true) => {
       return false;
     }
     // strip the leading dashes to match against subsequent checks
-    flag = flag.replace(/^--?/, '');
+    flag = flag.replace(/^--?/, "");
   }
   return (
     // check actual node flags from `process.allowedNodeEnvironmentFlags`,
@@ -50,7 +50,7 @@ exports.isNodeFlag = (flag, bareword = true) => {
     (!isMochaFlag(flag) && nodeFlags && nodeFlags.has(flag)) ||
     debugFlags.has(flag) ||
     /(?:preserve-symlinks(?:-main)?|harmony(?:[_-]|$)|(?:trace[_-].+$)|gc[_-]global$|es[_-]staging$|use[_-]strict$|v8[_-](?!options).+?$)/.test(
-      flag
+      flag,
     )
   );
 };
@@ -62,7 +62,7 @@ exports.isNodeFlag = (flag, bareword = true) => {
  * @returns {boolean}
  * @private
  */
-exports.impliesNoTimeouts = flag => debugFlags.has(flag);
+exports.impliesNoTimeouts = (flag) => debugFlags.has(flag);
 
 /**
  * All non-strictly-boolean arguments to node--those with values--must specify those values using `=`, e.g., `--inspect=0.0.0.0`.
@@ -72,14 +72,14 @@ exports.impliesNoTimeouts = flag => debugFlags.has(flag);
  * @returns {string[]} Unparsed arguments using `=` to specify values
  * @private
  */
-exports.unparseNodeFlags = opts => {
+exports.unparseNodeFlags = (opts) => {
   var args = unparse(opts);
   return args.length
     ? args
-        .join(' ')
+        .join(" ")
         .split(/\b/)
-        .map(arg => (arg === ' ' ? '=' : arg))
-        .join('')
-        .split(' ')
+        .map((arg) => (arg === " " ? "=" : arg))
+        .join("")
+        .split(" ")
     : [];
 };

package/lib/cli/one-and-dones.js

@@ -1,4 +1,4 @@
-'use strict';
+"use strict";
 
 /**
  * Contains "command" code for "one-and-dones"--options passed
@@ -8,7 +8,7 @@
  * @private
  */
 
-const Mocha = require('../mocha');
+const Mocha = require("../mocha");
 
 /**
  * Dumps a sorted list of the enumerable, lower-case keys of some object
@@ -17,21 +17,22 @@ const Mocha = require('../mocha');
  * @ignore
  * @private
  */
-const showKeys = obj => {
+const showKeys = (obj) => {
   console.log();
   const keys = Object.keys(obj);
   const maxKeyLength = keys.reduce((max, key) => Math.max(max, key.length), 0);
   keys
     .filter(
-      key => /^[a-z]/.test(key) && !obj[key].browserOnly && !obj[key].abstract
+      (key) =>
+        /^[a-z]/.test(key) && !obj[key].browserOnly && !obj[key].abstract,
     )
     .sort()
-    .forEach(key => {
+    .forEach((key) => {
       const description = obj[key].description;
       console.log(
         `    ${key.padEnd(maxKeyLength + 1)}${
-          description ? `- ${description}` : ''
-        }`
+          description ? `- ${description}` : ""
+        }`,
       );
     });
   console.log();
@@ -47,16 +48,16 @@ exports.ONE_AND_DONES = {
    * Dump list of built-in interfaces
    * @private
    */
-  'list-interfaces': () => {
+  "list-interfaces": () => {
     showKeys(Mocha.interfaces);
   },
   /**
    * Dump list of built-in reporters
    * @private
    */
-  'list-reporters': () => {
+  "list-reporters": () => {
     showKeys(Mocha.reporters);
-  }
+  },
 };
 
 /**
@@ -65,5 +66,5 @@ exports.ONE_AND_DONES = {
  * @private
  */
 exports.ONE_AND_DONE_ARGS = new Set(
-  ['help', 'h', 'version', 'V'].concat(Object.keys(exports.ONE_AND_DONES))
+  ["help", "h", "version", "V"].concat(Object.keys(exports.ONE_AND_DONES)),
 );

package/lib/cli/options.js

@@ -1,4 +1,4 @@
-'use strict';
+"use strict";
 
 /**
  * Main entry point for handling filesystem-based configuration,
@@ -7,28 +7,28 @@
  * @private
  */
 
-const fs = require('node:fs');
-const pc = require('picocolors');
-const yargsParser = require('yargs-parser');
+const fs = require("node:fs");
+const pc = require("picocolors");
+const yargsParser = require("yargs-parser");
 const {
   types,
   aliases,
   isMochaFlag,
-  expectedTypeForFlag
-} = require('./run-option-metadata');
-const {ONE_AND_DONE_ARGS} = require('./one-and-dones');
-const mocharc = require('../mocharc.json');
-const {list} = require('./run-helpers');
-const {loadConfig, findConfig} = require('./config');
-const findUp = require('find-up');
-const debug = require('debug')('mocha:cli:options');
-const {isNodeFlag} = require('./node-flags');
+  expectedTypeForFlag,
+} = require("./run-option-metadata");
+const { ONE_AND_DONE_ARGS } = require("./one-and-dones");
+const mocharc = require("../mocharc.json");
+const { list } = require("./run-helpers");
+const { loadConfig, findConfig } = require("./config");
+const findUp = require("find-up");
+const debug = require("debug")("mocha:cli:options");
+const { isNodeFlag } = require("./node-flags");
 const {
   createUnparsableFileError,
   createInvalidArgumentTypeError,
-  createUnsupportedError
-} = require('../errors');
-const {isNumeric} = require('../utils');
+  createUnsupportedError,
+} = require("../errors");
+const { isNumeric } = require("../utils");
 
 /**
  * The `yargs-parser` namespace
@@ -47,10 +47,10 @@ const {isNumeric} = require('../utils');
  * @private
  */
 const YARGS_PARSER_CONFIG = {
-  'combine-arrays': true,
-  'short-option-groups': false,
-  'dot-notation': false,
-  'strip-aliased': true
+  "combine-arrays": true,
+  "short-option-groups": false,
+  "dot-notation": false,
+  "strip-aliased": true,
 };
 
 /**
@@ -62,7 +62,7 @@ const YARGS_PARSER_CONFIG = {
  * @ignore
  */
 const configuration = Object.assign({}, YARGS_PARSER_CONFIG, {
-  'camel-case-expansion': false
+  "camel-case-expansion": false,
 });
 
 /**
@@ -73,22 +73,23 @@ const configuration = Object.assign({}, YARGS_PARSER_CONFIG, {
  * @private
  * @ignore
  */
-const globOptions = ['spec', 'ignore'];
+const globOptions = ["spec", "ignore"];
 const coerceOpts = Object.assign(
   types.array.reduce(
     (acc, arg) =>
       Object.assign(acc, {
-        [arg]: v => Array.from(new Set(globOptions.includes(arg) ? v : list(v)))
+        [arg]: (v) =>
+          Array.from(new Set(globOptions.includes(arg) ? v : list(v))),
       }),
-    {}
+    {},
   ),
   types.boolean
     .concat(types.string, types.number)
     .reduce(
       (acc, arg) =>
-        Object.assign(acc, {[arg]: v => (Array.isArray(v) ? v.pop() : v)}),
-      {}
-    )
+        Object.assign(acc, { [arg]: (v) => (Array.isArray(v) ? v.pop() : v) }),
+      {},
+    ),
 );
 
 /**
@@ -101,7 +102,7 @@ const coerceOpts = Object.assign(
  */
 const nargOpts = types.array
   .concat(types.string, types.number)
-  .reduce((acc, arg) => Object.assign(acc, {[arg]: 1}), {});
+  .reduce((acc, arg) => Object.assign(acc, { [arg]: 1 }), {});
 
 /**
  * Throws either "UNSUPPORTED" error or "INVALID_ARG_TYPE" error for numeric positional arguments.
@@ -114,13 +115,13 @@ const nargOpts = types.array
 const createErrorForNumericPositionalArg = (
   numericArg,
   allArgs,
-  parsedResult
+  parsedResult,
 ) => {
   // A flag for `numericArg` exists if:
   // 1. A mocha flag immediately preceeded the numericArg in `allArgs` array and
   // 2. `numericArg` value could not be assigned to this flag by `yargs-parser` because of incompatible datatype.
   const flag = allArgs.find((arg, index) => {
-    const normalizedArg = arg.replace(/^--?/, '');
+    const normalizedArg = arg.replace(/^--?/, "");
     return (
       isMochaFlag(arg) &&
       allArgs[index + 1] === String(numericArg) &&
@@ -132,11 +133,11 @@ const createErrorForNumericPositionalArg = (
     throw createInvalidArgumentTypeError(
       `Mocha flag '${flag}' given invalid option: '${numericArg}'`,
       numericArg,
-      expectedTypeForFlag(flag)
+      expectedTypeForFlag(flag),
     );
   } else {
     throw createUnsupportedError(
-      `Option ${numericArg} is unsupported by the mocha cli`
+      `Option ${numericArg} is unsupported by the mocha cli`,
     );
   }
 };
@@ -156,13 +157,13 @@ const parse = (args = [], defaultValues = {}, ...configObjects) => {
   // 3. to avoid explicitly defining the set of them, we tell yargs-parser they
   //    are ALL boolean flags.
   // 4. we can then reapply the values after yargs-parser is done.
-  const allArgs = Array.isArray(args) ? args : args.split(' ');
+  const allArgs = Array.isArray(args) ? args : args.split(" ");
   const nodeArgs = allArgs.reduce((acc, arg) => {
-    const pair = arg.split('=');
+    const pair = arg.split("=");
     let flag = pair[0];
     if (isNodeFlag(flag, false)) {
-      flag = flag.replace(/^--?/, '');
-      return acc.concat([[flag, arg.includes('=') ? pair[1] : true]]);
+      flag = flag.replace(/^--?/, "");
+      return acc.concat([[flag, arg.includes("=") ? pair[1] : true]]);
     }
     return acc;
   }, []);
@@ -177,19 +178,19 @@ const parse = (args = [], defaultValues = {}, ...configObjects) => {
     string: types.string,
     array: types.array,
     number: types.number,
-    boolean: types.boolean.concat(nodeArgs.map(pair => pair[0]))
+    boolean: types.boolean.concat(nodeArgs.map((pair) => pair[0])),
   });
   if (result.error) {
     console.error(pc.red(`Error: ${result.error.message}`));
     process.exit(1);
   }
 
-  const numericPositionalArg = result.argv._.find(arg => isNumeric(arg));
+  const numericPositionalArg = result.argv._.find((arg) => isNumeric(arg));
   if (numericPositionalArg) {
     createErrorForNumericPositionalArg(
       numericPositionalArg,
       allArgs,
-      result.argv
+      result.argv,
     );
   }
 
@@ -236,33 +237,32 @@ const loadPkgRc = (args = {}) => {
   if (filepath) {
     let configData;
     try {
-      configData = fs.readFileSync(filepath, 'utf8');
+      configData = fs.readFileSync(filepath, "utf8");
     } catch (err) {
       // If `args.package` was explicitly specified, throw an error
       if (filepath == args.package) {
         throw createUnparsableFileError(
           `Unable to read ${filepath}: ${err}`,
-          filepath
+          filepath,
         );
       } else {
-        debug('failed to read default package.json at %s; ignoring',
-              filepath);
+        debug("failed to read default package.json at %s; ignoring", filepath);
         return result;
       }
     }
     try {
       const pkg = JSON.parse(configData);
       if (pkg.mocha) {
-        debug('`mocha` prop of package.json parsed: %O', pkg.mocha);
+        debug("`mocha` prop of package.json parsed: %O", pkg.mocha);
         result = pkg.mocha;
       } else {
-        debug('no config found in %s', filepath);
+        debug("no config found in %s", filepath);
       }
     } catch (err) {
       // If JSON failed to parse, throw an error.
       throw createUnparsableFileError(
         `Unable to parse ${filepath}: ${err}`,
-        filepath
+        filepath,
       );
     }
   }
@@ -293,13 +293,13 @@ const loadOptions = (argv = []) => {
   if (
     Array.from(ONE_AND_DONE_ARGS).reduce(
       (acc, arg) => acc || arg in args,
-      false
+      false,
     )
   ) {
     return args;
   }
 
-  const envConfig = parse(process.env.MOCHA_OPTIONS || '');
+  const envConfig = parse(process.env.MOCHA_OPTIONS || "");
   const rcConfig = loadRc(args);
   const pkgConfig = loadPkgRc(args);
 
@@ -318,7 +318,7 @@ const loadOptions = (argv = []) => {
     args,
     envConfig,
     rcConfig || {},
-    pkgConfig || {}
+    pkgConfig || {},
   );
 
   // recombine positional arguments and "spec"