5.2.0 / 2018-05-18

🎉 Enhancements

• #3375: Add support for comments in mocha.opts (@plroebuck)

🐛 Fixes

• #3346: Exit correctly from before hooks when using --bail (@outsideris)

📖 Documentation

• #3328: Mocha-flavored API docs! (@Munter)

🔩 Other

• #3330: Use Buffer.from() (@harrysarson)
• #3295: Remove redundant folder (@DavNej)
• #3356: Refactoring (@plroebuck)

The new version differs by 30 commits.

• 5bd33a0 Release v5.2.0
• 0a5604f reformat missed files
• 7c8f551 ensure scripts/*.js gets prettiered
• d8ea2ba update CHANGELOG.md for v5.2.0 [ci skip]
• 7203ed7 update all dependencies
• fb5393b migrate Mocha's tests to Unexpected assertion library (#3343)
• fae9af2 docs(docs/index.md): Update "mocha.opts" documentation
• 9d9e6c6 feat(bin/options.js): Add support for comment lines in "mocha.opts"
• e0306ff fix busted lint-staged config
• f2be6d4 Annotate when exceptions are caught but ignored; closes #3354 (#3356)
• 889e681 remove dead code in bin/_mocha
• 8712b95 fix(ocd): re-order Node.js tests in .travis.yml (descending)
• 3ab0e7e fix to exit correctly when using bail flag
• d87b12e add Node.js v10 to build; fix win32 issues (#3350)
• b392af5 update package-lock.json for npm@6 [ci skip]

There are 30 commits in total.

See the full diff

6.0.0 / 2019-02-18

💥 Breaking Changes

• #3149: Drop Node.js v4.x support (@outsideris)
• #3556: Changes to command-line options (@boneskull):
  • --grep and --fgrep are now mutually exclusive; attempting to use both will cause Mocha to fail instead of simply ignoring --grep
  • --compilers is no longer supported; attempting to use will cause Mocha to fail with a link to more information
  • -d is no longer an alias for --debug; -d is currently ignored
  • #3275: --watch-extensions no longer implies js; it must be explicitly added (@TheDancingCode)
• #2908: tap reporter emits error messages (@chrmod)
• #2819: When conditionally skipping in a before hook, subsequent before hooks and tests in nested suites are now skipped (@bannmoore)
• #627: Emit filepath in "timeout exceeded" exceptions where applicable (@boneskull)
• #3556: lib/template.html has moved to lib/browser/template.html (@boneskull)
• #2576: An exception is now thrown if Mocha fails to parse or find a mocha.opts at a user-specified path (@plroebuck)
• #3458: Instantiating a Base-extending reporter without a Runner parameter will throw an exception (@craigtaub)
• #3125: For consumers of Mocha's programmatic API, all exceptions thrown from Mocha now have a code property (and some will have additional metadata). Some Error messages have changed. Please use the code property to check Error types instead of the message property; these descriptions will be localized in the future. (@craigtaub)

📠 Deprecations

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

• -gc users should use --gc-global instead
• Consumers of the function exported by bin/options should now use the loadMochaOpts or loadOptions (preferred) functions exported by the lib/cli/options module

Regarding the Mocha class constructor (from lib/mocha):

• Use property color: false instead of useColors: false
• Use property timeout: false instead of enableTimeouts: false

All of the above deprecations were introduced by #3556.

mocha.opts is now considered "legacy"; please prefer RC file or package.json over mocha.opts.

🎉 Enhancements

• #3726: Add ability to unload files from require cache (@plroebuck)

Enhancements introduced in #3556:

• Mocha now supports "RC" files in JS, JSON, YAML, or package.json-based (using mocha property) format

  • .mocharc.js, .mocharc.json, .mocharc.yaml or .mocharc.yml are valid "rc" file names and will be automatically loaded
  • Use --config /path/to/rc/file to specify an explicit path
  • Use --package /path/to/package.json to specify an explicit package.json to read the mocha prop from
  • Use --no-config or --no-package to completely disable loading of configuration via RC file and package.json, respectively
  • Configurations are merged as applicable using the priority list:
    1. Command-line arguments
    2. RC file
    3. package.json
    4. mocha.opts
    5. Mocha's own defaults
  • Check out these example config files

• Node/V8 flag support in mocha executable:

  • Support all allowed node flags as supported by the running version of node (also thanks to @demurgos)
  • Support any V8 flag by prepending --v8- to the flag name
  • All flags are also supported via config files, package.json properties, or mocha.opts
  • Debug-related flags (e.g., --inspect) now imply --no-timeouts
  • Use of e.g., --debug will automatically invoke --inspect if supported by running version of node

• Support negation of any Mocha-specific command-line flag by prepending --no- to the flag name

• Interfaces now have descriptions when listed using --interfaces flag

• Mocha constructor supports all options

• --extension is now an alias for --watch-extensions and affects non-watch-mode test runs as well. For example, to run only test/*.coffee (not test/*.js), you can do mocha --require coffee-script/register --extensions coffee.

• #3552: tap reporter is now TAP13-capable (@plroebuck & @mollstam)

• #3535: Mocha's version can now be queried programmatically via public property Mocha.prototype.version (@plroebuck)

• #3428: xunit reporter shows diffs (@mlucool)

• #2529: Runner now emits a retry event when tests are retried (reporters can listen for this) (@catdad)

• #2962, #3111: In-browser notification support; warn about missing prereqs when --growl supplied (@plroebuck)

🐛 Fixes

• #3737: Fix falsy values from options globals (@plroebuck)
• #3707: Fix encapsulation issues for Suite#_onlyTests and Suite#_onlySuites (@vkarpov15)
• #3711: Fix diagnostic messages dealing with plurality and markup of output (@plroebuck)
• #3723: Fix "reporter-option" to allow comma-separated options (@boneskull)
• #3722: Fix code quality and performance of lookupFiles and files (@plroebuck)
• #3650, #3654: Fix noisy error message when no files found (@craigtaub)
• #3632: Tests having an empty title are no longer confused with the "root" suite (@juergba)
• #3666: Fix missing error codes (@vkarpov15)
• #3684: Fix exiting problem in Node.js v11.7.0+ (@addaleax)
• #3691: Fix --delay (and other boolean options) not working in all cases (@boneskull)
• #3692: Fix invalid command-line argument usage not causing actual errors (@boneskull)
• #3698, #3699: Fix debug-related Node.js options not working in all cases (@boneskull)
• #3700: Growl notifications now show the correct number of tests run (@outsideris)
• #3686: Avoid potential ReDoS when diffing large objects (@cyjake)
• #3715: Fix incorrect order of emitted events when used programmatically (@boneskull)
• #3706: Fix regression wherein --reporter-option/--reporter-options did not support comma-separated key/value pairs (@boneskull)
• Fix missing mocharc.json in published package (@boneskull)
• #3356: --no-timeouts and --timeout 0 now does what you'd expect (@boneskull)
• #3475: Restore --no-exit option (@boneskull)
• #3570: Long-running tests now respect SIGINT (@boneskull)
• #2944: --forbid-only and --forbid-pending now "fail fast" when encountered on a suite (@outsideris)
• #1652, #2951: Fix broken clamping of timeout values (@plroebuck)
• #2753: start and end events now emitted properly from Runner instance when using Mocha programmatically (@outsideris)
• #2095, #3521: Do not log stdout: prefix in browser console (@Bamieh)
• #3595: Fix mochajs.org deployment problems (@papandreou)
• #3518: Improve utils.isPromise() (@fabiosantoscode)
• #3320: Fail gracefully when non-extensible objects are thrown in async tests (@fargies)
• #2475: XUnit does not duplicate test result numbers in "errors" and "failures"; "failures" will always be zero (@mlucool)
• #3398, #3598, #3457, #3617: Fix regression wherein --bail would not execute "after" nor "after each" hooks (@juergba)
• #3580: Fix potential exception when using XUnit reporter programmatically (@Lana-Light)
• #1304: Do not output color to TERM=dumb (@plroebuck)

📖 Documentation

• #3525: Improvements to .github/CONTRIBUTING.md (@markowsiak)
• #3466: Update description of slow option (@finfin)
• #3405: Remove references to bower installations (@goteamtim)
• #3361: Improvements to --watch docs (@benglass)
• #3136: Improve docs around globbing and shell expansion (@akrawchyk)
• #2819: Update docs around skips and hooks (@bannmoore)
• Many improvements by @outsideris
• #3652: Switch from Jekyll to Eleventy (@Munter)

🔩 Other

• #3677: Add error objects for createUnsupportedError and createInvalidExceptionError (@boneskull)
• #3733: Removed unnecessary processing in post-processing hook (@wanseob)
• #3730: Update nyc to latest version (@coreyfarrell)
• #3648, #3680: Fixes to support latest versions of unexpected and unexpected-sinon (@sunesimonsen)
• #3638: Add meta tag to site (@MartijnCuppens)
• #3653: Fix parts of test suite failing to run on Windows (@boneskull)
• #3557: Use ms userland module instead of hand-rolled solution (@gizemkeser)
• Many CI fixes and other refactors by @plroebuck
• Test refactors by @outsideris

The new version differs by 209 commits ahead by 209, behind by 39.

• 42303e2 Release v6.0.0
• a553ca7 punctuation updates for changelog v6.0.0
• c710792 grammar updates for changelog v6.0.0
• 9f9293a update changelog for v6.0.0
• a540eb0 remove "projects" section from MAINTAINERS.md [ci skip]
• 52b5c42 Uppercased JSON reporter name in describe title (#3739)
• 82307fb Fix .globals to remove falsy values (#3737)
• 56dc28e Remove unnecessary post-processing code having no effect; closes #3708 (#3733)
• 16b4281 Documentation updates (#3728)
• 5d9d3eb Update nyc
• 118c9ae Refactor out usages of Suite#_onlyTests and Suite#_onlyTests (#3689) (#3707)
• 0dacd1f Add ability to unload files from require cache (redux) (#3726)
• 66a52f2 update release steps [ci skip]
• 45ae014 Refactor lookupFiles and files (#3722)
• 94c9320 fix --reporter-option to allow comma-separated options; closes #3706

There are 209 commits in total.

See the full diff

6.0.1 / 2019-02-21

The obligatory round of post-major-release bugfixes.

🐛 Fixes

These issues were regressions.

• #3754 - Mocha again finds test.js when run without arguments (@plroebuck)
• #3756 - Mocha again supports third-party interfaces via --ui (@boneskull)
• #3755 - Fix broken --watch (@boneskull)
• #3759 - Fix unwelcome deprecation notice when Mocha run against languages (CoffeeScript) with implicit return statements; returning a non-undefined value from a describe callback is no longer considered deprecated (@boneskull)

📖 Documentation

• #3738 - Upgrade to @mocha/docdash@2 (@tendonstrength)
• #3751 - Use preferred names for example config files (@Szauka)

The new version differs by 9 commits.

• 6d3d6b4 Release v6.0.1
• 2146ece update CHANGELOG.md for v6.0.1
• 7c9221d backout deprecation of value returned from suite; closes #3744
• b7cfceb fix --watch not finding any files to execute; closes #3748
• b836d73 Upgrade docdash version - issue #3663
• 7926f47 fix --ui issues, closes #3746
• 00f2ed9 dev dep upgrades from "npm audit" and "npm upgrade"
• 34afb1a fix(cli/run.js): Revert default glob to match Mocha-5.2
• 6d5a0db Bring the example congfiguration file in line with the documentation. (#3751)

See the full diff

6.0.2 / 2019-02-25

🐛 Fixes

Two more regressions fixed:

• #3768: Test file paths no longer dropped from mocha.opts (@boneskull)
• #3767: --require does not break on module names that look like certain node flags (@boneskull)

The new version differs by 6 commits.

• 00a895f Release v6.0.2
• 1edce76 update CHANGELOG for v6.0.2 [ci skip]
• 347e9db fix broken positional arguments in config; ensure positional args are unique; closes #3763
• 9e31e9d fix handling of bareword args matching node flags; closes #3761
• 6535965 Update "karma-browserify" to eliminate Karma middleware warning (#3762)
• 37febb6 improve issue template. (#3411)

See the full diff

6.1.0 / 2019-04-07

🔒 Security Fixes

• #3845: Update dependency "js-yaml" to v3.13.0 per npm security advisory (@plroebuck)

🎉 Enhancements

• #3766: Make reporter constructor support optional options parameter (@plroebuck)
• #3760: Add support for config files with .jsonc extension (@sstephant)

📠 Deprecations

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

• #3719: Deprecate this.skip() for "after all" hooks (@juergba)

🐛 Fixes

• #3829: Use cwd-relative pathname to load config file (@plroebuck)
• #3745: Fix async calls of this.skip() in "before each" hooks (@juergba)
• #3669: Enable --allow-uncaught for uncaught exceptions thrown inside hooks (@givanse)

and some regressions:

• #3848: Fix Suite cloning by copying root property (@fatso83)
• #3816: Guard against undefined timeout option (@boneskull)
• #3814: Update "yargs" in order to avoid deprecation message (@boneskull)
• #3788: Fix support for multiple node flags (@aginzberg)

📖 Documentation

• mochajs/mocha-examples: New repository of working examples of common configurations using mocha (@craigtaub)
• #3850: Remove pound icon showing on header hover on docs (@jd2rogers2)
• #3812: Add autoprefixer to documentation page CSS (@Munter)
• #3811: Update doc examples "tests.html" (@DavidLi119)
• #3807: Mocha website HTML tweaks (@plroebuck)
• #3793: Update config file example ".mocharc.yml" (@cspotcode)

🔩 Other

• #3830: Replace dependency "findup-sync" with "find-up" for faster startup (@cspotcode)
• #3799: Update devDependencies to fix many npm vulnerabilities (@XhmikosR)

The new version differs by 28 commits.

• f4fc95a Release v6.1.0
• bd29dbd update CHANGELOG for v6.1.0 [ci skip]
• aaf2b72 Use cwd-relative pathname to load config file (#3829)
• b079d24 upgrade deps as per npm audit fix; closes #3854
• e87c689 Deprecate this.skip() for "after all" hooks (#3719)
• 81cfa90 Copy Suite property "root" when cloning; closes #3847 (#3848)
• 8aa2fc4 Fix issue 3714, hide pound icon showing on hover header on docs page (#3850)
• 586bf78 Update JS-YAML to address security issue (#3845)
• d1024a3 Update doc examples "tests.html" (#3811)
• 1d570e0 Delete "/docs/example/chai.js"
• ade8b90 runner.js: "self.test" undefined in Browser (#3835)
• 0098147 Replace findup-sync with find-up for faster startup (#3830)
• d5ba121 Remove "package" flag from sample config file because it can only be passes as CLI arg (#3793)
• a3089ad update package-lock
• 75430ec Upgrade yargs-parser dependency to avoid loading 2 copies of yargs

There are 28 commits in total.

See the full diff