mocha 8.0.0

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!

:boom: 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)

:sparkles: WORKAROUND: Replace mocha.opts with a configuration file.
#4260: Remove enableTimeout() (this.enableTimeout()) from the context object (@craigtaub)

:sparkles: 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)

:sparkles: 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()

:tada: Enhancements

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

:exclamation: 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)

:book: Documentation

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

:nut_and_bolt: Other

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

:bug: Fixes

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