6.2.1 / 2019-09-29

:bug: Fixes

:book: Documentation

6.2.0 / 2019-07-18

:tada: Enhancements

:bug: Fixes

:book: Documentation

:mag: Coverage

:nut_and_bolt: Other

6.1.4 / 2019-04-18

:lock: Security Fixes

6.1.3 / 2019-04-11

:bug: Fixes

6.1.2 / 2019-04-08

:bug: Fixes

6.1.1 / 2019-04-07

:bug: Fixes

6.1.0 / 2019-04-07

:lock: Security Fixes

:tada: Enhancements

:fax: Deprecations

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

:bug: Fixes

and some regressions:

:book: Documentation

:nut_and_bolt: Other

6.0.2 / 2019-02-25

:bug: Fixes

Two more regressions fixed:

6.0.1 / 2019-02-21

The obligatory round of post-major-release bugfixes.

:bug: Fixes

These issues were regressions.

:book: Documentation

6.0.0 / 2019-02-18

:tada: Enhancements

:bug: Fixes

:book: Documentation

:nut_and_bolt: Other

6.0.0-1 / 2019-01-02

:bug: Fixes

6.0.0-0 / 2019-01-01

Documentation for this release can be found at {next.mochajs.org}[https://next.mochajs.org]!

Welcome {@plroebuck}, {@craigtaub}, & {@markowsiak} to the team!

:boom: Breaking Changes

:fax: Deprecations

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

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

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.

:tada: Enhancements

Enhancements introduced in #3556:

:bug: Fixes

:book: Documentation

:nut_and_bolt: Other

5.2.0 / 2018-05-18

:tada: Enhancements

:bug: Fixes

:book: Documentation

:nut_and_bolt: Other

5.1.1 / 2018-04-18

:bug: Fixes

5.1.0 / 2018-04-12

:tada: Enhancements

:bug: Fixes

:book: Documentation

:nut_and_bolt: Other

5.0.5 / 2018-03-22

Welcome @outsideris to the team!

:bug: Fixes

:book: Documentation

:nut_and_bolt: Other

5.0.4 / 2018-03-07

:bug: Fixes

5.0.3 / 2018-03-06

This patch features a fix to address a potential “low severity” ReDoS vulnerability in the diff package (a dependency of Mocha).

:lock: Security Fixes

:nut_and_bolt: Other

5.0.2 / 2018-03-05

This release fixes a class of tests which report as false positives. Certain tests will now break, though they would have previously been reported as passing. Details below. Sorry for the inconvenience!

:bug: Fixes

“`js it('should actually fail, sorry!', function (done) { // passing assertion assert(true === true);

// test complete & is marked as passing done();

// …but something evil lurks within setTimeout(() => { throw new Error('chaos!'); }, 100); }); “`

Previously to this version, Mocha would have silently swallowed the chaos! exception, and you wouldn't know. Well, now you know. Mocha cannot recover from this gracefully, so it will exit with a nonzero code.

Maintainers of external reporters: If a test of this class is encountered, the Runner instance will emit the end event twice; you may need to change your reporter to use runner.once('end') intead of runner.on('end').

:nut_and_bolt: Other

5.0.1 / 2018-02-07

…your garden-variety patch release.

Special thanks to Wallaby.js for their continued support! :heart:

:bug: Fixes

:book: Documentation

:nut_and_bolt: Other

5.0.0 / 2018-01-17

Mocha starts off 2018 right by again dropping support for unmaintained rubbish.

Welcome @vkarpov15 to the team!

:boom: Breaking Changes

:tada: Enhancements

:bug: Fixes

:sunglasses: Developer Experience

:book: Documentation

:nut_and_bolt: Other

4.1.0 / 2017-12-28

This is mainly a “housekeeping” release.

Welcome @Bamieh and @xxczaki to the team!

:bug: Fixes

:tada: Enhancements

:book: Documentation

:nut_and_bolt: Other

4.0.1 / 2017-10-05

:bug: Fixes

4.0.0 / 2017-10-02

You might want to read this before filing a new bug! :stuck_out_tongue_closed_eyes:

:boom: Breaking Changes

For more info, please read this article.

Compatibility

Default Behavior

Reporter Output

:-1: Deprecations

:tada: Enhancements

:book: Documentation

:nut_and_bolt: Other

3.5.3 / 2017-09-11

:bug: Fixes

3.5.2 / 2017-09-10

:bug: Fixes

3.5.1 / 2017-09-09

:newspaper: News

:bug: Fixes

:nut_and_bolt: Other

3.5.0 / 2017-07-31

:newspaper: News

:lock: Security Fixes

:tada: Enhancements

:nut_and_bolt: Other

3.4.2 / 2017-05-24

:bug: Fixes

:nut_and_bolt: Other

3.4.1 / 2017-05-14

Fixed a publishing mishap with git's autocrlf settings.

3.4.0 / 2017-05-14

Mocha is now moving to a quicker release schedule: when non-breaking changes are merged, a release should happen that week.

This week's highlights:

:tada: Enhancements

:bug: Fixes

:nut_and_bolt: Other

3.3.0 / 2017-04-24

Thanks to all our contributors, maintainers, sponsors, and users! ❤️

As highlights:

:tada: Enhancements

:bug: Fixes

:mag: Coverage

:nut_and_bolt: Other

3.2.0 / 2016-11-24

:newspaper: News

Mocha is now a JS Foundation Project!

Mocha is proud to have joined the JS Foundation. For more information, read the announcement.

Contributor License Agreement

Under the foundation, all contributors to Mocha must sign the JS Foundation CLA before their code can be merged. When sending a PR–if you have not already signed the CLA–a friendly bot will ask you to do so.

Mocha remains licensed under the MIT license.

:bug: Bug Fix

:tada: Enhancement

:nut_and_bolt: Other

Thanks to all our contributors, sponsors and backers! Keep on the lookout for a public roadmap and new contribution guide coming soon.

3.1.2 / 2016-10-10

:bug: Bug Fix

3.1.1 / 2016-10-09

:bug: Bug Fix

:nut_and_bolt: Other

3.1.0 / 2016-09-27

:tada: Enhancement

:bug: Bug Fix

3.0.2 / 2016-08-08

:bug: Bug Fix

3.0.1 / 2016-08-03

:bug: Bug Fix

3.0.0 / 2016-07-31

:boom: Breaking Changes

“`js const assert = require('assert');

it('should complete this test', function (done) { return new Promise(function (resolve) { assert.ok(true); resolve(); }) .then(done); }); “`

The above test will fail with Error: Resolution method is overspecified. Specify a callback or return a Promise; not both..

:tada: Enhancements

:bug: Bug Fixes

:nut_and_bolt: Other

We :heart: our backers and sponsors!

:shipit:

2.5.3 / 2016-05-25

2.5.2 / 2016-05-24

2.5.1 / 2016-05-23

Thanks {@entertainyou}, {@SimenB}, {@just-paja} for the heads-up.

2.5.0 / 2016-05-23

This has been awhile coming! We needed to feel confident that the next release wouldn't break browser compatibility (e.g. the last few patch releases).

Browser Tests in CI

We now run unit tests against PhantomJS v1.x and an assortment of browsers on SauceLabs, including:

To accomplish this, we now run Mocha's unit tests (and a handful of integration tests) via Karma and a modified karma-mocha. Along the way, we had to solve issue #880 (apologies to {@mderijcke} and {@sukima} who had PRs addressing this), as well as replace most usages of should with expect.js for IE8.

Going forward, when sending PRs, your code will only run against PhantomJS v1.x (and not hit SauceLabs) because security.

Node.js 6.x

Node.js 6.x “just worked” before, but now it's in the CI matrix, so it's “officially” supported. Mocha still retains support for Node.js 0.8.x.

“Minor” Release

You'll see mostly bug fixes below, but also a couple features–as such, it's a “minor” release.

TYVM

Thanks to everyone who contributed, and our fabulous sponsors and backers!

2.4.5 / 2016-01-28

2.4.4 / 2016-01-27

2.4.3 / 2016-01-27

2.4.2 / 2016-01-26

2.4.1 / 2016-01-26

2.4.0 / 2016-01-25

2.3.4 / 2015-11-15

2.3.3 / 2015-09-19

2.3.2 / 2015-09-07

2.3.1 / 2015-09-06

2.3.0 / 2015-08-30

2.2.5 / 2015-05-14

2.2.4 / 2015-04-08

2.2.3 / 2015-04-07

2.2.1 / 2015-03-09

2.2.0 / 2015-03-06

2.1.0 / 2014-12-23

2.0.0 / 2014-10-21

1.21.5 / 2014-10-11

1.22.1-3 / 2014-07-27

1.22.1-3 / 2014-07-27

1.21.0 / 2014-07-23

1.20.1 / 2014-06-03

1.20.0 / 2014-05-28

1.19.0 / 2014-05-17

1.18.2 / 2014-03-18

1.18.1 / 2014-03-18

1.18.0 / 2014-03-13

1.17.1 / 2014-01-22

1.17.0 / 2014-01-09

1.16.2 / 2013-12-23

1.16.1 / 2013-12-19

1.16.0 / 2013-12-19

1.15.1 / 2013-12-03

1.15.0 / 2013-12-02

1.14.0 / 2013-11-02

1.13.0 / 2013-09-15

1.12.1 / 2013-08-29

1.12.0 / 2013-07-01

1.11.0 / 2013-06-12

1.10.0 / 2013-05-21

1.9.0 / 2013-04-03

1.8.2 / 2013-03-11

1.8.1 / 2013-01-09

1.8.0 / 2013-01-08

1.7.4 / 2012-12-06

1.7.3 / 2012-11-30

1.7.2 / 2012-11-28

1.7.0 / 2012-11-07

1.6.0 / 2012-10-02

1.5.0 / 2012-09-21

1.4.2 / 2012-09-01

1.4.1 / 2012-08-28

1.4.0 / 2012-08-22

1.3.2 / 2012-08-01

1.3.1 / 2012-08-01

1.3.0 / 2012-07-05

1.2.2 / 2012-06-28

1.2.1 / 2012-06-25

1.2.0 / 2012-06-17

1.1.0 / 2012-05-30

1.0.3 / 2012-04-30

1.0.2 / 2012-04-25

1.0.1 / 2012-04-04

1.0.0 / 2012-03-24

0.14.1 / 2012-03-06

0.14.0 / 2012-03-01

0.13.0 / 2012-02-23

0.12.1 / 2012-02-14

0.12.0 / 2012-02-02

0.10.2 / 2012-01-21

0.10.1 / 2012-01-17

0.10.0 / 2012-01-13

0.8.2 / 2012-01-05

0.8.1 / 2011-12-30

0.8.0 / 2011-12-28

0.7.1 / 2011-12-22

0.7.0 / 2011-12-18

0.6.0 / 2011-12-18

0.5.0 / 2011-12-14

0.4.0 / 2011-12-14

0.3.6 / 2011-12-09

0.3.5 / 2011-12-08

0.3.4 / 2011-12-08

0.3.3 / 2011-12-08

0.3.2 / 2011-12-05

0.3.1 / 2011-12-04

0.3.0 / 2011-12-04

0.2.0 / 2011-11-30

0.1.0 / 2011-11-29

0.0.8 / 2011-11-25

0.0.7 / 2011-11-25

0.0.6 / 2011-11-25

0.0.5 / 2011-11-24

0.0.4 / 2011-11-24

0.0.3 / 2011-11-23

0.0.2 / 2011-11-22

0.0.1 / 2011-11-22

0.0.1-alpha6 / 2011-11-19

0.0.1-alpha5 / 2011-11-17

0.0.1-alpha4 / 2011-11-15

0.0.1-alpha3 / 2011-11-15

0.0.1-alpha2 / 2011-11-08

0.0.1-alpha1 / 2011-11-08