Upgrade mocha: 7.2.0 → 8.4.0 (major) #85

depfu · 2021-05-08T09:41:05Z

Here is everything you need to know about this upgrade. Please take a good look at what changed and the test results before merging this pull request.

What changed?

✳️ mocha (7.2.0 → 8.4.0) · Repo · Changelog

Release Notes

8.4.0

8.4.0 / 2021-05-07

🎉 Enhancements

#4502: CLI file parsing errors now have error codes (@evaline-ju)

🐛 Fixes

#4614: Watch: fix crash when reloading files (@outsideris)

📖 Documentation

#4630: Add options.require to Mocha constructor for root hook plugins on parallel runs (@juergba)

#4617: Dynamically generating tests with top-level await and ESM test files (@juergba)

#4608: Update default file extensions (@outsideris)

Also thanks to @outsideris for various improvements on our GH actions workflows.

8.3.2

8.3.2 / 2021-03-12

🐛 Fixes

#4599: Fix regression in require interface (@alexander-fenster)

📖 Documentation

#4601: Add build to GH actions run (@christian-bromann)

#4596: Filter active sponsors/backers (@juergba)

#4225: Update config file examples (@pkuczynski)

8.3.1

8.3.1 / 2021-03-06

🐛 Fixes

#4577: Browser: fix EvalError caused by regenerator-runtime (@snoack)

#4574: ESM: allow import from mocha in parallel mode (@nicojs)

8.3.0

8.3.0 / 2021-02-11

🎉 Enhancements

#4506: Add error code for test timeout errors (@boneskull)

#4112: Add BigInt support to stringify util function (@JosejeSinohui)

🐛 Fixes

#4557: Add file location when SyntaxError happens in ESM (@giltayar)

#4521: Fix require error when bundling Mocha with Webpack (@devhazem)

📖 Documentation

#4507: Add support for typescript-style docstrings (@boneskull)

#4503: Add GH Actions workflow status badge (@outsideris)

#4494: Add example of generating tests dynamically with a closure (@maxwellgerber)

🔩 Other

#4556: Upgrade all dependencies to latest stable (@AviVahl)

#4543: Update dependencies yargs and yargs-parser (@juergba)

Also thanks to @outsideris and @HyunSangHan for various fixes to our website and documentation.

8.2.1

8.2.1 / 2020-11-02

Fixed stuff.

🐛 Fixes

#4489: Fix problematic handling of otherwise-unhandled Promise rejections and erroneous "done() called twice" errors (@boneskull)

#4496: Avoid MaxListenersExceededWarning in watch mode (@boneskull)

Also thanks to @akeating for a documentation fix!

8.2.0

8.2.0 / 2020-10-16

The major feature added in v8.2.0 is addition of support for 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, 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:
// 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 and this handy-dandy flowchart to help understand the differences between hooks, root hook plugins, and global fixtures (and when you should use each).

🎉 Enhancements

#4308: Support run-once global setup & teardown fixtures (@boneskull)

#4442: Multi-part extensions (e.g., test.js) now usable with --extension option (@jordanstephens)

#4472: Leading dots (e.g., .js, .test.js) now usable with --extension option (@boneskull)

#4434: Output of json reporter now contains speed ("fast"/"medium"/"slow") property (@wwhurin)

#4464: Errors thrown by serializer in parallel mode now have error codes (@evaline-ju)

For implementors of custom reporters:

#4409: Parallel mode and custom reporter improvements (@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())

🐛 Fixes

#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)

#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)

#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)

Thanks to @AviVahl, @donghoon-song, @ValeriaVG, @znarf, @sujin-park, and @majecty for other helpful contributions!

8.1.3

8.1.3 / 2020-08-28

🐛 Fixes

#4425: Restore Mocha.utils.lookupFiles() and Webpack compatibility (both broken since v8.1.0); Mocha.utils.lookupFiles() is now deprecated and will be removed in the next major revision of Mocha; use require('mocha/lib/cli').lookupFiles instead (@boneskull)

8.1.2

8.1.2 / 2020-08-25

🐛 Fixes

#4418: Fix command-line flag incompatibility in forthcoming Node.js v14.9.0 (@boneskull)

#4401: Fix missing global variable in browser (@irrationelle)

🔒 Security Fixes

#4396: Update many dependencies (@GChuf)

📖 Documentation

Various fixes by @sujin-park, @wwhurin & @Donghoon759

8.1.1

8.1.1 / 2020-08-04

🐛 Fixes

#4394: Fix regression wherein certain reporters did not correctly detect terminal width (@boneskull)

8.1.0

8.1.0 / 2020-07-30

In this release, Mocha now builds its browser bundle with Rollup and Babel, which will provide the project's codebase more flexibility and consistency.

While we've been diligent about backwards compatibility, it's possible consumers of the browser bundle will encounter differences (other than an increase in the bundle size). If you do encounter an issue with the build, please report it here.

This release does not drop support for IE11.

Other community contributions came from @Devjeel, @Harsha509 and @sharath2106. Thank you to everyone who contributed to this release!

Do you read Korean? See this guide to running parallel tests in Mocha, translated by our maintainer, @outsideris.

🎉 Enhancements

#4287: Use background colors with inline diffs for better visual distinction (@michael-brade)

🐛 Fixes

#4328: Fix "watch" mode when Mocha run in parallel (@boneskull)

#4382: Fix root hook execution in "watch" mode (@indieisaconcept)

#4383: Consistent auto-generated hook titles (@cspotcode)

#4359: Better errors when running mocha init (@boneskull)

#4341: Fix weirdness when using delay option in browser (@craigtaub)

🔒 Security Fixes

#4378, #4333: Update javascript-serialize (@martinoppitz, @wnghdcjfe)

#4354: Update yargs-unparser (@martinoppitz)

📖 Documentation & Website

#4173: Document how to use --enable-source-maps with Mocha (@bcoe)

#4343: Clean up some API docs (@craigtaub)

#4318: Sponsor images are now self-hosted (@Munter)

🔩 Other

#4293: Use Rollup and Babel in build pipeline; add source map to published files (@Munter)

8.0.1

8.0.1 / 2020-06-10

The obligatory patch after a major.

🐛 Fixes

#4328: Fix --parallel when combined with --watch (@boneskull)

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!

💥 Breaking Changes

#4164: Mocha v8.0.0 now requires Node.js v10.0.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

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

❗ 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)

📖 Documentation

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

🐛 Fixes

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

Does any of this look wrong? Please let us know.

Commits

See the full diff on Github. The new version differs by more commits than we can show here.

Depfu will automatically keep this PR conflict-free, as long as you don't add any commits to this branch yourself. You can also trigger a rebase manually by commenting with @depfu rebase.

All Depfu comment commands

@depfu rebase
Rebases against your default branch and redoes this update

@depfu recreate
Recreates this PR, overwriting any edits that you've made to it

@depfu merge
Merges this PR once your tests are passing and conflicts are resolved

@depfu close
Closes this PR and deletes the branch

@depfu reopen
Restores the branch and reopens this PR (if it's closed)

@depfu pause
Ignores all future updates for this dependency and closes this PR

@depfu pause [minor|major]
Ignores all future minor/major updates for this dependency and closes this PR

@depfu resume
Future versions of this dependency will create PRs again (leaves this PR as is)

Update mocha to version 8.4.0

3ecc6db

depfu bot added the depfu label May 8, 2021

depfu bot mentioned this pull request May 8, 2021

Upgrade mocha: 7.2.0 → 8.3.2 (major) #82

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Upgrade mocha: 7.2.0 → 8.4.0 (major) #85

Upgrade mocha: 7.2.0 → 8.4.0 (major) #85

depfu bot commented May 8, 2021

Upgrade mocha: 7.2.0 → 8.4.0 (major) #85

Are you sure you want to change the base?

Upgrade mocha: 7.2.0 → 8.4.0 (major) #85

Conversation

depfu bot commented May 8, 2021

What changed?

✳️ mocha (7.2.0 → 8.4.0) · Repo · Changelog

8.4.0 / 2021-05-07

🎉 Enhancements

🐛 Fixes

📖 Documentation

8.3.2 / 2021-03-12

🐛 Fixes

📖 Documentation

8.3.1 / 2021-03-06

🐛 Fixes

8.3.0 / 2021-02-11

🎉 Enhancements

🐛 Fixes

📖 Documentation

🔩 Other

8.2.1 / 2020-11-02

🐛 Fixes

8.2.0 / 2020-10-16

🎉 Enhancements

🐛 Fixes

8.1.3 / 2020-08-28

🐛 Fixes

8.1.2 / 2020-08-25

🐛 Fixes

🔒 Security Fixes

📖 Documentation

8.1.1 / 2020-08-04

🐛 Fixes

8.1.0 / 2020-07-30

🎉 Enhancements

🐛 Fixes

🔒 Security Fixes

📖 Documentation & Website

🔩 Other

8.0.1 / 2020-06-10

🐛 Fixes

8.0.0 / 2020-06-10

💥 Breaking Changes

🎉 Enhancements

📖 Documentation

🐛 Fixes