mochajs/mocha (mocha)
### [`v8.4.0`](https://togithub.com/mochajs/mocha/blob/HEAD/CHANGELOG.md#840--2021-05-07)
[Compare Source](https://togithub.com/mochajs/mocha/compare/v8.3.2...v8.4.0)
#### :tada: Enhancements
- [#4502](https://togithub.com/mochajs/mocha/issues/4502): CLI file parsing errors now have error codes ([**@evaline-ju**](https://togithub.com/evaline-ju))
#### :bug: Fixes
- [#4614](https://togithub.com/mochajs/mocha/issues/4614): Watch: fix crash when reloading files ([**@outsideris**](https://togithub.com/outsideris))
#### :book: Documentation
- [#4630](https://togithub.com/mochajs/mocha/issues/4630): Add `options.require` to Mocha constructor for `root hook` plugins on parallel runs ([**@juergba**](https://togithub.com/juergba))
- [#4617](https://togithub.com/mochajs/mocha/issues/4617): Dynamically generating tests with `top-level await` and ESM test files ([**@juergba**](https://togithub.com/juergba))
- [#4608](https://togithub.com/mochajs/mocha/issues/4608): Update default file extensions ([**@outsideris**](https://togithub.com/outsideris))
Also thanks to [**@outsideris**](https://togithub.com/outsideris) for various improvements on our GH actions workflows.
### [`v8.3.2`](https://togithub.com/mochajs/mocha/blob/HEAD/CHANGELOG.md#832--2021-03-12)
[Compare Source](https://togithub.com/mochajs/mocha/compare/v8.3.1...v8.3.2)
#### :bug: Fixes
- [#4599](https://togithub.com/mochajs/mocha/issues/4599): Fix regression in `require` interface ([**@alexander-fenster**](https://togithub.com/alexander-fenster))
#### :book: Documentation
- [#4601](https://togithub.com/mochajs/mocha/issues/4601): Add build to GH actions run ([**@christian-bromann**](https://togithub.com/christian-bromann))
- [#4596](https://togithub.com/mochajs/mocha/issues/4596): Filter active sponsors/backers ([**@juergba**](https://togithub.com/juergba))
- [#4225](https://togithub.com/mochajs/mocha/issues/4225): Update config file examples ([**@pkuczynski**](https://togithub.com/pkuczynski))
### [`v8.3.1`](https://togithub.com/mochajs/mocha/blob/HEAD/CHANGELOG.md#831--2021-03-06)
[Compare Source](https://togithub.com/mochajs/mocha/compare/v8.3.0...v8.3.1)
#### :bug: Fixes
- [#4577](https://togithub.com/mochajs/mocha/issues/4577): Browser: fix `EvalError` caused by regenerator-runtime ([**@snoack**](https://togithub.com/snoack))
- [#4574](https://togithub.com/mochajs/mocha/issues/4574): ESM: allow `import` from mocha in parallel mode ([**@nicojs**](https://togithub.com/nicojs))
### [`v8.3.0`](https://togithub.com/mochajs/mocha/blob/HEAD/CHANGELOG.md#830--2021-02-11)
[Compare Source](https://togithub.com/mochajs/mocha/compare/v8.2.1...v8.3.0)
#### :tada: Enhancements
- [#4506](https://togithub.com/mochajs/mocha/issues/4506): Add error code for test timeout errors ([**@boneskull**](https://togithub.com/boneskull))
- [#4112](https://togithub.com/mochajs/mocha/issues/4112): Add BigInt support to stringify util function ([**@JosejeSinohui**](https://togithub.com/JosejeSinohui))
#### :bug: Fixes
- [#4557](https://togithub.com/mochajs/mocha/issues/4557): Add file location when SyntaxError happens in ESM ([**@giltayar**](https://togithub.com/giltayar))
- [#4521](https://togithub.com/mochajs/mocha/issues/4521): Fix `require` error when bundling Mocha with Webpack ([**@devhazem**](https://togithub.com/devhazem))
#### :book: Documentation
- [#4507](https://togithub.com/mochajs/mocha/issues/4507): Add support for typescript-style docstrings ([**@boneskull**](https://togithub.com/boneskull))
- [#4503](https://togithub.com/mochajs/mocha/issues/4503): Add GH Actions workflow status badge ([**@outsideris**](https://togithub.com/outsideris))
- [#4494](https://togithub.com/mochajs/mocha/issues/4494): Add example of generating tests dynamically with a closure ([**@maxwellgerber**](https://togithub.com/maxwellgerber))
#### :nut_and_bolt: Other
- [#4556](https://togithub.com/mochajs/mocha/issues/4556): Upgrade all dependencies to latest stable ([**@AviVahl**](https://togithub.com/AviVahl))
- [#4543](https://togithub.com/mochajs/mocha/issues/4543): Update dependencies yargs and yargs-parser ([**@juergba**](https://togithub.com/juergba))
Also thanks to [**@outsideris**](https://togithub.com/outsideris) and [**@HyunSangHan**](https://togithub.com/HyunSangHan) for various fixes to our website and documentation.
### [`v8.2.1`](https://togithub.com/mochajs/mocha/blob/HEAD/CHANGELOG.md#821--2020-11-02)
[Compare Source](https://togithub.com/mochajs/mocha/compare/v8.2.0...v8.2.1)
Fixed stuff.
#### :bug: Fixes
- [#4489](https://togithub.com/mochajs/mocha/issues/4489): Fix problematic handling of otherwise-unhandled `Promise` rejections and erroneous "`done()` called twice" errors ([**@boneskull**](https://togithub.com/boneskull))
- [#4496](https://togithub.com/mochajs/mocha/issues/4496): Avoid `MaxListenersExceededWarning` in watch mode ([**@boneskull**](https://togithub.com/boneskull))
Also thanks to [**@akeating**](https://togithub.com/akeating) for a documentation fix!
### [`v8.2.0`](https://togithub.com/mochajs/mocha/blob/HEAD/CHANGELOG.md#820--2020-10-16)
[Compare Source](https://togithub.com/mochajs/mocha/compare/v8.1.3...v8.2.0)
The major feature added in v8.2.0 is addition of support for [*global fixtures*](https://mochajs.org/#global-fixtures).
While Mocha has always had the ability to run setup and teardown via a hook (e.g., a `before()` at the top level of a test file) when running tests in serial, Mocha v8.0.0 added support for parallel runs. Parallel runs are *incompatible* with this strategy; e.g., a top-level `before()` would only run for the file in which it was defined.
With [global fixtures](https://mochajs.org/#global-fixtures), Mocha can now perform user-defined setup and teardown *regardless* of mode, and these fixtures are guaranteed to run *once and only once*. This holds for parallel mode, serial mode, and even "watch" mode (the teardown will run once you hit Ctrl-C, just before Mocha finally exits). Tasks such as starting and stopping servers are well-suited to global fixtures, but not sharing resources--global fixtures do *not* share context with your test files (but they do share context with each other).
Here's a short example of usage:
```js
// fixtures.js
// can be async or not
exports.mochaGlobalSetup = async function() {
this.server = await startSomeServer({port: process.env.TEST_PORT});
console.log(`server running on port ${this.server.port}`);
};
exports.mochaGlobalTeardown = async function() {
// the context (`this`) is shared, but not with the test files
await this.server.stop();
console.log(`server on port ${this.server.port} stopped`);
};
// this file can contain root hook plugins as well!
// exports.mochaHooks = { ... }
```
Fixtures are loaded with `--require`, e.g., `mocha --require fixtures.js`.
For detailed information, please see the [documentation](https://mochajs.org/#global-fixtures) and this handy-dandy [flowchart](https://mochajs.org/#test-fixture-decision-tree-wizard-thing) to help understand the differences between hooks, root hook plugins, and global fixtures (and when you should use each).
#### :tada: Enhancements
- [#4308](https://togithub.com/mochajs/mocha/issues/4308): Support run-once [global setup & teardown fixtures](https://mochajs.org/#global-fixtures) ([**@boneskull**](https://togithub.com/boneskull))
- [#4442](https://togithub.com/mochajs/mocha/issues/4442): Multi-part extensions (e.g., `test.js`) now usable with `--extension` option ([**@jordanstephens**](https://togithub.com/jordanstephens))
- [#4472](https://togithub.com/mochajs/mocha/issues/4472): Leading dots (e.g., `.js`, `.test.js`) now usable with `--extension` option ([**@boneskull**](https://togithub.com/boneskull))
- [#4434](https://togithub.com/mochajs/mocha/issues/4434): Output of `json` reporter now contains `speed` ("fast"/"medium"/"slow") property ([**@wwhurin**](https://togithub.com/wwhurin))
- [#4464](https://togithub.com/mochajs/mocha/issues/4464): Errors thrown by serializer in parallel mode now have error codes ([**@evaline-ju**](https://togithub.com/evaline-ju))
*For implementors of custom reporters:*
- [#4409](https://togithub.com/mochajs/mocha/issues/4409): Parallel mode and custom reporter improvements ([**@boneskull**](https://togithub.com/boneskull)):
- Support custom worker-process-only reporters (`Runner.prototype.workerReporter()`); reporters should subclass `ParallelBufferedReporter` in `mocha/lib/nodejs/reporters/parallel-buffered`
- Allow opt-in of object reference matching for "sufficiently advanced" custom reporters (`Runner.prototype.linkPartialObjects()`); use if strict object equality is needed when consuming `Runner` event data
- Enable detection of parallel mode (`Runner.prototype.isParallelMode()`)
#### :bug: Fixes
- [#4476](https://togithub.com/mochajs/mocha/issues/4476): Workaround for profoundly bizarre issue affecting `npm` v6.x causing some of Mocha's deps to be installed when `mocha` is present in a package's `devDependencies` and `npm install --production` is run the package's working copy ([**@boneskull**](https://togithub.com/boneskull))
- [#4465](https://togithub.com/mochajs/mocha/issues/4465): Worker processes guaranteed (as opposed to "very likely") to exit before Mocha does; fixes a problem when using `nyc` with Mocha in parallel mode ([**@boneskull**](https://togithub.com/boneskull))
- [#4419](https://togithub.com/mochajs/mocha/issues/4419): Restore `lookupFiles()` in `mocha/lib/utils`, which was broken/missing in Mocha v8.1.0; it now prints a deprecation warning (use `const {lookupFiles} = require('mocha/lib/cli')` instead) ([**@boneskull**](https://togithub.com/boneskull))
Thanks to [**@AviVahl**](https://togithub.com/AviVahl), [**@donghoon-song**](https://togithub.com/donghoon-song), [**@ValeriaVG**](https://togithub.com/ValeriaVG), [**@znarf**](https://togithub.com/znarf), [**@sujin-park**](https://togithub.com/sujin-park), and [**@majecty**](https://togithub.com/majecty) for other helpful contributions!
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
â™» Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
[ ] If you want to rebase/retry this PR, check this box
This PR has been generated by Mend Renovate. View repository job log here.
This PR contains the following updates:
8.1.3->8.4.0Release Notes
mochajs/mocha (mocha)
### [`v8.4.0`](https://togithub.com/mochajs/mocha/blob/HEAD/CHANGELOG.md#840--2021-05-07) [Compare Source](https://togithub.com/mochajs/mocha/compare/v8.3.2...v8.4.0) #### :tada: Enhancements - [#4502](https://togithub.com/mochajs/mocha/issues/4502): CLI file parsing errors now have error codes ([**@evaline-ju**](https://togithub.com/evaline-ju)) #### :bug: Fixes - [#4614](https://togithub.com/mochajs/mocha/issues/4614): Watch: fix crash when reloading files ([**@outsideris**](https://togithub.com/outsideris)) #### :book: Documentation - [#4630](https://togithub.com/mochajs/mocha/issues/4630): Add `options.require` to Mocha constructor for `root hook` plugins on parallel runs ([**@juergba**](https://togithub.com/juergba)) - [#4617](https://togithub.com/mochajs/mocha/issues/4617): Dynamically generating tests with `top-level await` and ESM test files ([**@juergba**](https://togithub.com/juergba)) - [#4608](https://togithub.com/mochajs/mocha/issues/4608): Update default file extensions ([**@outsideris**](https://togithub.com/outsideris)) Also thanks to [**@outsideris**](https://togithub.com/outsideris) for various improvements on our GH actions workflows. ### [`v8.3.2`](https://togithub.com/mochajs/mocha/blob/HEAD/CHANGELOG.md#832--2021-03-12) [Compare Source](https://togithub.com/mochajs/mocha/compare/v8.3.1...v8.3.2) #### :bug: Fixes - [#4599](https://togithub.com/mochajs/mocha/issues/4599): Fix regression in `require` interface ([**@alexander-fenster**](https://togithub.com/alexander-fenster)) #### :book: Documentation - [#4601](https://togithub.com/mochajs/mocha/issues/4601): Add build to GH actions run ([**@christian-bromann**](https://togithub.com/christian-bromann)) - [#4596](https://togithub.com/mochajs/mocha/issues/4596): Filter active sponsors/backers ([**@juergba**](https://togithub.com/juergba)) - [#4225](https://togithub.com/mochajs/mocha/issues/4225): Update config file examples ([**@pkuczynski**](https://togithub.com/pkuczynski)) ### [`v8.3.1`](https://togithub.com/mochajs/mocha/blob/HEAD/CHANGELOG.md#831--2021-03-06) [Compare Source](https://togithub.com/mochajs/mocha/compare/v8.3.0...v8.3.1) #### :bug: Fixes - [#4577](https://togithub.com/mochajs/mocha/issues/4577): Browser: fix `EvalError` caused by regenerator-runtime ([**@snoack**](https://togithub.com/snoack)) - [#4574](https://togithub.com/mochajs/mocha/issues/4574): ESM: allow `import` from mocha in parallel mode ([**@nicojs**](https://togithub.com/nicojs)) ### [`v8.3.0`](https://togithub.com/mochajs/mocha/blob/HEAD/CHANGELOG.md#830--2021-02-11) [Compare Source](https://togithub.com/mochajs/mocha/compare/v8.2.1...v8.3.0) #### :tada: Enhancements - [#4506](https://togithub.com/mochajs/mocha/issues/4506): Add error code for test timeout errors ([**@boneskull**](https://togithub.com/boneskull)) - [#4112](https://togithub.com/mochajs/mocha/issues/4112): Add BigInt support to stringify util function ([**@JosejeSinohui**](https://togithub.com/JosejeSinohui)) #### :bug: Fixes - [#4557](https://togithub.com/mochajs/mocha/issues/4557): Add file location when SyntaxError happens in ESM ([**@giltayar**](https://togithub.com/giltayar)) - [#4521](https://togithub.com/mochajs/mocha/issues/4521): Fix `require` error when bundling Mocha with Webpack ([**@devhazem**](https://togithub.com/devhazem)) #### :book: Documentation - [#4507](https://togithub.com/mochajs/mocha/issues/4507): Add support for typescript-style docstrings ([**@boneskull**](https://togithub.com/boneskull)) - [#4503](https://togithub.com/mochajs/mocha/issues/4503): Add GH Actions workflow status badge ([**@outsideris**](https://togithub.com/outsideris)) - [#4494](https://togithub.com/mochajs/mocha/issues/4494): Add example of generating tests dynamically with a closure ([**@maxwellgerber**](https://togithub.com/maxwellgerber)) #### :nut_and_bolt: Other - [#4556](https://togithub.com/mochajs/mocha/issues/4556): Upgrade all dependencies to latest stable ([**@AviVahl**](https://togithub.com/AviVahl)) - [#4543](https://togithub.com/mochajs/mocha/issues/4543): Update dependencies yargs and yargs-parser ([**@juergba**](https://togithub.com/juergba)) Also thanks to [**@outsideris**](https://togithub.com/outsideris) and [**@HyunSangHan**](https://togithub.com/HyunSangHan) for various fixes to our website and documentation. ### [`v8.2.1`](https://togithub.com/mochajs/mocha/blob/HEAD/CHANGELOG.md#821--2020-11-02) [Compare Source](https://togithub.com/mochajs/mocha/compare/v8.2.0...v8.2.1) Fixed stuff. #### :bug: Fixes - [#4489](https://togithub.com/mochajs/mocha/issues/4489): Fix problematic handling of otherwise-unhandled `Promise` rejections and erroneous "`done()` called twice" errors ([**@boneskull**](https://togithub.com/boneskull)) - [#4496](https://togithub.com/mochajs/mocha/issues/4496): Avoid `MaxListenersExceededWarning` in watch mode ([**@boneskull**](https://togithub.com/boneskull)) Also thanks to [**@akeating**](https://togithub.com/akeating) for a documentation fix! ### [`v8.2.0`](https://togithub.com/mochajs/mocha/blob/HEAD/CHANGELOG.md#820--2020-10-16) [Compare Source](https://togithub.com/mochajs/mocha/compare/v8.1.3...v8.2.0) The major feature added in v8.2.0 is addition of support for [*global fixtures*](https://mochajs.org/#global-fixtures). While Mocha has always had the ability to run setup and teardown via a hook (e.g., a `before()` at the top level of a test file) when running tests in serial, Mocha v8.0.0 added support for parallel runs. Parallel runs are *incompatible* with this strategy; e.g., a top-level `before()` would only run for the file in which it was defined. With [global fixtures](https://mochajs.org/#global-fixtures), Mocha can now perform user-defined setup and teardown *regardless* of mode, and these fixtures are guaranteed to run *once and only once*. This holds for parallel mode, serial mode, and even "watch" mode (the teardown will run once you hit Ctrl-C, just before Mocha finally exits). Tasks such as starting and stopping servers are well-suited to global fixtures, but not sharing resources--global fixtures do *not* share context with your test files (but they do share context with each other). Here's a short example of usage: ```js // fixtures.js // can be async or not exports.mochaGlobalSetup = async function() { this.server = await startSomeServer({port: process.env.TEST_PORT}); console.log(`server running on port ${this.server.port}`); }; exports.mochaGlobalTeardown = async function() { // the context (`this`) is shared, but not with the test files await this.server.stop(); console.log(`server on port ${this.server.port} stopped`); }; // this file can contain root hook plugins as well! // exports.mochaHooks = { ... } ``` Fixtures are loaded with `--require`, e.g., `mocha --require fixtures.js`. For detailed information, please see the [documentation](https://mochajs.org/#global-fixtures) and this handy-dandy [flowchart](https://mochajs.org/#test-fixture-decision-tree-wizard-thing) to help understand the differences between hooks, root hook plugins, and global fixtures (and when you should use each). #### :tada: Enhancements - [#4308](https://togithub.com/mochajs/mocha/issues/4308): Support run-once [global setup & teardown fixtures](https://mochajs.org/#global-fixtures) ([**@boneskull**](https://togithub.com/boneskull)) - [#4442](https://togithub.com/mochajs/mocha/issues/4442): Multi-part extensions (e.g., `test.js`) now usable with `--extension` option ([**@jordanstephens**](https://togithub.com/jordanstephens)) - [#4472](https://togithub.com/mochajs/mocha/issues/4472): Leading dots (e.g., `.js`, `.test.js`) now usable with `--extension` option ([**@boneskull**](https://togithub.com/boneskull)) - [#4434](https://togithub.com/mochajs/mocha/issues/4434): Output of `json` reporter now contains `speed` ("fast"/"medium"/"slow") property ([**@wwhurin**](https://togithub.com/wwhurin)) - [#4464](https://togithub.com/mochajs/mocha/issues/4464): Errors thrown by serializer in parallel mode now have error codes ([**@evaline-ju**](https://togithub.com/evaline-ju)) *For implementors of custom reporters:* - [#4409](https://togithub.com/mochajs/mocha/issues/4409): Parallel mode and custom reporter improvements ([**@boneskull**](https://togithub.com/boneskull)): - Support custom worker-process-only reporters (`Runner.prototype.workerReporter()`); reporters should subclass `ParallelBufferedReporter` in `mocha/lib/nodejs/reporters/parallel-buffered` - Allow opt-in of object reference matching for "sufficiently advanced" custom reporters (`Runner.prototype.linkPartialObjects()`); use if strict object equality is needed when consuming `Runner` event data - Enable detection of parallel mode (`Runner.prototype.isParallelMode()`) #### :bug: Fixes - [#4476](https://togithub.com/mochajs/mocha/issues/4476): Workaround for profoundly bizarre issue affecting `npm` v6.x causing some of Mocha's deps to be installed when `mocha` is present in a package's `devDependencies` and `npm install --production` is run the package's working copy ([**@boneskull**](https://togithub.com/boneskull)) - [#4465](https://togithub.com/mochajs/mocha/issues/4465): Worker processes guaranteed (as opposed to "very likely") to exit before Mocha does; fixes a problem when using `nyc` with Mocha in parallel mode ([**@boneskull**](https://togithub.com/boneskull)) - [#4419](https://togithub.com/mochajs/mocha/issues/4419): Restore `lookupFiles()` in `mocha/lib/utils`, which was broken/missing in Mocha v8.1.0; it now prints a deprecation warning (use `const {lookupFiles} = require('mocha/lib/cli')` instead) ([**@boneskull**](https://togithub.com/boneskull)) Thanks to [**@AviVahl**](https://togithub.com/AviVahl), [**@donghoon-song**](https://togithub.com/donghoon-song), [**@ValeriaVG**](https://togithub.com/ValeriaVG), [**@znarf**](https://togithub.com/znarf), [**@sujin-park**](https://togithub.com/sujin-park), and [**@majecty**](https://togithub.com/majecty) for other helpful contributions!Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
â™» Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate. View repository job log here.