8.0.0 / 2020-06-10

In this major release, Mocha adds the ability to run tests in parallel. Better late than never! Please note the breaking changes detailed below.

Let's welcome @giltayar and @nicojs to the maintenance team!

💥 Breaking Changes

• #4164: Mocha v8.0.0 now requires Node.js v10.12.0 or newer. Mocha no longer supports the Node.js v8.x line ("Carbon"), which entered End-of-Life at the end of 2019 (@UlisesGascon)

• #4175: Having been deprecated with a warning since v7.0.0, mocha.opts is no longer supported (@juergba)

  ✨ WORKAROUND: Replace mocha.opts with a configuration file.

• #4260: Remove enableTimeout() (this.enableTimeout()) from the context object (@craigtaub)

  ✨ WORKAROUND: Replace usage of this.enableTimeout(false) in your tests with this.timeout(0).

• #4315: The spec option no longer supports a comma-delimited list of files (@juergba)

  ✨ WORKAROUND: Use an array instead (e.g., "spec": "foo.js,bar.js" becomes "spec": ["foo.js", "bar.js"]).

• #4309: Drop support for Node.js v13.x line, which is now End-of-Life (@juergba)

• #4282: --forbid-only will throw an error even if exclusive tests are avoided via --grep or other means (@arvidOtt)

• #4223: The context object's skip() (this.skip()) in a "before all" (before()) hook will no longer execute subsequent sibling hooks, in addition to hooks in child suites (@juergba)

• #4178: Remove previously soft-deprecated APIs (@wnghdcjfe):

  • Mocha.prototype.ignoreLeaks()
  • Mocha.prototype.useColors()
  • Mocha.prototype.useInlineDiffs()
  • Mocha.prototype.hideDiff()

🎉 Enhancements

• #4245: Add ability to run tests in parallel for Node.js (see docs) (@boneskull)

  ❗ See also #4244; Root Hook Plugins (docs) -- root hooks must be defined via Root Hook Plugins to work in parallel mode

• #4304: --require now works with ES modules (@JacobLey)

• #4299: In some circumstances, Mocha can run ES modules under Node.js v10 -- use at your own risk! (@giltayar)

📖 Documentation

• #4246: Add documentation for parallel mode and Root Hook plugins (@boneskull)

🔩 Other

• #4200: Drop mkdirp and replace it with fs.mkdirSync (@HyunSangHan)

🐛 Fixes

(All bug fixes in Mocha v8.0.0 are also breaking changes, and are listed above)

7.2.0 / 2020-05-22

🎉 Enhancements

• #4234: Add ability to run tests in a mocha instance multiple times (@nicojs)
• #4219: Exposing filename in JSON, doc, and json-stream reporters (@Daniel0113)
• #4244: Add Root Hook Plugins (@boneskull)

🐛 Fixes

• #4258: Fix missing dot in name of configuration file (@sonicdoe)
• #4194: Check if module.paths really exists (@ematipico)
• #4256: --forbid-only does not recognize it.only when before crashes (@arvidOtt)
• #4152: Bug with multiple async done() calls (@boneskull)
• #4275: Improper warnings for invalid reporters (@boneskull)
• #4288: Broken hook.spec.js test for IE11 (@boneskull)

📖 Documentation

• #4081: Insufficient white space for API docs in view on mobile (@HyunSangHan)
• #4255: Update mocha-docdash for UI fixes on API docs (@craigtaub)
• #4235: Enable emoji on website; enable normal ul elements (@boneskull)
• #4272: Fetch sponsors at build time, show ALL non-skeevy sponsors (@boneskull)

🔩 Other

• #4249: Refactoring improving encapsulation (@arvidOtt)
• #4242: CI add job names, add Node.js v14 to matrix (@boneskull)
• #4237: Refactor validatePlugins to throw coded errors (@boneskull)
• #4236: Better debug output (@boneskull)

7.1.2 / 2020-04-26

🔩 Other

• #4251: Prevent karma-mocha from stalling (@juergba)
• #4222: Update dependency mkdirp to v0.5.5 (@outsideris)

📖 Documentation

• #4208: Add Wallaby logo to site (@boneskull)

6.2.3 / 2020-03-25

🔒 Security Fixes

• 848d6fb8: Update dependencies mkdirp, yargs-parser and yargs (@juergba)

7.1.1 / 2020-03-18

🔒 Security Fixes

• #4204: Update dependencies mkdirp, yargs-parser and yargs (@juergba)

🐛 Fixes

• #3660: Fix runner listening to start and end events (@juergba)

📖 Documentation

• #4190: Show Netlify badge on footer (@outsideris)

7.1.0 / 2020-02-26

🎉 Enhancements

#4038: Add Node.js native ESM support (@giltayar)

Mocha supports writing your test files as ES modules:

• Node.js only v12.11.0 and above
• Node.js below v13.2.0, you must set --experimental-modules option
• current limitations: please check our documentation
• for programmatic usage: see API: loadFilesAsync()

Note: Node.JS native ECMAScript Modules implementation has status: Stability: 1 - Experimental

🐛 Fixes

• #4181: Programmatic API cannot access retried test objects (@juergba)
• #4174: Browser: fix allowUncaught option (@juergba)

📖 Documentation

• #4058: Manage author list in AUTHORS instead of package.json (@outsideris)

🔩 Other

• #4138: Upgrade ESLint v6.8 (@kaicataldo)

7.0.1 / 2020-01-25

🐛 Fixes

• #4165: Fix exception when skipping tests programmatically (@juergba)
• #4153: Restore backwards compatibility for reporterOptions (@holm)
• #4150: Fix recovery of an open test upon uncaught exception (@juergba)
• #4147: Fix regression of leaking uncaught exception handler (@juergba)

📖 Documentation

• #4146: Update copyright & trademark notices per OJSF (@boneskull)
• #4140: Fix broken links (@KyoungWan)

🔩 Other

• #4133: Print more descriptive error message (@Zirak)

7.0.0-esm1 / 2020-01-12

This is an experimental release based on v7.0.0: npm i [email protected]

🎉 Enhancements

#4038: Add Node.js native ESM support (@giltayar)

Enables Mocha to load ECMAScript Modules test files, also valid for --file option.

Limitations:

• Node.js only v12.11.0 and above
• Node.js below v13.2.0, you must set --experimental-modules option
• ESM not (yet) supported for:
  • --watch mode
  • --require option
  • --reporter custom reporters
  • --ui custom interfaces
  • mocharc configuration file

7.0.0 / 2020-01-05

💥 Breaking Changes

• #3885: Drop Node.js v6.x support (@mojosoeun)
• #3890: Remove Node.js debug-related flags --debug/--debug-brk and deprecate debug argument (@juergba)
• #3962: Changes to command-line options (@ParkSB):
  • --list-interfaces replaces --interfaces
  • --list-reporters replaces --reporters
• Hook pattern of this.skip() (@juergba):
  • #3859: When conditionally skipping in a it test, related afterEach hooks are now executed
  • #3741: When conditionally skipping in a beforeEach hook, subsequent inner beforeEach hooks are now skipped and related afterEach hooks are executed
  • #4136: Disallow this.skip() within after hooks
• #3967: Remove deprecated getOptions() and lib/cli/options.js (@juergba)
• #4083: Uncaught exception in pending test: don't swallow, but retrospectively fail the test for correct exit code (@juergba)
• #4004: Align Mocha constructor's option names with command-line options (@juergba)

🎉 Enhancements

• #3980: Refactor and improve --watch mode with chokidar (@geigerzaehler):
  • adds command-line options --watch-files and --watch-ignore
  • removes --watch-extensions
• #3979: Type "rs\n" to restart tests (@broofa)

📠 Deprecations

These are soft-deprecated, and will emit a warning upon use. Support will be removed in (likely) the next major version of Mocha:

• #3968: Deprecate legacy configuration via mocha.opts (@juergba)

🐛 Fixes

• #4125: Fix timeout handling with --inspect-brk/--inspect (@juergba)
• #4070: Mocha constructor: improve browser setup (@juergba)
• #4068: XUnit reporter should handle exceptions during diff generation (@rgroothuijsen)
• #4030: Fix --allow-uncaught with this.skip() (@juergba)

🔍 Coverage

• #4109: Add Node.js v13.x to CI test matrix (@juergba)

📖 Documentation

• #4129: Fix broken links (@SaeromB)
• #4127: Add reporter alias names to docs (@khg0712)
• #4101: Clarify invalid usage of done() (@jgehrcke)
• #4092: Replace :coffee: with emoji ☕️ (@pzrq)
• #4088: Initial draft of project charter (@boneskull)
• #4066: Change sh to bash for code block in docs/index.md (@HyunSangHan)
• #4045: Update README.md concerning GraphicsMagick installation (@HyunSangHan)
• #3988: Fix sponsors background color for readability (@outsideris)

🔩 Other

• #4118: Update node-environment-flags to 1.0.6 (@kylef)
• #4097: Add GH Funding Metadata (@SheetJSDev)
• #4089: Add funding information to package.json (@Munter)
• #4077: Improve integration tests (@soobing)

6.2.2 / 2019-10-18

🐛 Fixes

• #4025: Fix duplicate EVENT_RUN_END events upon uncaught exception (@juergba)
• #4051: Fix "unhide" function in html reporter (browser) (@pec9399)
• #4063: Fix use of esm in Node.js v8.x (@boneskull)
• #4033: Fix output when multiple async exceptions are thrown (@juergba)

📖 Documentation

• #4046: Site accessibility fixes (@Mia-jeong)
• #4026: Update docs for custom reporters in browser (@Lindsay-Needs-Sleep)
• #3971: Adopt new OpenJS Foundation Code of Conduct (@craigtaub)