Skip to content
Choose a tag to compare


@boneskull boneskull released this
· 248 commits to master since this release
Choose a tag to compare

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

📖 Documentation

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

🔩 Other

🐛 Fixes

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