mocha 11.2.2 → 11.3.0

package/bin/mocha.js

@@ -10,6 +10,7 @@
  * @private
  */
 
+const os = require('node:os');
 const {loadOptions} = require('../lib/cli/options');
 const {
   unparseNodeFlags,
@@ -22,6 +23,7 @@ const {aliases} = require('../lib/cli/run-option-metadata');
 
 const mochaArgs = {};
 const nodeArgs = {};
+const SIGNAL_OFFSET = 128;
 let hasInspect = false;
 
 const opts = loadOptions(process.argv.slice(2));
@@ -109,9 +111,13 @@ if (mochaArgs['node-option'] || Object.keys(nodeArgs).length || hasInspect) {
   proc.on('exit', (code, signal) => {
     process.on('exit', () => {
       if (signal) {
+        signal = typeof signal === 'string' ? os.constants.signals[signal] : signal;
+        if (mochaArgs['posix-exit-codes'] === true) {
+          process.exitCode = SIGNAL_OFFSET + signal;
+        }
         process.kill(process.pid, signal);
       } else {
-        process.exit(code);
+        process.exit(Math.min(code, mochaArgs['posix-exit-codes'] ? 1 : 255));
       }
     });
   });
@@ -126,7 +132,7 @@ if (mochaArgs['node-option'] || Object.keys(nodeArgs).length || hasInspect) {
     // be needed.
     if (!args.parallel || args.jobs < 2) {
       // win32 does not support SIGTERM, so use next best thing.
-      if (require('node:os').platform() === 'win32') {
+      if (os.platform() === 'win32') {
         proc.kill('SIGKILL');
       } else {
         // using SIGKILL won't cleanly close the output streams, which can result

package/lib/cli/run-helpers.js

@@ -27,7 +27,7 @@ const {UnmatchedFile} = require('./collect-files');
  */
 const exitMochaLater = clampedCode => {
   process.on('exit', () => {
-    process.exitCode = clampedCode;
+    process.exitCode = Math.min(clampedCode, process.argv.includes('--posix-exit-codes') ? 1 : 255);
   });
 };
 
@@ -39,6 +39,8 @@ const exitMochaLater = clampedCode => {
  * @private
  */
 const exitMocha = clampedCode => {
+  const usePosixExitCodes = process.argv.includes('--posix-exit-codes');
+  clampedCode = Math.min(clampedCode, usePosixExitCodes ? 1 : 255);
   let draining = 0;
 
   // Eagerly set the process's exit code in case stream.write doesn't

package/lib/cli/run-option-metadata.js

@@ -46,6 +46,7 @@ const TYPES = (exports.types = {
     'list-reporters',
     'no-colors',
     'parallel',
+    'posix-exit-codes',
     'recursive',
     'sort',
     'watch'

package/lib/cli/run.js

@@ -195,6 +195,10 @@ exports.builder = yargs =>
         description: 'Run tests in parallel',
         group: GROUPS.RULES
       },
+      'posix-exit-codes': {
+        description: 'Use POSIX and UNIX shell exit codes as Mocha\'s return value',
+        group: GROUPS.RULES
+      },
       recursive: {
         description: 'Look for tests in subdirectories',
         group: GROUPS.FILES

package/mocha.js

@@ -1,4 +1,4 @@
-// mocha@11.2.2 in javascript ES2018
+// mocha@11.3.0 in javascript ES2018
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
   typeof define === 'function' && define.amd ? define(factory) :
@@ -19256,7 +19256,7 @@
   };
 
   var name = "mocha";
-  var version = "11.2.2";
+  var version = "11.3.0";
   var homepage = "https://mochajs.org/";
   var notifyLogo = "https://ibin.co/4QuRuGjXvl36.png";
   var require$$17 = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mocha",
-  "version": "11.2.2",
+  "version": "11.3.0",
   "type": "commonjs",
   "description": "simple, flexible, fun test framework",
   "keywords": [
@@ -48,8 +48,10 @@
     "docs-clean": "rimraf docs/_site docs/api",
     "docs-watch": "eleventy --serve",
     "docs:api": "jsdoc -c jsdoc.conf.json",
-    "docs:site": "eleventy",
-    "docs": "run-s docs-clean docs:*",
+    "docs:build": "eleventy",
+    "docs:build-new": "cd docs-next && npm i && npm run build-with-old",
+    "docs:preview": "http-server docs/_site -o",
+    "docs": "run-s docs-clean docs:api docs:build docs:build-new",
     "format:eslint": "eslint --fix . \"bin/*\"",
     "format:prettier": "prettier --write \"!(package*).json\" \".*.json\" \"lib/**/*.json\" \"*.yml\"",
     "format": "run-s format:*",
@@ -132,6 +134,7 @@
     "eslint-plugin-n": "^17.15.1",
     "fail-on-errors-webpack-plugin": "^3.0.0",
     "globals": "^13.24.0",
+    "http-server": "^14.1.1",
     "installed-check": "^9.3.0",
     "jsdoc": "^3.6.7",
     "jsdoc-ts-utils": "^2.0.1",