mocha 11.7.4 → 11.7.6

package/lib/utils.js

@@ -1,4 +1,4 @@
-'use strict';
+"use strict";
 
 /**
  * Various utility functions used throughout Mocha's codebase.
@@ -8,11 +8,11 @@
 /**
  * Module dependencies.
  */
-var path = require('node:path');
-var util = require('node:util');
-var he = require('he');
+var path = require("node:path");
+var util = require("node:util");
+var he = require("he");
 
-const MOCHA_ID_PROP_NAME = '__mocha_id__';
+const MOCHA_ID_PROP_NAME = "__mocha_id__";
 
 /**
  * Inherit the prototype methods from one constructor into another.
@@ -33,7 +33,7 @@ exports.inherits = util.inherits;
  * @return {string}
  */
 exports.escape = function (html) {
-  return he.encode(String(html), {useNamedReferences: false});
+  return he.encode(String(html), { useNamedReferences: false });
 };
 
 /**
@@ -44,7 +44,7 @@ exports.escape = function (html) {
  * @return {boolean}
  */
 exports.isString = function (obj) {
-  return typeof obj === 'string';
+  return typeof obj === "string";
 };
 
 /**
@@ -57,9 +57,9 @@ exports.isString = function (obj) {
 exports.slug = function (str) {
   return str
     .toLowerCase()
-    .replace(/\s+/g, '-')
-    .replace(/[^-\w]/g, '')
-    .replace(/-{2,}/g, '-');
+    .replace(/\s+/g, "-")
+    .replace(/[^-\w]/g, "")
+    .replace(/-{2,}/g, "-");
 };
 
 /**
@@ -70,22 +70,22 @@ exports.slug = function (str) {
  */
 exports.clean = function (str) {
   str = str
-    .replace(/\r\n?|[\n\u2028\u2029]/g, '\n')
-    .replace(/^\uFEFF/, '')
+    .replace(/\r\n?|[\n\u2028\u2029]/g, "\n")
+    .replace(/^\uFEFF/, "")
     // (traditional)->  space/name     parameters    body     (lambda)-> parameters       body   multi-statement/single          keep body content
     .replace(
       /^function(?:\s*|\s[^(]*)\([^)]*\)\s*\{((?:.|\n)*?)\}$|^\([^)]*\)\s*=>\s*(?:\{((?:.|\n)*?)\}|((?:.|\n)*))$/,
-      '$1$2$3'
+      "$1$2$3",
     );
 
   var spaces = str.match(/^\n?( *)/)[1].length;
   var tabs = str.match(/^\n?(\t*)/)[1].length;
   var re = new RegExp(
-    '^\n?' + (tabs ? '\t' : ' ') + '{' + (tabs || spaces) + '}',
-    'gm'
+    "^\n?" + (tabs ? "\t" : " ") + "{" + (tabs || spaces) + "}",
+    "gm",
   );
 
-  str = str.replace(re, '');
+  str = str.replace(re, "");
 
   return str.trim();
 };
@@ -106,12 +106,12 @@ exports.clean = function (str) {
  */
 function emptyRepresentation(value, typeHint) {
   switch (typeHint) {
-    case 'function':
-      return '[Function]';
-    case 'object':
-      return '{}';
-    case 'array':
-      return '[]';
+    case "function":
+      return "[Function]";
+    case "object":
+      return "{}";
+    case "array":
+      return "[]";
     default:
       return value.toString();
   }
@@ -142,18 +142,18 @@ function emptyRepresentation(value, typeHint) {
  */
 var canonicalType = (exports.canonicalType = function canonicalType(value) {
   if (value === undefined) {
-    return 'undefined';
+    return "undefined";
   } else if (value === null) {
-    return 'null';
+    return "null";
   } else if (Buffer.isBuffer(value)) {
-    return 'buffer';
+    return "buffer";
   } else if (Object.getPrototypeOf(value) === null) {
-    return 'null-prototype';
+    return "null-prototype";
   }
 
   return Object.prototype.toString
     .call(value)
-    .replace(/^\[.+\s(.+?)]$/, '$1')
+    .replace(/^\[.+\s(.+?)]$/, "$1")
     .toLowerCase();
 });
 
@@ -179,21 +179,21 @@ var canonicalType = (exports.canonicalType = function canonicalType(value) {
  */
 exports.type = function type(value) {
   // Null is special
-  if (value === null) return 'null';
+  if (value === null) return "null";
   const primitives = new Set([
-    'undefined',
-    'boolean',
-    'number',
-    'string',
-    'bigint',
-    'symbol'
+    "undefined",
+    "boolean",
+    "number",
+    "string",
+    "bigint",
+    "symbol",
   ]);
   const _type = typeof value;
-  if (_type === 'function') return _type;
+  if (_type === "function") return _type;
   if (primitives.has(_type)) return _type;
-  if (value instanceof String) return 'string';
-  if (value instanceof Error) return 'error';
-  if (Array.isArray(value)) return 'array';
+  if (value instanceof String) return "string";
+  if (value instanceof Error) return "error";
+  if (Array.isArray(value)) return "array";
 
   return _type;
 };
@@ -216,24 +216,24 @@ exports.type = function type(value) {
 exports.stringify = function (value) {
   var typeHint = canonicalType(value);
 
-  if (!~['object', 'array', 'function', 'null-prototype'].indexOf(typeHint)) {
-    if (typeHint === 'buffer') {
+  if (!~["object", "array", "function", "null-prototype"].indexOf(typeHint)) {
+    if (typeHint === "buffer") {
       var json = Buffer.prototype.toJSON.call(value);
       // Based on the toJSON result
       return jsonStringify(
         json.data && json.type ? json.data : json,
-        2
-      ).replace(/,(\n|$)/g, '$1');
+        2,
+      ).replace(/,(\n|$)/g, "$1");
     }
 
     // IE7/IE8 has a bizarre String constructor; needs to be coerced
     // into an array and back to obj.
-    if (typeHint === 'string' && typeof value === 'object') {
-      value = value.split('').reduce(function (acc, char, idx) {
+    if (typeHint === "string" && typeof value === "object") {
+      value = value.split("").reduce(function (acc, char, idx) {
         acc[idx] = char;
         return acc;
       }, {});
-      typeHint = 'object';
+      typeHint = "object";
     } else {
       return jsonStringify(value);
     }
@@ -243,8 +243,8 @@ exports.stringify = function (value) {
     if (Object.prototype.hasOwnProperty.call(value, prop)) {
       return jsonStringify(
         exports.canonicalize(value, null, typeHint),
-        2
-      ).replace(/,(\n|$)/g, '$1');
+        2,
+      ).replace(/,(\n|$)/g, "$1");
     }
   }
 
@@ -261,17 +261,17 @@ exports.stringify = function (value) {
  * @returns {*}
  */
 function jsonStringify(object, spaces, depth) {
-  if (typeof spaces === 'undefined') {
+  if (typeof spaces === "undefined") {
     // primitive types
     return _stringify(object);
   }
 
   depth = depth || 1;
   var space = spaces * depth;
-  var str = Array.isArray(object) ? '[' : '{';
-  var end = Array.isArray(object) ? ']' : '}';
+  var str = Array.isArray(object) ? "[" : "{";
+  var end = Array.isArray(object) ? "]" : "}";
   var length =
-    typeof object.length === 'number'
+    typeof object.length === "number"
       ? object.length
       : Object.keys(object).length;
   // `.repeat()` polyfill
@@ -281,39 +281,39 @@ function jsonStringify(object, spaces, depth) {
 
   function _stringify(val) {
     switch (canonicalType(val)) {
-      case 'null':
-      case 'undefined':
-        val = '[' + val + ']';
+      case "null":
+      case "undefined":
+        val = "[" + val + "]";
         break;
-      case 'array':
-      case 'object':
+      case "array":
+      case "object":
         val = jsonStringify(val, spaces, depth + 1);
         break;
-      case 'boolean':
-      case 'regexp':
-      case 'symbol':
-      case 'number':
+      case "boolean":
+      case "regexp":
+      case "symbol":
+      case "number":
         val =
           val === 0 && 1 / val === -Infinity // `-0`
-            ? '-0'
+            ? "-0"
             : val.toString();
         break;
-      case 'bigint':
-        val = val.toString() + 'n';
+      case "bigint":
+        val = val.toString() + "n";
         break;
-      case 'date':
+      case "date":
         var sDate = isNaN(val.getTime()) ? val.toString() : val.toISOString();
-        val = '[Date: ' + sDate + ']';
+        val = "[Date: " + sDate + "]";
         break;
-      case 'buffer':
+      case "buffer":
         var json = val.toJSON();
         // Based on the toJSON result
         json = json.data && json.type ? json.data : json;
-        val = '[Buffer: ' + jsonStringify(json, 2, depth + 1) + ']';
+        val = "[Buffer: " + jsonStringify(json, 2, depth + 1) + "]";
         break;
       default:
         val =
-          val === '[Function]' || val === '[Circular]'
+          val === "[Function]" || val === "[Circular]"
             ? val
             : JSON.stringify(val); // string
     }
@@ -326,17 +326,17 @@ function jsonStringify(object, spaces, depth) {
     }
     --length;
     str +=
-      '\n ' +
-      repeat(' ', space) +
-      (Array.isArray(object) ? '' : '"' + i + '": ') + // key
+      "\n " +
+      repeat(" ", space) +
+      (Array.isArray(object) ? "" : '"' + i + '": ') + // key
       _stringify(object[i]) + // value
-      (length ? ',' : ''); // comma
+      (length ? "," : ""); // comma
   }
 
   return (
     str +
     // [], {}
-    (str.length !== 1 ? '\n' + repeat(' ', --space) + end : end)
+    (str.length !== 1 ? "\n" + repeat(" ", --space) + end : end)
   );
 }
 
@@ -374,23 +374,23 @@ exports.canonicalize = function canonicalize(value, stack, typeHint) {
   stack = stack || [];
 
   if (stack.indexOf(value) !== -1) {
-    return '[Circular]';
+    return "[Circular]";
   }
 
   switch (typeHint) {
-    case 'undefined':
-    case 'buffer':
-    case 'null':
+    case "undefined":
+    case "buffer":
+    case "null":
       canonicalizedObj = value;
       break;
-    case 'array':
+    case "array":
       withStack(value, function () {
         canonicalizedObj = value.map(function (item) {
           return exports.canonicalize(item, stack);
         });
       });
       break;
-    case 'function':
+    case "function":
       /* eslint-disable-next-line no-unused-vars, no-unreachable-loop */
       for (prop in value) {
         canonicalizedObj = {};
@@ -402,11 +402,11 @@ exports.canonicalize = function canonicalize(value, stack, typeHint) {
         break;
       }
     /* falls through */
-    case 'null-prototype':
-    case 'object':
+    case "null-prototype":
+    case "object":
       canonicalizedObj = canonicalizedObj || {};
-      if (typeHint === 'null-prototype' && Symbol.toStringTag in value) {
-        canonicalizedObj['[Symbol.toStringTag]'] = value[Symbol.toStringTag];
+      if (typeHint === "null-prototype" && Symbol.toStringTag in value) {
+        canonicalizedObj["[Symbol.toStringTag]"] = value[Symbol.toStringTag];
       }
       withStack(value, function () {
         Object.keys(value)
@@ -416,15 +416,15 @@ exports.canonicalize = function canonicalize(value, stack, typeHint) {
           });
       });
       break;
-    case 'date':
-    case 'number':
-    case 'regexp':
-    case 'boolean':
-    case 'symbol':
+    case "date":
+    case "number":
+    case "regexp":
+    case "boolean":
+    case "symbol":
       canonicalizedObj = value;
       break;
     default:
-      canonicalizedObj = value + '';
+      canonicalizedObj = value + "";
   }
 
   return canonicalizedObj;
@@ -441,39 +441,39 @@ exports.canonicalize = function canonicalize(value, stack, typeHint) {
  */
 exports.stackTraceFilter = function () {
   // TODO: Replace with `process.browser`
-  var is = typeof document === 'undefined' ? {node: true} : {browser: true};
+  var is = typeof document === "undefined" ? { node: true } : { browser: true };
   var slash = path.sep;
   var cwd;
   if (is.node) {
     cwd = exports.cwd() + slash;
   } else {
     cwd = (
-      typeof location === 'undefined' ? window.location : location
-    ).href.replace(/\/[^/]*$/, '/');
-    slash = '/';
+      typeof location === "undefined" ? window.location : location
+    ).href.replace(/\/[^/]*$/, "/");
+    slash = "/";
   }
 
   function isMochaInternal(line) {
     return (
-      ~line.indexOf('node_modules' + slash + 'mocha' + slash) ||
-      ~line.indexOf(slash + 'mocha.js') ||
-      ~line.indexOf(slash + 'mocha.min.js')
+      ~line.indexOf("node_modules" + slash + "mocha" + slash) ||
+      ~line.indexOf(slash + "mocha.js") ||
+      ~line.indexOf(slash + "mocha.min.js")
     );
   }
 
   function isNodeInternal(line) {
     return (
-      ~line.indexOf('(timers.js:') ||
-      ~line.indexOf('(events.js:') ||
-      ~line.indexOf('(node.js:') ||
-      ~line.indexOf('(module.js:') ||
-      ~line.indexOf('GeneratorFunctionPrototype.next (native)') ||
+      ~line.indexOf("(timers.js:") ||
+      ~line.indexOf("(events.js:") ||
+      ~line.indexOf("(node.js:") ||
+      ~line.indexOf("(module.js:") ||
+      ~line.indexOf("GeneratorFunctionPrototype.next (native)") ||
       false
     );
   }
 
   return function (stack) {
-    stack = stack.split('\n');
+    stack = stack.split("\n");
 
     stack = stack.reduce(function (list, line) {
       if (isMochaInternal(line)) {
@@ -486,14 +486,14 @@ exports.stackTraceFilter = function () {
 
       // Clean up cwd(absolute)
       if (/:\d+:\d+\)?$/.test(line)) {
-        line = line.replace('(' + cwd, '(');
+        line = line.replace("(" + cwd, "(");
       }
 
       list.push(line);
       return list;
     }, []);
 
-    return stack.join('\n');
+    return stack.join("\n");
   };
 };
 
@@ -505,9 +505,9 @@ exports.stackTraceFilter = function () {
  */
 exports.isPromise = function isPromise(value) {
   return (
-    typeof value === 'object' &&
+    typeof value === "object" &&
     value !== null &&
-    typeof value.then === 'function'
+    typeof value.then === "function"
   );
 };
 
@@ -546,7 +546,7 @@ exports.noop = function () {};
 exports.createMap = function () {
   return Object.assign.apply(
     null,
-    [Object.create(null)].concat(Array.prototype.slice.call(arguments))
+    [Object.create(null)].concat(Array.prototype.slice.call(arguments)),
   );
 };
 
@@ -563,8 +563,8 @@ exports.createMap = function () {
  * @throws {TypeError} if argument is not a non-empty object.
  */
 exports.defineConstants = function (obj) {
-  if (canonicalType(obj) !== 'object' || !Object.keys(obj).length) {
-    throw new TypeError('Invalid argument; expected a non-empty object');
+  if (canonicalType(obj) !== "object" || !Object.keys(obj).length) {
+    throw new TypeError("Invalid argument; expected a non-empty object");
   }
   return Object.freeze(exports.createMap(obj));
 };
@@ -608,8 +608,8 @@ exports.castArray = function castArray(value) {
     return [null];
   }
   if (
-    typeof value === 'object' &&
-    (typeof value[Symbol.iterator] === 'function' || value.length !== undefined)
+    typeof value === "object" &&
+    (typeof value[Symbol.iterator] === "function" || value.length !== undefined)
   ) {
     return Array.from(value);
   }
@@ -617,11 +617,11 @@ exports.castArray = function castArray(value) {
 };
 
 exports.constants = exports.defineConstants({
-  MOCHA_ID_PROP_NAME
+  MOCHA_ID_PROP_NAME,
 });
 
 const uniqueIDBase =
-  'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_';
+  "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_";
 
 /**
  * Creates a new unique identifier
@@ -630,19 +630,19 @@ const uniqueIDBase =
  * @returns {string} Unique identifier
  */
 exports.uniqueID = () => {
-  let id = '';
+  let id = "";
   for (let i = 0; i < 21; i++) {
     id += uniqueIDBase[(Math.random() * 64) | 0];
   }
   return id;
 };
 
-exports.assignNewMochaID = obj => {
+exports.assignNewMochaID = (obj) => {
   const id = exports.uniqueID();
   Object.defineProperty(obj, MOCHA_ID_PROP_NAME, {
     get() {
       return id;
-    }
+    },
   });
   return obj;
 };
@@ -652,8 +652,8 @@ exports.assignNewMochaID = obj => {
  * @param {*} [obj] - Object
  * @returns {string|void}
  */
-exports.getMochaID = obj =>
-  obj && typeof obj === 'object' ? obj[MOCHA_ID_PROP_NAME] : undefined;
+exports.getMochaID = (obj) =>
+  obj && typeof obj === "object" ? obj[MOCHA_ID_PROP_NAME] : undefined;
 
 /**
  * Replaces any detected circular dependency with the string '[Circular]'
@@ -661,16 +661,16 @@ exports.getMochaID = obj =>
  * @param inputObj {*}
  * @returns {*}
  */
-exports.breakCircularDeps = inputObj => {
+exports.breakCircularDeps = (inputObj) => {
   const seen = new Set();
 
   function _breakCircularDeps(obj) {
-    if (obj && typeof obj !== 'object') {
+    if (obj && typeof obj !== "object") {
       return obj;
     }
 
     if (seen.has(obj)) {
-      return '[Circular]';
+      return "[Circular]";
     }
 
     seen.add(obj);
@@ -693,6 +693,6 @@ exports.breakCircularDeps = inputObj => {
 /**
  * Checks if provided input can be parsed as a JavaScript Number.
  */
-exports.isNumeric = input => {
+exports.isNumeric = (input) => {
   return !isNaN(parseFloat(input));
 };