All Versions
Latest Version
Avg Release Cycle
35 days
Latest Release
346 days ago

Changelog History
Page 2

  • v9.0.3 Changes

    July 25, 2021

    ๐Ÿ›  :bug: Fixes

    • #4702: Error rethrow from cwd-relative path while loading .mocharc.js (@kirill-golovan)

    • #4688: Usage of custom interface in parallel mode (@juergba)

    • #4687: ESM: don't swallow MODULE_NOT_FOUND errors in case of type:module (@giltayar)

  • v9.0.2 Changes

    July 03, 2021

    ๐Ÿ›  :bug: Fixes

    • #4668: ESM: make --require <dir> work with new import-first loading (@giltayar)

    :nut_and_bolt: Other

  • v9.0.1 Changes

    June 18, 2021

    :nut_and_bolt: Other

    • #4657: Browser: add separate bundle for modern browsers (@juergba)

    ๐Ÿ‘ We added a separate browser bundle mocha-es2018.js in javascript ES2018, as we skipped the transpilation down to ES5. This is an experimental step towards freezing Mocha's support of IE11.

  • v9.0.0 Changes

    June 07, 2021

    :boom: Breaking Changes

    Mocha is going ESM-first! This means that it will now use ESM import(test_file) to load the test files, instead of the CommonJS require(test_file). This is not a problem, as import can also load most files that require does. In the rare cases where this fails, it will fallback to require(...). This ESM-first approach is the next step in Mocha's ESM migration, and allows ESM loaders to load and transform the test file.

    • #4636: Remove deprecated utils.lookupFiles() (@juergba)

    • #4638: Limit the size of actual/expected for diff generation (@juergba)

    • ๐Ÿ‘ #4389: Refactoring: Consuming log-symbols alternate to code for win32 in reporters/base (@MoonSupport)

    :tada: Enhancements

    ๐Ÿ›  :bug: Fixes

    • #4128: Fix: control stringification of error message (@syeutyu)

    :nut_and_bolt: Other

  • v8.4.0 Changes

    May 07, 2021

    :tada: Enhancements

    ๐Ÿ›  :bug: Fixes

    ๐Ÿ“š :book: Documentation

    • #4630: Add options.require to Mocha constructor for root hook plugins on parallel runs (@juergba)
    • #4617: Dynamically generating tests with top-level await and ESM test files (@juergba)
    • #4608: Update default file extensions (@outsideris)

    Also thanks to @outsideris for various improvements on our GH actions workflows.

  • v8.3.2 Changes

    March 12, 2021

    ๐Ÿ›  :bug: Fixes

    ๐Ÿ“š :book: Documentation

  • v8.3.1 Changes

    March 06, 2021

    ๐Ÿ›  :bug: Fixes

    • #4577: Browser: fix EvalError caused by regenerator-runtime (@snoack)
    • #4574: ESM: allow import from mocha in parallel mode (@nicojs)
  • v8.3.0 Changes

    February 11, 2021

    :tada: Enhancements

    ๐Ÿ›  :bug: Fixes

    • #4557: Add file location when SyntaxError happens in ESM (@giltayar)
    • #4521: Fix require error when bundling Mocha with Webpack (@devhazem)

    ๐Ÿ“š :book: Documentation

    :nut_and_bolt: Other

    Also thanks to @outsideris and @HyunSangHan for various fixes to our website and documentation.

  • v8.2.1 Changes

    November 02, 2020

    8.2.1 / 2020-11-02

    ๐Ÿ›  Fixed stuff.

    ๐Ÿฑ ๐Ÿ› Fixes

    • #4489: Fix problematic handling of otherwise-unhandled Promise rejections and erroneous "done() called twice" errors (@boneskull)
    • #4496: Avoid MaxListenersExceededWarning in watch mode (@boneskull)

    Also thanks to @akeating for a documentation fix!

  • v8.2.0 Changes

    October 16, 2020

    8.2.0 / 2020-10-16

    The major feature added in v8.2.0 is addition of support for global fixtures.

    While Mocha has always had the ability to run setup and teardown via a hook (e.g., a before() at the top level of a test file) when running tests in serial, Mocha v8.0.0 added support for parallel runs. Parallel runs are incompatible with this strategy; e.g., a top-level before() would only run for the file in which it was defined.

    With global fixtures, Mocha can now perform user-defined setup and teardown regardless of mode, and these fixtures are guaranteed to run once and only once. This holds for parallel mode, serial mode, and even "watch" mode (the teardown will run once you hit Ctrl-C, just before Mocha finally exits). Tasks such as starting and stopping servers are well-suited to global fixtures, but not sharing resources--global fixtures do not share context with your test files (but they do share context with each other).

    Here's a short example of usage:

    // fixtures.js// can be async or notexports.mochaGlobalSetup = async function() {this.server = await startSomeServer({port: process.env.TEST\_PORT});console.log(`server running on port ${this.server.port}`);};exports.mochaGlobalTeardown = async function() {// the context (`this`) is shared, but not with the test filesawait this.server.stop();console.log(`server on port ${this.server.port} stopped`);};// this file can contain root hook plugins as well!// exports.mochaHooks = { ... }

    ๐Ÿ›  Fixtures are loaded with --require, e.g., mocha --require fixtures.js.

    ๐Ÿ“š For detailed information, please see the documentation and this handy-dandy flowchart to help understand the differences between hooks, root hook plugins, and global fixtures (and when you should use each).

    ๐Ÿฑ ๐ŸŽ‰ Enhancements

    For implementors of custom reporters:

    • #4409: Parallel mode and custom reporter improvements (@boneskull):
      • Support custom worker-process-only reporters (Runner.prototype.workerReporter()); reporters should subclass ParallelBufferedReporter in mocha/lib/nodejs/reporters/parallel-buffered
      • Allow opt-in of object reference matching for "sufficiently advanced" custom reporters (Runner.prototype.linkPartialObjects()); use if strict object equality is needed when consuming Runner event data
      • Enable detection of parallel mode (Runner.prototype.isParallelMode())

    ๐Ÿฑ ๐Ÿ› Fixes

    • #4476: Workaround for profoundly bizarre issue affecting npm v6.x causing some of Mocha's deps to be installed when mocha is present in a package's devDependencies and npm install --production is run the package's working copy (@boneskull)
    • #4465: Worker processes guaranteed (as opposed to "very likely") to exit before Mocha does; fixes a problem when using nyc with Mocha in parallel mode (@boneskull)
    • #4419: Restore lookupFiles() in mocha/lib/utils, which was broken/missing in Mocha v8.1.0; it now prints a deprecation warning (use const {lookupFiles} = require('mocha/lib/cli') instead) (@boneskull)

    Thanks to @AviVahl, @donghoon-song, @ValeriaVG, @znarf, @sujin-park, and @majecty for other helpful contributions!