ava 6.0.1 → 6.1.0

package/entrypoints/internal.d.mts

@@ -1,4 +1,4 @@
-import type {StateChangeEvent} from '../types/state-change-events.d';
+import type {StateChangeEvent} from '../types/state-change-events.d.cts';
 
 export type Event = StateChangeEvent;
 

package/entrypoints/main.d.mts

@@ -10,3 +10,11 @@ declare const test: TestFn;
 
 /** Call to declare a test, or chain to declare hooks or test modifiers */
 export default test;
+
+/**
+ * Register a function to be called when AVA has completed a test run without uncaught exceptions or unhandled rejections.
+ *
+ * Completion handlers are invoked in order of registration. Results are not awaited.
+ */
+declare const registerCompletionHandler: (handler: () => void) => void;
+export {registerCompletionHandler};

package/entrypoints/main.mjs

@@ -1 +1,2 @@
 export {default} from '../lib/worker/main.cjs';
+export {registerCompletionHandler} from '../lib/worker/completion-handlers.js';

package/lib/api.js

@@ -303,7 +303,9 @@ export default class Api extends Emittery {
 			// Allow shared workers to clean up before the run ends.
 			await Promise.all(deregisteredSharedWorkers);
 			const files = scheduler.storeFailedTestFiles(runStatus, this.options.cacheEnabled === false ? null : this._createCacheDir());
-			runStatus.emitStateChange({type: 'touched-files', files});
+			if (files) {
+				runStatus.emitStateChange({type: 'touched-files', files});
+			}
 		} catch (error) {
 			runStatus.emitStateChange({type: 'internal-error', err: serializeError(error)});
 		}

package/lib/assert.js

@@ -626,13 +626,6 @@ export class Assertions {
 				}));
 			}
 
-			if (message?.id !== undefined) {
-				throw fail(new AssertionError('Since AVA 4, snapshot IDs are no longer supported', {
-					assertion: 't.snapshot()',
-					formattedDetails: [formatWithLabel('Called with id:', message.id)],
-				}));
-			}
-
 			assertMessage(message, 't.snapshot()');
 
 			if (message === '') {

package/lib/run-status.js

@@ -38,6 +38,7 @@ export default class RunStatus extends Emittery {
 			timeouts: 0,
 			todoTests: 0,
 			uncaughtExceptions: 0,
+			unexpectedProcessExits: 0,
 			unhandledRejections: 0,
 		};
 	}
@@ -56,6 +57,7 @@ export default class RunStatus extends Emittery {
 			skippedTests: 0,
 			todoTests: 0,
 			uncaughtExceptions: 0,
+			unexpectedProcessExits: 0,
 			unhandledRejections: 0,
 			...stats,
 		});
@@ -167,6 +169,8 @@ export default class RunStatus extends Emittery {
 			}
 
 			case 'process-exit': {
+				stats.unexpectedProcessExits++;
+				fileStats.unexpectedProcessExits++;
 				event.pendingTests = this.pendingTests;
 				event.pendingTestsLogs = this.pendingTestsLogs;
 				this.pendingTests = new Map();
@@ -237,6 +241,7 @@ export default class RunStatus extends Emittery {
 			|| this.stats.sharedWorkerErrors > 0
 			|| this.stats.timeouts > 0
 			|| this.stats.uncaughtExceptions > 0
+			|| this.stats.unexpectedProcessExits > 0
 			|| this.stats.unhandledRejections > 0
 		) {
 			return 1;

package/lib/runner.js

@@ -123,14 +123,10 @@ export default class Runner extends Emittery {
 					todo: true,
 				});
 			} else {
-				if (!implementation) {
+				if (typeof implementation !== 'function') {
 					throw new TypeError('Expected an implementation. Use `test.todo()` for tests without an implementation.');
 				}
 
-				if (Array.isArray(implementation)) {
-					throw new TypeError('AVA 4 no longer supports multiple implementations.');
-				}
-
 				if (title.isSet && !title.isValid) {
 					throw new TypeError('Test & hook titles must be strings');
 				}

package/lib/test.js

@@ -99,14 +99,10 @@ class ExecutionContext extends Assertions {
 
 			const {args, implementation, title} = parseTestArgs(attemptArgs);
 
-			if (!implementation) {
+			if (typeof implementation !== 'function') {
 				throw new TypeError('Expected an implementation.');
 			}
 
-			if (Array.isArray(implementation)) {
-				throw new TypeError('AVA 4 no longer supports t.try() with multiple implementations.');
-			}
-
 			let attemptTitle;
 			if (!title.isSet || title.isEmpty) {
 				attemptTitle = `${test.title} ─ attempt ${test.attemptCount + 1}`;

package/lib/watcher.js

@@ -20,7 +20,7 @@ const END_MESSAGE = chalk.gray('Type `r` and press enter to rerun tests\nType `u
 
 export function available(projectDir) {
 	try {
-		fs.watch(projectDir, {recursive: true, signal: AbortSignal.abort()});
+		fs.watch(projectDir, {persistent: false, recursive: true, signal: AbortSignal.abort()});
 	} catch (error) {
 		if (error.code === 'ERR_FEATURE_UNAVAILABLE_ON_PLATFORM') {
 			return false;

package/lib/worker/base.js

@@ -15,6 +15,7 @@ import Runner from '../runner.js';
 import serializeError from '../serialize-error.js';
 
 import channel from './channel.cjs';
+import {runCompletionHandlers} from './completion-handlers.js';
 import lineNumberSelection from './line-numbers.js';
 import {set as setOptions} from './options.cjs';
 import {flags, refs, sharedWorkerTeardowns} from './state.cjs';
@@ -23,17 +24,22 @@ import {isRunningInThread, isRunningInChildProcess} from './utils.cjs';
 const currentlyUnhandled = setUpCurrentlyUnhandled();
 let runner;
 
-let forcingExit = false;
+let expectingExit = false;
 
 const forceExit = () => {
-	forcingExit = true;
+	expectingExit = true;
 	process.exit(1);
 };
 
+const avaIsDone = () => {
+	expectingExit = true;
+	runCompletionHandlers();
+};
+
 // Override process.exit with an undetectable replacement
 // to report when it is called from a test (which it should never be).
 const handleProcessExit = (target, thisArg, args) => {
-	if (!forcingExit) {
+	if (!expectingExit) {
 		const error = new Error('Unexpected process.exit()');
 		Error.captureStackTrace(error, handleProcessExit);
 		channel.send({type: 'process-exit', stack: error.stack});
@@ -118,7 +124,7 @@ const run = async options => {
 		nowAndTimers.setImmediate(() => {
 			const unhandled = currentlyUnhandled();
 			if (unhandled.length === 0) {
-				return;
+				return avaIsDone();
 			}
 
 			for (const rejection of unhandled) {

package/lib/worker/completion-handlers.js

@@ -0,0 +1,13 @@
+import process from 'node:process';
+
+import state from './state.cjs';
+
+export function runCompletionHandlers() {
+	for (const handler of state.completionHandlers) {
+		process.nextTick(() => handler());
+	}
+}
+
+export function registerCompletionHandler(handler) {
+	state.completionHandlers.push(handler);
+}

package/lib/worker/state.cjs

@@ -1,5 +1,6 @@
 'use strict';
 exports.flags = {loadedMain: false};
 exports.refs = {runnerChain: null};
+exports.completionHandlers = [];
 exports.sharedWorkerTeardowns = [];
 exports.waitForReady = [];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ava",
-	"version": "6.0.1",
+	"version": "6.1.0",
 	"description": "Node.js test runner that lets you develop with confidence.",
 	"license": "MIT",
 	"repository": "avajs/ava",

package/readme.md

@@ -4,7 +4,7 @@
 
 # <img src="media/header.png" title="AVA" alt="AVA logo" width="530">
 
-AVA is a test runner for Node.js with a concise API, detailed error output, embrace of new language features and htread isolation that lets you develop with confidence 🚀
+AVA is a test runner for Node.js with a concise API, detailed error output, embrace of new language features and thread isolation that lets you develop with confidence 🚀
 
 Watch this repository and follow the [Discussions](https://github.com/avajs/ava/discussions) for updates.
 
@@ -69,7 +69,7 @@ Alternatively you can install `ava` manually:
 npm install --save-dev ava
 ```
 
-*Make sure to install AVA locally. As of AVA 4 it can no longer be run globally.*
+*Make sure to install AVA locally. AVA cannot be run globally.*
 
 Don't forget to configure the `test` script in your `package.json` as per above.