mocha 10.4.0 → 10.5.0

package/README.md

@@ -5,7 +5,7 @@
 <p align="center">☕️ Simple, flexible, fun JavaScript test framework for Node.js & The Browser ☕️</p>
 
 <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://github.com/mochajs/mocha/actions?query=workflow%3ATests+branch%3Amain"><img src="https://github.com/mochajs/mocha/workflows/Tests/badge.svg?branch=main" 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://discord.gg/KeDn2uXhER"><img alt="Chat - Discord" src="https://img.shields.io/badge/chat-Discord-5765F2.svg" /></a>
@@ -23,10 +23,10 @@
 ## Links
 
 - **[Documentation](https://mochajs.org)**
-- **[Release Notes / History / Changes](https://github.com/mochajs/mocha/blob/master/CHANGELOG.md)**
-- [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)
-- [Development](https://github.com/mochajs/mocha/blob/master/.github/DEVELOPMENT.md)
+- **[Release Notes / History / Changes](https://github.com/mochajs/mocha/blob/main/CHANGELOG.md)**
+- [Code of Conduct](https://github.com/mochajs/mocha/blob/main/.github/CODE_OF_CONDUCT.md)
+- [Contributing](https://github.com/mochajs/mocha/blob/main/.github/CONTRIBUTING.md)
+- [Development](https://github.com/mochajs/mocha/blob/main/.github/DEVELOPMENT.md)
 - [Discord](https://discord.gg/KeDn2uXhER) (ask questions here!)
 - [Issue Tracker](https://github.com/mochajs/mocha/issues)
 
@@ -59,7 +59,7 @@ You might want to help:
 
 - New to contributing to Mocha? Check out this list of [good first issues](https://github.com/mochajs/mocha/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)
 - Mocha could use a hand with [these issues](https://github.com/mochajs/mocha/issues?q=is%3Aopen+is%3Aissue+label%3A%22status%3A+accepting+prs%22)
-- The [maintainer's handbook](https://github.com/mochajs/mocha/blob/master/MAINTAINERS.md) explains how things get done
+- The [maintainer's handbook](https://github.com/mochajs/mocha/blob/main/MAINTAINERS.md) explains how things get done
 
 Finally, come [chat with the maintainers on Discord](https://discord.gg/KeDn2uXhER) if you want to help with:
 
@@ -69,6 +69,6 @@ Finally, come [chat with the maintainers on Discord](https://discord.gg/KeDn2uXh
 
 ## License
 
-Copyright 2011-2022 OpenJS Foundation and contributors. Licensed [MIT](https://github.com/mochajs/mocha/blob/master/LICENSE).
+Copyright 2011-2022 OpenJS Foundation and contributors. Licensed [MIT](https://github.com/mochajs/mocha/blob/main/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/browser-entry.js

@@ -71,8 +71,8 @@ process.listenerCount = function (name) {
 
 process.on = function (e, fn) {
   if (e === 'uncaughtException') {
-    global.onerror = function (err, url, line) {
-      fn(new Error(err + ' (' + url + ':' + line + ')'));
+    global.onerror = function (msg, url, line, col, err) {
+      fn(err || new Error(msg + ' (' + url + ':' + line + ':' + col + ')'));
       return !mocha.options.allowUncaught;
     };
     uncaughtExceptionHandlers.push(fn);

package/lib/cli/options.js

@@ -208,9 +208,10 @@ module.exports.loadPkgRc = loadPkgRc;
  * Priority list:
  *
  * 1. Command-line args
- * 2. RC file (`.mocharc.c?js`, `.mocharc.ya?ml`, `mocharc.json`)
- * 3. `mocha` prop of `package.json`
- * 4. default configuration (`lib/mocharc.json`)
+ * 2. `MOCHA_OPTIONS` environment variable.
+ * 3. RC file (`.mocharc.c?js`, `.mocharc.ya?ml`, `mocharc.json`)
+ * 4. `mocha` prop of `package.json`
+ * 5. default configuration (`lib/mocharc.json`)
  *
  * If a {@link module:lib/cli/one-and-dones.ONE_AND_DONE_ARGS "one-and-done" option} is present in the `argv` array, no external config files will be read.
  * @summary Parses options read from `.mocharc.*` and `package.json`.
@@ -231,6 +232,7 @@ const loadOptions = (argv = []) => {
     return args;
   }
 
+  const envConfig = parse(process.env.MOCHA_OPTIONS || '');
   const rcConfig = loadRc(args);
   const pkgConfig = loadPkgRc(args);
 
@@ -243,7 +245,14 @@ const loadOptions = (argv = []) => {
     args._ = args._.concat(pkgConfig._ || []);
   }
 
-  args = parse(args._, mocharc, args, rcConfig || {}, pkgConfig || {});
+  args = parse(
+    args._,
+    mocharc,
+    args,
+    envConfig,
+    rcConfig || {},
+    pkgConfig || {}
+  );
 
   // recombine positional arguments and "spec"
   if (args.spec) {

package/lib/nodejs/reporters/parallel-buffered.js

@@ -54,7 +54,7 @@ const ONCE_EVENT_NAMES = [EVENT_DELAY_BEGIN, EVENT_DELAY_END];
 
 /**
  * The `ParallelBuffered` reporter is used by each worker process in "parallel"
- * mode, by default.  Instead of reporting to to `STDOUT`, etc., it retains a
+ * mode, by default.  Instead of reporting to `STDOUT`, etc., it retains a
  * list of events it receives and hands these off to the callback passed into
  * {@link Mocha#run}. That callback will then return the data to the main
  * process.

package/lib/nodejs/serializer.js

@@ -117,7 +117,7 @@ class SerializableEvent {
   /**
    * Constructs a `SerializableEvent`, throwing if we receive unexpected data.
    *
-   * Practically, events emitted from `Runner` have a minumum of zero (0)
+   * Practically, events emitted from `Runner` have a minimum of zero (0)
    * arguments-- (for example, {@link Runnable.constants.EVENT_RUN_BEGIN}) and a
    * maximum of two (2) (for example,
    * {@link Runnable.constants.EVENT_TEST_FAIL}, where the second argument is an

package/lib/reporters/html.js

@@ -10,7 +10,6 @@
 
 var Base = require('./base');
 var utils = require('../utils');
-var Progress = require('../browser/progress');
 var escapeRe = require('escape-string-regexp');
 var constants = require('../runner').constants;
 var EVENT_TEST_PASS = constants.EVENT_TEST_PASS;
@@ -38,7 +37,7 @@ exports = module.exports = HTML;
 
 var statsTemplate =
   '<ul id="mocha-stats">' +
-  '<li class="progress"><canvas width="40" height="40"></canvas></li>' +
+  '<li class="progress-contain"><progress class="progress-element" max="100" value="0"></progress><svg class="progress-ring"><circle class="ring-flatlight" stroke-dasharray="100%,0%"/><circle class="ring-highlight" stroke-dasharray="0%,100%"/></svg><div class="progress-text">0%</div></li>' +
   '<li class="passes"><a href="javascript:void(0);">passes:</a> <em>0</em></li>' +
   '<li class="failures"><a href="javascript:void(0);">failures:</a> <em>0</em></li>' +
   '<li class="duration">duration: <em>0</em>s</li>' +
@@ -68,24 +67,16 @@ function HTML(runner, options) {
   var failures = items[2].getElementsByTagName('em')[0];
   var failuresLink = items[2].getElementsByTagName('a')[0];
   var duration = items[3].getElementsByTagName('em')[0];
-  var canvas = stat.getElementsByTagName('canvas')[0];
   var report = fragment('<ul id="mocha-report"></ul>');
   var stack = [report];
-  var progress;
-  var ctx;
+  var progressText = items[0].getElementsByTagName('div')[0];
+  var progressBar = items[0].getElementsByTagName('progress')[0];
+  var progressRing = [
+    items[0].getElementsByClassName('ring-flatlight')[0],
+    items[0].getElementsByClassName('ring-highlight')[0]];
+  var progressRingRadius = null; // computed CSS unavailable now, so set later
   var root = document.getElementById('mocha');
 
-  if (canvas.getContext) {
-    var ratio = window.devicePixelRatio || 1;
-    canvas.style.width = canvas.width;
-    canvas.style.height = canvas.height;
-    canvas.width *= ratio;
-    canvas.height *= ratio;
-    ctx = canvas.getContext('2d');
-    ctx.scale(ratio, ratio);
-    progress = new Progress();
-  }
-
   if (!root) {
     return error('#mocha div missing, add it to your document');
   }
@@ -115,10 +106,6 @@ function HTML(runner, options) {
   root.appendChild(stat);
   root.appendChild(report);
 
-  if (progress) {
-    progress.size(40);
-  }
-
   runner.on(EVENT_SUITE_BEGIN, function (suite) {
     if (suite.root) {
       return;
@@ -234,8 +221,26 @@ function HTML(runner, options) {
   function updateStats() {
     // TODO: add to stats
     var percent = ((stats.tests / runner.total) * 100) | 0;
-    if (progress) {
-      progress.update(percent).draw(ctx);
+    progressBar.value = percent;
+    if (progressText) {
+      // setting a toFixed that is too low, makes small changes to progress not shown
+      // setting it too high, makes the progress text longer then it needs to
+      // to address this, calculate the toFixed based on the magnitude of total
+      var decimalPlaces = Math.ceil(Math.log10(runner.total / 100));
+      text(
+        progressText,
+        percent.toFixed(Math.min(Math.max(decimalPlaces, 0), 100)) + '%'
+      );
+    }
+    if (progressRing) {
+      var radius = parseFloat(getComputedStyle(progressRing[0]).getPropertyValue('r'));
+      var wholeArc = Math.PI * 2 * radius;
+      var highlightArc = percent * (wholeArc / 100);
+      // The progress ring is in 2 parts, the flatlight color and highlight color.
+      // Rendering both on top of the other, seems to make a 3rd color on the edges.
+      // To create 1 whole ring with 2 colors, both parts are inverse of the other.
+      progressRing[0].style['stroke-dasharray'] = `0,${highlightArc}px,${wholeArc}px`;
+      progressRing[1].style['stroke-dasharray'] = `${highlightArc}px,${wholeArc}px`;
     }
 
     // update stats

package/mocha.css

@@ -22,6 +22,9 @@
   --mocha-stats-color: #888;
   --mocha-stats-em-color: #000;
   --mocha-stats-hover-color: #eee;
+  --mocha-progress-ring-color: #eee;
+  --mocha-progress-ring-highlight-color: #9f9f9f;
+  --mocha-progress-text-color: #000;
   --mocha-error-color: #c00;
 
   --mocha-code-comment:  #ddd;
@@ -54,6 +57,9 @@
      --mocha-stats-color: #aaa;
      --mocha-stats-em-color: #fff;
      --mocha-stats-hover-color: #444;
+     --mocha-progress-ring-color: #444;
+     --mocha-progress-ring-highlight-color: #888;
+     --mocha-progress-text-color: #fff;
      --mocha-error-color: #f44;
 
      --mocha-code-comment: #ddd;
@@ -325,6 +331,10 @@ body {
 }
 
 #mocha-stats {
+  --ring-container-size: 40px;
+  --ring-size: 39px;
+  --ring-radius: calc(var(--ring-size) / 2);
+
   position: fixed;
   top: 15px;
   right: 10px;
@@ -334,20 +344,52 @@ body {
   z-index: 1;
 }
 
-#mocha-stats .progress {
+#mocha-stats .progress-contain {
   float: right;
-  padding-top: 0;
+  padding: 0;
+}
+
+#mocha-stats :is(.progress-element, .progress-text) {
+  width: var(--ring-container-size);
+  display: block;
+  top: 12px;
+  position: absolute;
+}
+
+#mocha-stats .progress-element {
+  visibility: hidden;
+  height: calc(var(--ring-container-size) / 2);
+}
+
+#mocha-stats .progress-text {
+  text-align: center;
+  text-overflow: clip;
+  overflow: hidden;
+  color: var(--mocha-stats-em-color);
+  font-size: 11px;
+}
 
-  /**
-   * Set safe initial values, so mochas .progress does not inherit these
-   * properties from Bootstrap .progress (which causes .progress height to
-   * equal line height set in Bootstrap).
-   */
-  height: auto;
-  -webkit-box-shadow: none;
-  -moz-box-shadow: none;
-  box-shadow: none;
-  background-color: initial;
+#mocha-stats .progress-ring {
+  width: var(--ring-container-size);
+  height: var(--ring-container-size);
+}
+
+#mocha-stats :is(.ring-flatlight, .ring-highlight) {
+  --stroke-thickness: 1.65px;
+  --center: calc(var(--ring-container-size) / 2);
+  cx: var(--center);
+  cy: var(--center);
+  r: calc(var(--ring-radius) - calc(var(--stroke-thickness) / 2));
+  fill: hsla(0, 0%, 0%, 0);
+  stroke-width: var(--stroke-thickness);
+}
+
+#mocha-stats .ring-flatlight {
+  stroke: var(--mocha-progress-ring-color);
+}
+
+#mocha-stats .ring-highlight {
+  stroke: var(--mocha-progress-ring-highlight-color);
 }
 
 #mocha-stats em {
@@ -370,11 +412,6 @@ body {
   padding-top: 11px;
 }
 
-#mocha-stats canvas {
-  width: 40px;
-  height: 40px;
-}
-
 #mocha code .comment { color: var(--mocha-code-comment); }
 #mocha code .init { color: var(--mocha-code-init); }
 #mocha code .string { color: var(--mocha-code-string); }

package/mocha.js

@@ -1,4 +1,4 @@
-// mocha@10.4.0 in javascript ES2018
+// mocha@10.5.0 in javascript ES2018
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
   typeof define === 'function' && define.amd ? define(factory) :
@@ -16507,143 +16507,6 @@
 
   var html = {exports: {}};
 
-  /**
-   @module browser/Progress
-  */
-
-  /**
-   * Expose `Progress`.
-   */
-
-  var progress$1 = Progress;
-
-  /**
-   * Initialize a new `Progress` indicator.
-   */
-  function Progress() {
-    this.percent = 0;
-    this.size(0);
-    this.fontSize(11);
-    this.font('helvetica, arial, sans-serif');
-  }
-
-  /**
-   * Set progress size to `size`.
-   *
-   * @public
-   * @param {number} size
-   * @return {Progress} Progress instance.
-   */
-  Progress.prototype.size = function (size) {
-    this._size = size;
-    return this;
-  };
-
-  /**
-   * Set text to `text`.
-   *
-   * @public
-   * @param {string} text
-   * @return {Progress} Progress instance.
-   */
-  Progress.prototype.text = function (text) {
-    this._text = text;
-    return this;
-  };
-
-  /**
-   * Set font size to `size`.
-   *
-   * @public
-   * @param {number} size
-   * @return {Progress} Progress instance.
-   */
-  Progress.prototype.fontSize = function (size) {
-    this._fontSize = size;
-    return this;
-  };
-
-  /**
-   * Set font to `family`.
-   *
-   * @param {string} family
-   * @return {Progress} Progress instance.
-   */
-  Progress.prototype.font = function (family) {
-    this._font = family;
-    return this;
-  };
-
-  /**
-   * Update percentage to `n`.
-   *
-   * @param {number} n
-   * @return {Progress} Progress instance.
-   */
-  Progress.prototype.update = function (n) {
-    this.percent = n;
-    return this;
-  };
-
-  /**
-   * Draw on `ctx`.
-   *
-   * @param {CanvasRenderingContext2d} ctx
-   * @return {Progress} Progress instance.
-   */
-  Progress.prototype.draw = function (ctx) {
-    try {
-      var darkMatcher = window.matchMedia('(prefers-color-scheme: dark)');
-      var isDarkMode = !!darkMatcher.matches;
-      var lightColors = {
-        outerCircle: '#9f9f9f',
-        innerCircle: '#eee',
-        text: '#000'
-      };
-      var darkColors = {
-        outerCircle: '#888',
-        innerCircle: '#444',
-        text: '#fff'
-      };
-      var colors = isDarkMode ? darkColors : lightColors;
-
-      var percent = Math.min(this.percent, 100);
-      var size = this._size;
-      var half = size / 2;
-      var x = half;
-      var y = half;
-      var rad = half - 1;
-      var fontSize = this._fontSize;
-
-      ctx.font = fontSize + 'px ' + this._font;
-
-      var angle = Math.PI * 2 * (percent / 100);
-      ctx.clearRect(0, 0, size, size);
-
-      // outer circle
-      ctx.strokeStyle = colors.outerCircle;
-      ctx.beginPath();
-      ctx.arc(x, y, rad, 0, angle, false);
-      ctx.stroke();
-
-      // inner circle
-      ctx.strokeStyle = colors.innerCircle;
-      ctx.beginPath();
-      ctx.arc(x, y, rad - 1, 0, angle, true);
-      ctx.stroke();
-
-      // text
-      var text = this._text || (percent | 0) + '%';
-      var w = ctx.measureText(text).width;
-
-      ctx.fillStyle = colors.text;
-      ctx.fillText(text, x - w / 2 + 1, y + fontSize / 2 - 1);
-    } catch (ignore) {
-      // don't fail if we can't render progress
-    }
-    return this;
-  };
-
   (function (module, exports) {
 
   /* eslint-env browser */
@@ -16656,7 +16519,6 @@
 
   var Base = base$1.exports;
   var utils = utils$3;
-  var Progress = progress$1;
   var escapeRe = escapeStringRegexp;
   var constants = runner.constants;
   var EVENT_TEST_PASS = constants.EVENT_TEST_PASS;
@@ -16684,7 +16546,7 @@
 
   var statsTemplate =
     '<ul id="mocha-stats">' +
-    '<li class="progress"><canvas width="40" height="40"></canvas></li>' +
+    '<li class="progress-contain"><progress class="progress-element" max="100" value="0"></progress><svg class="progress-ring"><circle class="ring-flatlight" stroke-dasharray="100%,0%"/><circle class="ring-highlight" stroke-dasharray="0%,100%"/></svg><div class="progress-text">0%</div></li>' +
     '<li class="passes"><a href="javascript:void(0);">passes:</a> <em>0</em></li>' +
     '<li class="failures"><a href="javascript:void(0);">failures:</a> <em>0</em></li>' +
     '<li class="duration">duration: <em>0</em>s</li>' +
@@ -16714,24 +16576,15 @@
     var failures = items[2].getElementsByTagName('em')[0];
     var failuresLink = items[2].getElementsByTagName('a')[0];
     var duration = items[3].getElementsByTagName('em')[0];
-    var canvas = stat.getElementsByTagName('canvas')[0];
     var report = fragment('<ul id="mocha-report"></ul>');
     var stack = [report];
-    var progress;
-    var ctx;
+    var progressText = items[0].getElementsByTagName('div')[0];
+    var progressBar = items[0].getElementsByTagName('progress')[0];
+    var progressRing = [
+      items[0].getElementsByClassName('ring-flatlight')[0],
+      items[0].getElementsByClassName('ring-highlight')[0]];
     var root = document.getElementById('mocha');
 
-    if (canvas.getContext) {
-      var ratio = window.devicePixelRatio || 1;
-      canvas.style.width = canvas.width;
-      canvas.style.height = canvas.height;
-      canvas.width *= ratio;
-      canvas.height *= ratio;
-      ctx = canvas.getContext('2d');
-      ctx.scale(ratio, ratio);
-      progress = new Progress();
-    }
-
     if (!root) {
       return error('#mocha div missing, add it to your document');
     }
@@ -16761,10 +16614,6 @@
     root.appendChild(stat);
     root.appendChild(report);
 
-    if (progress) {
-      progress.size(40);
-    }
-
     runner.on(EVENT_SUITE_BEGIN, function (suite) {
       if (suite.root) {
         return;
@@ -16880,8 +16729,26 @@
     function updateStats() {
       // TODO: add to stats
       var percent = ((stats.tests / runner.total) * 100) | 0;
-      if (progress) {
-        progress.update(percent).draw(ctx);
+      progressBar.value = percent;
+      if (progressText) {
+        // setting a toFixed that is too low, makes small changes to progress not shown
+        // setting it too high, makes the progress text longer then it needs to
+        // to address this, calculate the toFixed based on the magnitude of total
+        var decimalPlaces = Math.ceil(Math.log10(runner.total / 100));
+        text(
+          progressText,
+          percent.toFixed(Math.min(Math.max(decimalPlaces, 0), 100)) + '%'
+        );
+      }
+      if (progressRing) {
+        var radius = parseFloat(getComputedStyle(progressRing[0]).getPropertyValue('r'));
+        var wholeArc = Math.PI * 2 * radius;
+        var highlightArc = percent * (wholeArc / 100);
+        // The progress ring is in 2 parts, the flatlight color and highlight color.
+        // Rendering both on top of the other, seems to make a 3rd color on the edges.
+        // To create 1 whole ring with 2 colors, both parts are inverse of the other.
+        progressRing[0].style['stroke-dasharray'] = `0,${highlightArc}px,${wholeArc}px`;
+        progressRing[1].style['stroke-dasharray'] = `${highlightArc}px,${wholeArc}px`;
       }
 
       // update stats
@@ -19119,7 +18986,7 @@
   };
 
   var name = "mocha";
-  var version = "10.4.0";
+  var version = "10.5.0";
   var homepage = "https://mochajs.org/";
   var notifyLogo = "https://ibin.co/4QuRuGjXvl36.png";
   var require$$17 = {
@@ -20518,8 +20385,8 @@
 
   process.on = function (e, fn) {
     if (e === 'uncaughtException') {
-      commonjsGlobal.onerror = function (err, url, line) {
-        fn(new Error(err + ' (' + url + ':' + line + ')'));
+      commonjsGlobal.onerror = function (msg, url, line, col, err) {
+        fn(err || new Error(msg + ' (' + url + ':' + line + ':' + col + ')'));
         return !mocha.options.allowUncaught;
       };
       uncaughtExceptionHandlers.push(fn);