Node.js test runner that lets you develop with confidence 🚀
any: true
by @gibson042 in https://github.com/avajs/ava/pull/3313
Full Changelog: https://github.com/avajs/ava/compare/v6.1.1...v6.1.2
Full Changelog: https://github.com/avajs/ava/compare/v6.1.0...v6.1.1
Implement registerCompletionHandler()
by @novemberborn in https://github.com/avajs/ava/pull/3283
AVA 6 expects test code to clean up gracefully when the tests are complete, allowing the test environment (worker thread or child process) to exit. If this does not happen, AVA will report a timeout. You can use registerCompletionHandler()
to perform any other clean up (or indeed exit the process) after AVA has completed the test execution. See the description here.
Fix potential bug with watch mode when no failed test files are written by @novemberborn in https://github.com/avajs/ava/pull/3287
Fix ava/internal
ESM type module by @codetheweb in https://github.com/avajs/ava/pull/3292
Full Changelog: https://github.com/avajs/ava/compare/v6.0.1...v6.1.0
Full Changelog: https://github.com/avajs/ava/compare/v6.0.0...v6.0.1
AVA now requires Node.js versions 18.18, 20.8 or 21. Versions 14 and 16 are no longer supported. #3251 #3216
When tests finish, worker threads or child processes are no longer exited through proces.exit()
. If your test file does not exit on its own, the test run will time out. #3260
Changes to watch mode #3218:
ava.config.*
or package.json
configuration.ignoredByWatcher
configuration has moved to the watchMode
object, under the ignoreChanges
key.fs.watch()
in recursive mode. This is supported on Linux in Node.js 20 or newer, and MacOS and Windows in Node.js 18 as well. There are caveats to keep in mind.Failed assertions now throw, meaning that any subsequent code is not executed. This also impacts the type definitions. #3246
Only native errors are now considered errors by the t.throws()
and t.throwsAsync()
assertions. Object.create(Error.prototype)
is not a native error. #3229
Changes to modules loaded through the require
configuration #3184:
@ava/typescript
if necessary.The watcher has been rewritten. It’s now built on fs.watch()
in recursive mode.
@vercel/nft
is used to perform static dependency analysis, supporting ESM and CJS imports for JavaScript & TypeScript source files. This is a huge improvement over the previous runtime tracking of CJS imports, which did not support ESM.
Integration with @ava/typescript
has been improved. The watcher can now detect a change to a TypeScript source file, then wait for the corresponding build output to change before re-running tests.
The ignoredByWatcher configuration has moved to the watchMode object, under the ignoreChanges key.
See #3218 and #3257.
Assertions now throw a TestFailure
error when they fail. This error is not exported or documented and should not be used or thrown manually. You cannot catch this error in order to recover from a failure, use t.try()
instead.
All assertions except for t.throws()
and t.throwsAsync()
now return true
when they pass. This is useful for some of the assertions in TypeScript where they can be used as a type guard.
Committing a failed t.try()
result now also throws.
See #3246.
t.throws()
and t.throwsAsync()
can now expect any errorBy default, the thrown error (or rejection reason) must be a native error. You can change the assertion to expect any kind of error by setting any: true
in the expectation object:
t.throws(() => { throw 'error' }, {any: true})
See #3245 by @adiSuper94.
require
configuration is now more powerfulIt now loads ES modules.
Local files are loaded through @ava/typescript
if necessary, so you can also write these in TypeScript.
If there is a default export function, it is invoked after loading. The function is awaited so it can do asynchronous setup before further modules are loaded. Arguments from the configuration can be passed to the function (as a [structured clone](https://developer.mozilla.org/en-US/docs/Web/API/structuredClone)).
See #3184 by @sculpt0r.
t.timeout.clear()
to restore a previous t.timeout()
. #3221Full Changelog: https://github.com/avajs/ava/compare/v5.3.1...v6.0.0
t.like()
to support Symbol keys and ignore non-enumerable properties by @gibson042 in https://github.com/avajs/ava/pull/3209
t.like()
by @novemberborn in https://github.com/avajs/ava/pull/3212
Full Changelog: https://github.com/avajs/ava/compare/v5.3.0...v5.3.1
t.like()
assertions by @tommy-mitchell in https://github.com/avajs/ava/pull/3185
expect
and assert
) and use their formatting by @Irvenae in https://github.com/avajs/ava/pull/3187
Full Changelog: https://github.com/avajs/ava/compare/v5.2.0...v5.3.0
Full Changelog: https://github.com/avajs/ava/compare/v5.1.1...v5.2.0
Full Changelog: https://github.com/avajs/ava/compare/v5.1.0...v5.1.1
Full Changelog: https://github.com/avajs/ava/compare/v5.0.1...v5.1.0