v6.4.1

Compare Source

What's Changed

• Keep test worker alive until explicitly freed by @​matz3 in #​3391

New Contributors

• @​matz3 made their first contribution in #​3391

Full Changelog: avajs/ava@v6.4.0...v6.4.1

v6.4.0

Compare Source

What's Changed

• AVA is now tested with Node.js 24 (but no longer v23) #​3379
• We're now publishing to npm with provenance attestations #​3385

Interactive watch mode filters

@​mmulet did fantastic work to spearhead interactive watch mode filters. You can now filter test files by glob patterns, and tests by matching their titles. It's just like you already could from the CLI itself, but now without exiting AVA 🚀 #​3372

As part of this work we've removed the "sticky" .only() behavior #​3381

Examples

We've been remiss in merging #​3335 which updates the examples to use AVA 6. It's done now, examples are up to date and it's all due to @​tommy-mitchell 👏

New Contributors

• @​mmulet made their first contribution in #​3372
• @​kebbell made their first contribution in #​3348

Full Changelog: avajs/ava@v6.3.0...v6.4.0

v6.3.0

Compare Source

What's Changed

• Update dependencies, addressing npm audit warnings by @​novemberborn in #​3377
• Do not count writes to stdout/stderr as non-idling activity for timeouts by @​mdouglass in #​3374

New Contributors

• @​mdouglass made their first contribution in #​3374

Full Changelog: avajs/ava@v6.2.0...v6.3.0

v6.2.0

Compare Source

What's Changed

• Add filterNodeArgumentsForWorkerThreads option in #​3336
• Add Node.js 23 to supported engines (and test matrix) in #​3346

New Contributors

• @​thoughtsunificator made their first contribution in #​3345

Full Changelog: avajs/ava@v6.1.3...v6.2.0

v6.1.3

Compare Source

What's Changed

• Include Node.js 22 in supported engines and test matrix by @​lenovouser in #​3328
• Add VS Code debugging instructions for Yarn PnP projects by @​bitjson in #​3317
• Document serial configuration option by @​turadg in #​3321

New Contributors

• @​bitjson made their first contribution in #​3317
• @​turadg made their first contribution in #​3321
• @​lenovouser made their first contribution in #​3328

Full Changelog: avajs/ava@v6.1.2...v6.1.3

v6.1.2

Compare Source

What's Changed

• Fix throws assertions rejecting falsy values when any: true by @​gibson042 in #​3313

Full Changelog: avajs/ava@v6.1.1...v6.1.2

v6.1.1

Compare Source

What's Changed

• Fix 'previous failures' in watch mode always incrementing by @​novemberborn in #​3297

Full Changelog: avajs/ava@v6.1.0...v6.1.1

v6.1.0

Compare Source

What's Changed

• Implement registerCompletionHandler() by @​novemberborn in #​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 #​3287

• Fix ava/internal ESM type module by @​codetheweb in #​3292

Full Changelog: avajs/ava@v6.0.1...v6.1.0

v6.0.1

Compare Source

What's Changed

• Ensure watch mode works outside of its integration tests by @​novemberborn in #​3273

Full Changelog: avajs/ava@v6.0.0...v6.0.1

v6.0.0

Compare Source

Breaking Changes

• 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:

  • Watch mode can no longer be started via the ava.config.* or package.json configuration.
  • The ignoredByWatcher configuration has moved to the watchMode object, under the ignoreChanges key.
  • Watch mode now uses the built-in 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:

  • If such modules export a default function, this function is now invoked.
  • Local files are loaded through @ava/typescript if necessary.

Improvements

Rewritten watcher

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.

Failed assertions now throw

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 error

By 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.

The require configuration is now more powerful

It 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.

Other changes worth noting

• Internal events can now be observed (experimentally). See #​3247 by @​codetheweb. It’s experimental and undocumented.
• You can now use t.timeout.clear() to restore a previous t.timeout(). #​3221
• Code coverage is flushed to disk at opportune moments. #​3220

New Contributors

• @​sculpt0r made their first contribution in #​3184
• @​ZachHaber made their first contribution in #​3233
• @​adiSuper94 made their first contribution in #​3245
• @​bricker made their first contribution in #​3250

Full Changelog: avajs/ava@v5.3.1...v6.0.0