fix: improve error handling in global fixtures #5208

lib/mocha.js

@@ -184,6 +184,7 @@ function Mocha(options = {}) {
   options = {...mocharc, ...options};
   this.files = [];
   this.options = options;
+  this.globalTeardownErrored = false;
   // root suite
   this.suite = new exports.Suite('', new exports.Context(), true);
   this._cleanReferencesAfterRun = true;
@@ -987,6 +988,7 @@ Mocha.prototype.run = function (fn) {
   if (this.files.length && !this._lazyLoadFiles) {
     this.loadFiles();
   }
+
   var suite = this.suite;
   var options = this.options;
   options.files = this.files;
@@ -1219,22 +1221,40 @@ Mocha.prototype.runGlobalTeardown = async function runGlobalTeardown(
 };
 
 /**
- * Run global fixtures sequentially with context `context`
+ * Run global fixtures sequentially with context `context`.
  * @private
  * @param {MochaGlobalFixture[]} [fixtureFns] - Fixtures to run
  * @param {object} [context] - context object
  * @returns {Promise<object>} context object
  */
 Mocha.prototype._runGlobalFixtures = async function _runGlobalFixtures(
   fixtureFns = [],
-  context = {}
+  context = {},
 ) {
-  for await (const fixtureFn of fixtureFns) {
-    await fixtureFn.call(context);
+  for (const fixtureFn of fixtureFns) {
+    try {
+      await fixtureFn.call(context);
+    } catch (err) {
+      if(context.stats) {
+        context.stats.failures++;
+        context.failures++;
+
+        const isSetup = this.options.globalSetup && this.options.globalSetup.includes(fixtureFn);
+        const phase = isSetup ? 'Global Setup' : 'Global Teardown';
+
+        context.emit('fail', {
+          title: phase,
+          err: err
+        });
+        console.error(err);
+        process.exit(1);
+      }
+    }
   }
   return context;
 };
 
+
 /**
  * Toggle execution of any global setup fixture(s)
  *
@@ -1330,3 +1350,4 @@ Mocha.prototype.hasGlobalTeardownFixtures =
  * @param {Array<*>} impls - User-supplied implementations
  * @returns {Promise<*>|*}
  */
+

test/integration/fixtures/global-teardown-error.js

@@ -0,0 +1,9 @@
+'use strict'
+
+const { it } = require('../../../lib/mocha');
+
+it('should pass', () => {});
+
+exports.mochaGlobalTeardown = async function () {
+    throw new Error('Teardown problem')
+}

test/integration/global-teardown-errors.spec.js

@@ -0,0 +1,102 @@
+'use strict'
+
+const assert = require('assert');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const fs = require('fs').promises;
+
+describe('Global Teardown Error Handling', function() {
+  this.timeout(5000);
+
+  const setupFile = 'test/fixtures/global-teardown/setup.js';
+  const testFile = 'test/fixtures/global-teardown/test.js';
+
+  before(async function() {
+    await fs.mkdir(path.dirname(setupFile), { recursive: true });
+
+    await fs.writeFile(setupFile, `
+      exports.mochaGlobalTeardown = async function () {
+        throw new Error('Teardown failure');
+      };
+    `);
+
+    await fs.writeFile(testFile, `
+      describe('Test Suite', function() {
+        it('passing test', function() {
+          // This test passes
+        });
+      });
+    `);
+  });
+
+  after(async function() {
+    await fs.rm(path.dirname(setupFile), { recursive: true, force: true });
+  });
+
+  it('should fail with non-zero exit code when global teardown fails', function() {
+    const result = spawnSync('node', [
+      'bin/mocha',
+      '--require', setupFile,
+      testFile
+    ], {
+      encoding: 'utf8'
+    });
+
+    assert.strictEqual(result.status, 1, 'Process should exit with code 1');
+
+    assert(result.stderr.includes('Teardown failure') || 
+           result.stdout.includes('Teardown failure'),
+           'Should show teardown error message');
+  });
+
+  it('should combine test failures with teardown failures', async function() {
+
+    await fs.writeFile(testFile, `
+      describe('Test Suite', function() {
+        it('failing test', function() {
+          throw new Error('Test failure');
+        });
+      });
+    `);
+
+    const result = spawnSync('node', [
+      'bin/mocha',
+      '--require', setupFile,
+      testFile
+    ], {
+      encoding: 'utf8'
+    });
+
+    assert.strictEqual(result.status, 1, 'Process should exit with code 1');
+
+    const output = result.stdout + result.stderr;
+    assert(output.includes('Test failure'), 'Should show test error');
+    assert(output.includes('Teardown failure'), 'Should show teardown error');
+  });
+
+  it('should pass with zero exit code when no errors occur', async function() {
+    await fs.writeFile(setupFile, `
+      exports.mochaGlobalTeardown = async function () {
+        // Success case
+      };
+    `);
+
+    await fs.writeFile(testFile, `
+      describe('Test Suite', function() {
+        it('passing test', function() {
+          // This test passes
+        });
+      });
+    `);
+
+    const result = spawnSync('node', [
+      'bin/mocha',
+      '--require', setupFile,
+      testFile
+    ], {
+      encoding: 'utf8'
+    });
+
+    assert.strictEqual(result.status, 0, 'Process should exit with code 0');
+  });
+});