chore(deps): update dependency mocha to v10
This MR contains the following updates:
Package | Type | Update | Change |
---|---|---|---|
mocha (source) | devDependencies | major | ^3.3.0 -> ^10.0.0 |
@types/mocha (source) | devDependencies | major | ^5.2.7 -> ^10.0.0 |
Release Notes
mochajs/mocha (mocha)
v10.8.2
🩹 Fixes
- support errors with circular dependencies in object values with --parallel (#5212) (ba0fefe)
- test link in html reporter (#5224) (f054acc)
📚 Documentation
🧹 Chores
🤖 Automation
v10.8.1
🩹 Fixes
- handle case of invalid package.json with no explicit config (#5198) (f72bc17)
- Typos on mochajs.org (#5237) (d8ca270)
- use accurate test links in HTML reporter (#5228) (68803b6)
v10.8.0
🌟 Features
🩹 Fixes
📚 Documentation
- add
SECURITY.md
pointing to Tidelift (#5210) (bd7e63a) - adopt Collective Funds Guidelines 0.1 (#5199) (2b03d86)
- update README, LICENSE and fix outdated (#5197) (1203e0e)
🧹 Chores
v10.7.3
🩹 Fixes
v10.7.0
🎉 Enhancements
- #4771 feat: add option to not fail on failing test suite (@ilgonmic)
v10.6.1
🐛 Fixes
- #3825 fix: do not exit when only unref'd timer is present in test code (@boneskull)
- #5040 fix: support canonical module (@JacobLey)
v10.6.0
🎉 Enhancements
- #5150 feat: allow ^ versions for character encoding packages (@JoshuaKGoldberg)
- #5151 feat: allow ^ versions for file matching packages (@JoshuaKGoldberg)
- #5152 feat: allow ^ versions for yargs packages (@JoshuaKGoldberg)
- #5153 feat: allow ^ versions for data serialization packages (@JoshuaKGoldberg)
- #5154 feat: allow ^ versions for miscellaneous packages (@JoshuaKGoldberg)
v10.5.2
🐛 Fixes
- #5032 fix: better tracking of seen objects in error serialization (@sam-super)
v10.5.1
🐛 Fixes
v10.5.0
🎉 Enhancements
- #5015 feat: use <progress> and <svg> for browser progress indicator instead of <canvas> (@yourWaifu)
- #5143 feat: allow using any 3.x chokidar dependencies (@simhnna)
- #4835 feat: add MOCHA_OPTIONS env variable (@icholy)
🐛 Fixes
- #5107 fix: include stack in browser uncaught error reporting (@JoshuaKGoldberg)
🔩 Other
- #5110 chore: switch two-column list styles to be opt-in (@marjys)
- #5135 chore: fix some typos in comments (@StevenMia)
- #5130 chore: rename 'master' to 'main' in docs and tooling (@JoshuaKGoldberg)
v10.4.0
🎉 Enhancements
-
#4829 feat: include
.cause
stacks in the error stack traces (@voxpelli) - #4985 feat: add file path to xunit reporter (@bmish)
🐛 Fixes
🔩 Other
- #5077 chore: add mtfoley/pr-compliance-action (@JoshuaKGoldberg)
- #5060 chore: migrate ESLint config to flat config (@JoshuaKGoldberg)
- #5095 chore: revert #5069 to restore Netlify builds (@voxpelli)
- #5097 docs: add sponsored to sponsorship link rels (@JoshuaKGoldberg)
- #5093 chore: add 'status: in triage' label to issue templates and docs (@JoshuaKGoldberg)
- #5083 docs: fix CHANGELOG.md headings to start with a root-level h1 (@JoshuaKGoldberg)
- #5100 chore: fix header generation and production build crashes (@JoshuaKGoldberg)
- #5104 chore: bump ESLint ecmaVersion to 2020 (@JoshuaKGoldberg)
- #5116 fix: eleventy template builds crash with 'unexpected token at ": string, msg..."' (@LcsK)
- #4869 docs: fix documentation concerning glob expansion on UNIX (@binki)
- #5122 test: fix xunit integration test (@voxpelli)
- #5123 chore: activate dependabot for workflows (@voxpelli)
- #5125 build(deps): bump the github-actions group with 2 updates (@dependabot)
v10.3.0
This is a stable release equivalent to 10.30.0-prerelease.
v10.2.0
🎉 Enhancements
🐛 Fixes
- #4946: Browser: color of failed test icon (@kleisauke)
📖 Documentation
- #4944: Remove duplicated header (@PauloGoncalvesBH)
v10.1.0
🎉 Enhancements
-
#4896: Browser: add support for
prefers-color-scheme: dark
(@greggman)
🔩 Other
- #4912: Browser: increase contrast for replay buttons (@JoshuaKGoldberg)
-
#4905: Use standard
Promise.allSettled
instead of polyfill (@outsideris) - #4899: Upgrade official GitHub actions to latest (@ddzz)
-
#4770: Fix regex in function
clean
(@yetingli)
v10.0.0
💥 Breaking Changes
-
#4863: Rename executable
bin/mocha
tobin/mocha.js
(@juergba) -
#4865:
--ignore
option in Windows: upgrade Minimatch (@juergba)
🔩 Other
-
#4876: Add Node.js v18 to CI test matrix (@outsideris)
-
#4852: Replace deprecated
String.prototype.substr()
(@CommanderRoot)
Also thanks to @ea2305 and @SukkaW for improvements to our documentation.
v9.2.2
🐛 Fixes
🔩 Other
v9.2.1
🐛 Fixes
-
#4832: Loading of config files throws wrong error (@juergba)
-
#4799: Reporter: configurable
maxDiffSize
reporter-option (@norla)
v9.2.0
🎉 Enhancements
🔩 Other
v9.1.4
🐛 Fixes
-
#4807:
import
throws wrong error if loader is used (@giltayar)
🔩 Other
- #4777: Add Node v17 to CI test matrix (@outsideris)
v9.1.3
🐛 Fixes
🔩 Other
-
#4764: Revert deprecation of
EVENT_SUITE_ADD_*
events (@beatfactor)
v9.1.2
🐛 Fixes
-
#4746: Browser: stop using all global vars in
browser-entry.js
(@PaperStrike)
🔩 Other
- #4754: Remove dependency wide-align (@juergba)
- #4736: ESM: remove code for Node versions <10 (@juergba)
v9.1.1
🐛 Fixes
-
#4623:
XUNIT
andJSON
reporter crash inparallel
mode (@curtisman)
v9.1.0
🎉 Enhancements
-
#4716: Add new option
--fail-zero
(@juergba) -
#4691: Add new option
--node-option
(@juergba) -
#4607: Add output option to
JSON
reporter (@dorny)
v9.0.3
🐛 Fixes
-
#4702: Error rethrow from cwd-relative path while loading
.mocharc.js
(@kirill-golovan) -
#4688: Usage of custom interface in parallel mode (@juergba)
-
#4687: ESM: don't swallow
MODULE_NOT_FOUND
errors in case oftype:module
(@giltayar)
v9.0.2
🐛 Fixes
-
#4668: ESM: make
--require <dir>
work with newimport
-first loading (@giltayar)
🔩 Other
v9.0.1
🔩 Other
We added a separate browser bundle mocha-es2018.js
in javascript ES2018, as we skipped the transpilation down to ES5. This is an experimental step towards freezing Mocha's support of IE11.
-
#4653: ESM: proper version check in
hasStableEsmImplementation
(@alexander-fenster)
v9.0.0
💥 Breaking Changes
-
#4635:
import
-first loading of test files (@giltayar)
Mocha is going ESM-first! This means that it will now use ESM import(test_file)
to load the test files, instead of the CommonJS require(test_file)
. This is not a problem, as import
can also load most files that require
does. In the rare cases where this fails, it will fallback to require(...)
. This ESM-first approach is the next step in Mocha's ESM migration, and allows ESM loaders to load and transform the test file.
-
#4638: Limit the size of
actual
/expected
fordiff
generation (@juergba) -
#4389: Refactoring: Consuming log-symbols alternate to code for win32 in reporters/base (@MoonSupport)
🎉 Enhancements
🐛 Fixes
🔩 Other
-
#4646: Deprecate
Runner(suite: Suite, delay: boolean)
signature (@juergba) - #4643: Update production dependencies (@juergba)
v8.4.0
🎉 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 forroot 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.
v8.3.2
🐛 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)
v8.3.1
🐛 Fixes
-
#4577: Browser: fix
EvalError
caused by regenerator-runtime (@snoack) -
#4574: ESM: allow
import
from mocha in parallel mode (@nicojs)
v8.3.0
🎉 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.
v8.2.1
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!
v8.2.0
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 containsspeed
("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 subclassParallelBufferedReporter
inmocha/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 consumingRunner
event data - Enable detection of parallel mode (
Runner.prototype.isParallelMode()
)
- Support custom worker-process-only reporters (
🐛 Fixes
-
#4476: Workaround for profoundly bizarre issue affecting
npm
v6.x causing some of Mocha's deps to be installed whenmocha
is present in a package'sdevDependencies
andnpm 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()
inmocha/lib/utils
, which was broken/missing in Mocha v8.1.0; it now prints a deprecation warning (useconst {lookupFiles} = require('mocha/lib/cli')
instead) (@boneskull)
Thanks to @AviVahl, @donghoon-song, @ValeriaVG, @znarf, @sujin-park, and @majecty for other helpful contributions!
v8.1.3
🐛 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; userequire('mocha/lib/cli').lookupFiles
instead (@boneskull)
v8.1.2
🐛 Fixes
- #4418: Fix command-line flag incompatibility in forthcoming Node.js v14.9.0 (@boneskull)
- #4401: Fix missing global variable in browser (@irrationnelle)
🔒 Security Fixes
📖 Documentation
- Various fixes by @sujin-park, @wwhurin & @Donghoon759
v8.1.1
🐛 Fixes
- #4394: Fix regression wherein certain reporters did not correctly detect terminal width (@boneskull)
v8.1.0
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
v8.0.1
The obligatory patch after a major.
🐛 Fixes
-
#4328: Fix
--parallel
when combined with--watch
(@boneskull)
v8.0.0
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: Replacemocha.opts
with a configuration file. -
#4260: Remove
enableTimeout()
(this.enableTimeout()
) from the context object (@craigtaub)✨ WORKAROUND: Replace usage ofthis.enableTimeout(false)
in your tests withthis.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)
🔩 Other
- #4200: Drop mkdirp and replace it with fs.mkdirSync (@HyunSangHan)
🐛 Fixes
(All bug fixes in Mocha v8.0.0 are also breaking changes, and are listed above)
v7.2.0
🎉 Enhancements
- #4234: Add ability to run tests in a mocha instance multiple times (@nicojs)
- #4219: Exposing filename in JSON, doc, and json-stream reporters (@Daniel0113)
- #4244: Add Root Hook Plugins (@boneskull)
🐛 Fixes
- #4258: Fix missing dot in name of configuration file (@sonicdoe)
- #4194: Check if module.paths really exists (@ematipico)
-
#4256:
--forbid-only
does not recognizeit.only
whenbefore
crashes (@arvidOtt) - #4152: Bug with multiple async done() calls (@boneskull)
- #4275: Improper warnings for invalid reporters (@boneskull)
- #4288: Broken hook.spec.js test for IE11 (@boneskull)
📖 Documentation
- #4081: Insufficient white space for API docs in view on mobile (@HyunSangHan)
- #4255: Update mocha-docdash for UI fixes on API docs (@craigtaub)
- #4235: Enable emoji on website; enable normal ul elements (@boneskull)
- #4272: Fetch sponsors at build time, show ALL non-skeevy sponsors (@boneskull)
🔩 Other
- #4249: Refactoring improving encapsulation (@arvidOtt)
- #4242: CI add job names, add Node.js v14 to matrix (@boneskull)
- #4237: Refactor validatePlugins to throw coded errors (@boneskull)
- #4236: Better debug output (@boneskull)
v7.1.2
🔩 Other
- #4251: Prevent karma-mocha from stalling (@juergba)
- #4222: Update dependency mkdirp to v0.5.5 (@outsideris)
📖 Documentation
- #4208: Add Wallaby logo to site (@boneskull)
v7.1.1
🔒 Security Fixes
🐛 Fixes
📖 Documentation
- #4190: Show Netlify badge on footer (@outsideris)
v7.1.0
🎉 Enhancements
#4038: Add Node.js native ESM support (@giltayar)
Mocha supports writing your test files as ES modules:
- Node.js only v12.11.0 and above
- Node.js below v13.2.0, you must set
--experimental-modules
option - current limitations: please check our documentation
- for programmatic usage: see API: loadFilesAsync()
Note: Node.JS native ECMAScript Modules implementation has status: Stability: 1 - Experimental
🐛 Fixes
- #4181: Programmatic API cannot access retried test objects (@juergba)
-
#4174: Browser: fix
allowUncaught
option (@juergba)
📖 Documentation
-
#4058: Manage author list in AUTHORS instead of
package.json
(@outsideris)
🔩 Other
- #4138: Upgrade ESLint v6.8 (@kaicataldo)
v7.0.1
🐛 Fixes
- #4165: Fix exception when skipping tests programmatically (@juergba)
-
#4153: Restore backwards compatibility for
reporterOptions
(@holm) - #4150: Fix recovery of an open test upon uncaught exception (@juergba)
- #4147: Fix regression of leaking uncaught exception handler (@juergba)
📖 Documentation
- #4146: Update copyright & trademark notices per OJSF (@boneskull)
- #4140: Fix broken links (@KyoungWan)
🔩 Other
v7.0.0
💥 Breaking Changes
- #3885: Drop Node.js v6.x support (@mojosoeun)
-
#3890: Remove Node.js debug-related flags
--debug
/--debug-brk
and deprecatedebug
argument (@juergba) -
#3962: Changes to command-line options (@ParkSB):
-
--list-interfaces
replaces--interfaces
-
--list-reporters
replaces--reporters
-
- Hook pattern of
this.skip()
(@juergba): -
#3967: Remove deprecated
getOptions()
andlib/cli/options.js
(@juergba) -
#4083: Uncaught exception in
pending
test: don't swallow, but retrospectively fail the test for correct exit code (@juergba) -
#4004: Align
Mocha
constructor's option names with command-line options (@juergba)
🎉 Enhancements
-
#3980: Refactor and improve
--watch
mode with chokidar (@geigerzaehler):- adds command-line options
--watch-files
and--watch-ignore
- removes
--watch-extensions
- adds command-line options
- #3979: Type "rs\n" to restart tests (@broofa)
📠 Deprecations
These are soft-deprecated, and will emit a warning upon use. Support will be removed in (likely) the next major version of Mocha:
🐛 Fixes
-
#4125: Fix timeout handling with
--inspect-brk
/--inspect
(@juergba) -
#4070:
Mocha
constructor: improve browser setup (@juergba) - #4068: XUnit reporter should handle exceptions during diff generation (@rgroothuijsen)
-
#4030: Fix
--allow-uncaught
withthis.skip()
(@juergba)
🔍 Coverage
📖 Documentation
- #4129: Fix broken links (@SaeromB)
- #4127: Add reporter alias names to docs (@khg0712)
-
#4101: Clarify invalid usage of
done()
(@jgehrcke) -
#4092: Replace
:coffee:
with emoji☕ ️ (@pzrq) - #4088: Initial draft of project charter (@boneskull)
-
#4066: Change
sh
tobash
for code block in docs/index.md (@HyunSangHan) - #4045: Update README.md concerning GraphicsMagick installation (@HyunSangHan)
- #3988: Fix sponsors background color for readability (@outsideris)
🔩 Other
- #4118: Update node-environment-flags to 1.0.6 (@kylef)
- #4097: Add GH Funding Metadata (@SheetJSDev)
-
#4089: Add funding information to
package.json
(@Munter) - #4077: Improve integration tests (@soobing)
v6.2.3
🔒 Security Fixes
v6.2.2
🐛 Fixes
-
#4025: Fix duplicate
EVENT_RUN_END
events upon uncaught exception (@juergba) -
#4051: Fix "unhide" function in
html
reporter (browser) (@pec9399) - #4063: Fix use of esm in Node.js v8.x (@boneskull)
- #4033: Fix output when multiple async exceptions are thrown (@juergba)
📖 Documentation
- #4046: Site accessibility fixes (@Mia-jeong)
- #4026: Update docs for custom reporters in browser (@Lindsay-Needs-Sleep)
- #3971: Adopt new OpenJS Foundation Code of Conduct (@craigtaub)
v6.2.1
🐛 Fixes
- #3955: tty.getWindowSize is not a function inside a "worker_threads" worker (@1999)
- #3970: remove extraGlobals() (@juergba)
- #3984: Update yargs-unparser to v1.6.0 (@juergba)
- #3983: Package 'esm': spawn child-process for correct loading (@juergba)
- #3986: Update yargs to v13.3.0 and yargs-parser to v13.1.1 (@juergba)
📖 Documentation
- #3886: fix styles on mochajs.org (@outsideris)
- #3966: Remove jsdoc index.html placeholder from eleventy file structure and fix broken link in jsdoc tutorial (@Munter)
- #3765: Add Matomo to website (@MarioDiaz98)
- #3947: Clarify effect of .skip() (@oliversalzburg)
v6.2.0
🎉 Enhancements
- #3827: Do not fork child-process if no Node flags are present (@boneskull)
- #3725: Base reporter store ref to console.log, see mocha/wiki (@craigtaub)
🐛 Fixes
-
#3942: Fix "No test files found" Error when file is passed via
--file
(@gabegorelick) -
#3914: Modify Mocha constructor to accept options
global
orglobals
(@pascalpp) -
#3894: Fix parsing of config files with
_mocha
binary (@juergba) - #3834: Fix CLI parsing with default values (@boneskull, @juergba)
-
#3831: Fix
--timeout
/--slow
string values and duplicate arguments (@boneskull, @juergba)
📖 Documentation
- #3906: Document option to define custom report name for XUnit reporter (@pkuczynski)
- #3889: Adds doc links for mocha-examples (@craigtaub)
- #3887: Fix broken links (@toyjhlee)
- #3841: Fix anchors to configuration section (@trescube)
🔍 Coverage
-
#3915, #3929: Increase tests coverage for
--watch
options (@geigerzaehler)
🔩 Other
-
#3953: Collect test files later, prepares improvements to the
--watch
mode behavior (@geigerzaehler) - #3939: Upgrade for npm audit (@boneskull)
-
#3930: Extract
runWatch
into separate module (@geigerzaehler) -
#3922: Add
mocha.min.js
file to stacktrace filter (@brian-lagerman) - #3919: Update CI config files to use Node-12.x (@plroebuck)
- #3892: Rework reporter tests (@plroebuck)
-
#3872: Rename
--exclude
to--ignore
and create alias (@boneskull) - #3963: Hide stacktrace when cli args are missing (@outsideris)
- #3956: Do not redeclare variable in docs array example (@DanielRuf)
-
#3957: Remove duplicate line-height property in
mocha.css
(@DanielRuf) - #3960: Don't re-initialize grep option on watch re-run (@geigerzaehler)
v6.1.4
🔒 Security Fixes
- #3877: Upgrade js-yaml, addressing code injection vulnerability (@bjornstar)
v6.1.3
🐛 Fixes
-
#3863: Fix
yargs
-related global scope pollution (@inukshuk) -
#3869: Fix failure when installed w/
pnpm
(@boneskull)
v6.1.2
🐛 Fixes
- #3867: Re-publish v6.1.1 from POSIX OS to avoid dropped executable flags (@boneskull)
v6.1.1
🐛 Fixes
- #3866: Fix Windows End-of-Line publishing issue (@juergba & @cspotcode)
v6.1.0
🔒 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:
🐛 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 copyingroot
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)
v6.0.2
🐛 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 certainnode
flags (@boneskull)
v6.0.1
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 adescribe
callback is no longer considered deprecated (@boneskull)
📖 Documentation
-
#3738: Upgrade to
@mocha/docdash@2
(@tendonstrength) - #3751: Use preferred names for example config files (@Szauka)
v6.0.0
🎉 Enhancements
-
#3726: Add ability to unload files from
require
cache (@plroebuck)
🐛 Fixes
- #3737: Fix falsy values from options globals (@plroebuck)
-
#3707: Fix encapsulation issues for
Suite#_onlyTests
andSuite#_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
andfiles
(@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)
📖 Documentation
🔩 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)
v5.2.0
🎉 Enhancements
-
#3375: Add support for comments in
mocha.opts
(@plroebuck)
🐛 Fixes
-
#3346: Exit correctly from
before
hooks when using--bail
(@outsideris)
📖 Documentation
🔩 Other
-
#3330: Use
Buffer.from()
(@harrysarson) - #3295: Remove redundant folder (@DavNej)
- #3356: Refactoring (@plroebuck)
v5.1.1
🐛 Fixes
-
#3325: Revert change which broke
--watch
(@boneskull)
v5.1.0
🎉 Enhancements
-
#3210: Add
--exclude
option (@metalex9)
🐛 Fixes
- #3318: Fix failures in circular objects in JSON reporter (@jeversmann, @boneskull)
📖 Documentation
- #3323: Publish actual API documentation! (@dfberry, @Munter)
- #3299: Improve docs around exclusive tests (@nicgirault)
🔩 Other
- #3302, #3308, #3310, #3315, #3316: Build matrix improvements (more info) (@outsideris, @boneskull)
- #3272: Refactor reporter tests (@jMuzsik)
v5.0.5
Welcome @outsideris to the team!
🐛 Fixes
-
#3096: Fix
--bail
failing to bail within hooks (@outsideris) -
#3184: Don't skip too many suites (using
describe.skip()
) (@outsideris)
📖 Documentation
- #3133: Improve docs regarding "pending" behavior (@ematicipo)
-
#3276, #3274: Fix broken stuff in
CHANGELOG.md
(@tagoro9, @honzajavorek)
🔩 Other
- #3208: Improve test coverage for AMD users (@outsideris)
- #3267: Remove vestiges of PhantomJS from CI (@anishkny)
- #2952: Fix a debug message (@boneskull)
v5.0.4
🐛 Fixes
- #3265: Fixes regression in "watch" functionality introduced in v5.0.2 (@outsideris)
v5.0.3
This patch features a fix to address a potential "low severity" ReDoS vulnerability in the diff package (a dependency of Mocha).
🔒 Security Fixes
-
#3266: Bump
diff
to v3.5.0 (@anishkny)
🔩 Other
-
#3011: Expose
generateDiff()
inBase
reporter (@harrysarson)
v5.0.2
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!
🐛 Fixes
-
#3226: Do not swallow errors that are thrown asynchronously from passing tests (@boneskull). Example:
```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 theend
event twice; you may need to change your reporter to userunner.once('end')
intead ofrunner.on('end')
. -
#3093: Fix stack trace reformatting problem (@outsideris)
🔩 Other
-
#3248: Update
browser-stdout
to v1.3.1 (@honzajavorek)
v5.0.1
...your garden-variety patch release.
Special thanks to Wallaby.js for their continued support!
🐛 Fixes
-
#1838:
--delay
now works with.only()
(@silviom) - #3119: Plug memory leak present in v8 (@boneskull)
📖 Documentation
-
#3132, #3098: Update
--glob
docs (@outsideris) - #3212: Update Wallaby.js-related docs (@ArtemGovorov)
- #3205: Remove outdated cruft (@boneskull)
🔩 Other
- #3224: Add proper Wallaby.js config (@ArtemGovorov)
- #3230: Update copyright year (@josephlin55555)
v5.0.0
Mocha starts off 2018 right by again dropping support for unmaintained rubbish.
Welcome @vkarpov15 to the team!
💥 Breaking Changes
- #3148: Drop support for IE9 and IE10 (@Bamieh) Practically speaking, only code which consumes (through bundling or otherwise) the userland buffer module should be affected. However, Mocha will no longer test against these browsers, nor apply fixes for them.
🎉 Enhancements
-
#3181: Add useful new
--file
command line argument (documentation) (@hswolff)
🐛 Fixes
- #3187: Fix inaccurate test duration reporting (@FND)
- #3202: Fix bad markup in HTML reporter (@DanielRuf)
😎 Developer Experience
📖 Documentation
-
#3137: Add missing
--no-timeouts
docs (@dfberry) -
#3134: Improve
done()
callback docs (@maraisr) - #3135: Fix cross-references (@vkarpov15)
- #3163: Fix tpyos (@tbroadley)
-
#3177: Tweak
README.md
organization (@xxczaki) - Misc updates (@boneskull)
🔩 Other
- #3118: Move TextMate Integration to its own repo (@Bamieh)
- #3185: Add Node.js v9 to build matrix; remove v7 (@xxczaki)
- #3172: Markdown linting (@boneskull)
- Test & Netlify updates (@Munter, @boneskull)
v4.1.0
4.1.0 / 2017-12-28
This is mainly a "housekeeping" release.
Welcome @Bamieh and @xxczaki to the team!
:bug:: Fixes
-
#2661:
progress
reporter now accepts reporter options (@canoztokmak) -
#3142:
xit
inbdd
interface now properly returns itsTest
object (@Bamieh) - #3075: Diffs now computed eagerly to avoid misinformation when reported (@abrady0)
-
#2745:
--help
will now help you even if you have amocha.opts
(@Zarel)
🎉 Enhancements
-
#2514: The
--no-diff
flag will completely disable diff output (@CapacitorSet) - #3058: All "setters" in Mocha's API are now also "getters" if called without arguments (@makepanic)
📖 Documentation
- #3170: Optimization and site speed improvements (@Munter)
-
#2987: Moved the old site repo into the main repo under
docs/
(@boneskull) - #2896: Add maintainer guide (@boneskull)
- Various fixes and updates (@xxczaki, @maty21, @leedm777)
🔩 Other
- Test improvements and fixes (@eugenet8k, @ngeor, @38elements, @Gerhut, @ScottFreeCode, @boneskull)
- Refactoring and cruft excision (@38elements, @Bamieh, @finnigantime, @boneskull)
v4.0.1
4.0.1 / 2017-10-05
🐛 Fixes
- #3051: Upgrade Growl to v1.10.3 to fix its peer dep problems (@dpogue)
v4.0.0
4.0.0 / 2017-10-02
You might want to read this before filing a new bug!
💥 Breaking Changes
For more info, please read this article.
Compatibility
-
#3016: Drop support for unmaintained versions of Node.js (@boneskull):
- 0.10.x
- 0.11.x
- 0.12.x
- iojs (any)
- 5.x.x
-
#2979: Drop support for non-ES5-compliant browsers (@boneskull):
- IE7
- IE8
- PhantomJS 1.x
- #2615: Drop Bower support; old versions (3.x, etc.) will remain available (@ScottFreeCode, @boneskull)
Default Behavior
-
#2879: By default, Mocha will no longer force the process to exit once all tests complete. This means any test code (or code under test) which would normally prevent
node
from exiting will do so when run in Mocha. Supply the--exit
flag to revert to pre-v4.0.0 behavior (@ScottFreeCode, @boneskull)
Reporter Output
-
#2095: Remove
stdout:
prefix from browser reporter logs (@skeggse) - #2295: Add separator in "unified diff" output (@olsonpm)
-
#2686: Print failure message when
--forbid-pending
or--forbid-only
is specified (@ScottFreeCode) - #2814: Indent contexts for better readability when reporting failures (@charlierudolph)
👎 Deprecations
-
#2493: The
--compilers
command-line option is now soft-deprecated and will emit a warning onSTDERR
. Read this for more info and workarounds (@ScottFreeCode, @boneskull)
🎉 Enhancements
📖 Documentation
🔩 Other
- #2890: Speed up build by (re-)consolidating SauceLabs tests (@boneskull)
Configuration
-
If you want to rebase/retry this MR, check this box
This MR has been generated by Renovate Bot.