ava 3.12.0 → 3.15.0

package/lib/worker/subprocess.js

@@ -32,6 +32,8 @@ ipc.options.then(async options => {
 	const dependencyTracking = require('./dependency-tracker');
 	const lineNumberSelection = require('./line-numbers');
 
+	const sharedWorkerTeardowns = [];
+
 	async function exit(code) {
 		if (!process.exitCode) {
 			process.exitCode = code;
@@ -89,7 +91,7 @@ ipc.options.then(async options => {
 		exit(1);
 	});
 
-	runner.on('finish', () => {
+	runner.on('finish', async () => {
 		try {
 			const {cannotSave, touchedFiles} = runner.saveSnapshotState();
 			if (cannotSave) {
@@ -103,6 +105,14 @@ ipc.options.then(async options => {
 			return;
 		}
 
+		try {
+			await Promise.all(sharedWorkerTeardowns.map(fn => fn()));
+		} catch (error) {
+			ipc.send({type: 'uncaught-exception', err: serializeError('Shared worker teardown error', false, error, runner.file)});
+			exit(1);
+			return;
+		}
+
 		nowAndTimers.setImmediate(() => {
 			currentlyUnhandled()
 				.filter(rejection => !attributedRejections.has(rejection.promise))
@@ -129,6 +139,19 @@ ipc.options.then(async options => {
 		return runner;
 	};
 
+	exports.registerSharedWorker = (filename, initialData, teardown) => {
+		const {channel, forceUnref, ready} = ipc.registerSharedWorker(filename, initialData);
+		runner.waitForReady.push(ready);
+		sharedWorkerTeardowns.push(async () => {
+			try {
+				await teardown();
+			} finally {
+				forceUnref();
+			}
+		});
+		return channel;
+	};
+
 	// Store value to prevent required modules from modifying it.
 	const testPath = options.file;
 

package/package.json

@@ -1,22 +1,24 @@
 {
 	"name": "ava",
-	"version": "3.12.0",
+	"version": "3.15.0",
 	"description": "Node.js test runner that lets you develop with confidence.",
 	"license": "MIT",
 	"repository": "avajs/ava",
 	"homepage": "https://avajs.dev",
 	"bin": "cli.js",
 	"engines": {
-		"node": ">=10.18.0 <11 || >=12.14.0 <12.17.0 || >=12.17.0 <13 || >=14.0.0"
+		"node": ">=10.18.0 <11 || >=12.14.0 <12.17.0 || >=12.17.0 <13 || >=14.0.0 <15 || >=15"
 	},
 	"scripts": {
-		"test": "xo && tsd && c8 --report=none tap && c8 --report=none --no-clean test-ava && c8 report"
+		"cover": "c8 --report=none tap && c8 --report=none --no-clean test-ava && c8 report",
+		"test": "xo && tsd && npm run -s cover"
 	},
 	"files": [
 		"lib",
 		"*.js",
 		"!*.config.js",
-		"index.d.ts"
+		"index.d.ts",
+		"*.d.ts"
 	],
 	"keywords": [
 		"🦄",
@@ -56,14 +58,14 @@
 	],
 	"dependencies": {
 		"@concordance/react": "^2.0.0",
-		"acorn": "^8.0.1",
+		"acorn": "^8.0.4",
 		"acorn-walk": "^8.0.0",
-		"ansi-styles": "^4.2.1",
+		"ansi-styles": "^5.0.0",
 		"arrgv": "^1.0.2",
 		"arrify": "^2.0.1",
 		"callsites": "^3.1.0",
 		"chalk": "^4.1.0",
-		"chokidar": "^3.4.2",
+		"chokidar": "^3.4.3",
 		"chunkd": "^2.0.1",
 		"ci-info": "^2.0.0",
 		"ci-parallel-vars": "^1.0.1",
@@ -75,9 +77,9 @@
 		"concordance": "^5.0.1",
 		"convert-source-map": "^1.7.0",
 		"currently-unhandled": "^0.4.1",
-		"debug": "^4.1.1",
-		"del": "^5.1.0",
-		"emittery": "^0.7.1",
+		"debug": "^4.3.1",
+		"del": "^6.0.0",
+		"emittery": "^0.8.0",
 		"equal-length": "^1.0.0",
 		"figures": "^3.2.0",
 		"globby": "^11.0.1",
@@ -85,57 +87,59 @@
 		"import-local": "^3.0.2",
 		"indent-string": "^4.0.0",
 		"is-error": "^2.2.2",
-		"is-plain-object": "^4.1.1",
+		"is-plain-object": "^5.0.0",
 		"is-promise": "^4.0.0",
 		"lodash": "^4.17.20",
 		"matcher": "^3.0.0",
 		"md5-hex": "^3.0.1",
-		"mem": "^6.1.0",
-		"ms": "^2.1.2",
-		"ora": "^5.0.0",
+		"mem": "^8.0.0",
+		"ms": "^2.1.3",
+		"ora": "^5.2.0",
+		"p-event": "^4.2.0",
 		"p-map": "^4.0.0",
 		"picomatch": "^2.2.2",
 		"pkg-conf": "^3.1.0",
 		"plur": "^4.0.0",
-		"pretty-ms": "^7.0.0",
+		"pretty-ms": "^7.0.1",
 		"read-pkg": "^5.2.0",
 		"resolve-cwd": "^3.0.0",
 		"slash": "^3.0.0",
 		"source-map-support": "^0.5.19",
-		"stack-utils": "^2.0.2",
+		"stack-utils": "^2.0.3",
 		"strip-ansi": "^6.0.0",
-		"supertap": "^1.0.0",
+		"supertap": "^2.0.0",
 		"temp-dir": "^2.0.0",
 		"trim-off-newlines": "^1.0.1",
-		"update-notifier": "^4.1.1",
+		"update-notifier": "^5.0.1",
 		"write-file-atomic": "^3.0.3",
-		"yargs": "^15.4.1"
+		"yargs": "^16.2.0"
 	},
 	"devDependencies": {
 		"@ava/babel": "^1.0.1",
 		"@ava/test": "github:avajs/test",
-		"@babel/plugin-proposal-do-expressions": "^7.10.4",
+		"@babel/plugin-proposal-do-expressions": "^7.12.1",
 		"@sinonjs/fake-timers": "^6.0.1",
 		"ansi-escapes": "^4.3.1",
-		"c8": "^7.3.0",
+		"c8": "^7.4.0",
 		"delay": "^4.4.0",
 		"esm": "^3.2.25",
-		"execa": "^4.0.3",
+		"execa": "^5.0.0",
+		"fs-extra": "^9.0.1",
 		"get-stream": "^6.0.0",
-		"p-event": "^4.2.0",
+		"it-first": "^1.0.4",
 		"proxyquire": "^2.1.3",
-		"react": "^16.13.1",
-		"react-test-renderer": "^16.13.1",
+		"react": "^16.14.0",
+		"react-test-renderer": "^16.14.0",
 		"replace-string": "^3.1.0",
-		"sinon": "^9.0.3",
+		"sinon": "^9.2.2",
 		"source-map-fixtures": "^2.1.0",
-		"tap": "^14.10.8",
+		"tap": "^14.11.0",
 		"temp-write": "^4.0.0",
-		"tempy": "^0.6.0",
+		"tempy": "^1.0.0",
 		"touch": "^3.1.0",
-		"tsd": "^0.13.1",
-		"typescript": "^3.9.7",
-		"xo": "^0.33.0",
+		"tsd": "^0.14.0",
+		"typescript": "^4.1.3",
+		"xo": "^0.36.1",
 		"zen-observable": "^0.8.15"
 	}
 }

package/plugin.d.ts

@@ -0,0 +1,79 @@
+export namespace SharedWorker {
+	export type ProtocolIdentifier = 'experimental';
+
+	export type FactoryOptions = {
+		negotiateProtocol <Data = unknown>(supported: readonly ['experimental']): Experimental.Protocol<Data>;
+		// Add overloads for additional protocols.
+	};
+
+	export type Factory = (options: FactoryOptions) => void;
+
+	export namespace Experimental {
+		export type Protocol<Data = unknown> = {
+			readonly initialData: Data;
+			readonly protocol: 'experimental';
+			broadcast: (data: Data) => BroadcastMessage<Data>;
+			ready: () => Protocol<Data>;
+			subscribe: () => AsyncIterableIterator<ReceivedMessage<Data>>;
+			testWorkers: () => AsyncIterableIterator<TestWorker<Data>>;
+		};
+
+		export type BroadcastMessage<Data = unknown> = {
+			readonly id: string;
+			replies: () => AsyncIterableIterator<ReceivedMessage<Data>>;
+		};
+
+		export type PublishedMessage<Data = unknown> = {
+			readonly id: string;
+			replies: () => AsyncIterableIterator<ReceivedMessage<Data>>;
+		};
+
+		export type ReceivedMessage<Data = unknown> = {
+			readonly data: Data;
+			readonly id: string;
+			readonly testWorker: TestWorker;
+			reply: (data: Data) => PublishedMessage<Data>;
+		};
+
+		export type TestWorker<Data = unknown> = {
+			readonly id: string;
+			readonly file: string;
+			publish: (data: Data) => PublishedMessage<Data>;
+			subscribe: () => AsyncIterableIterator<ReceivedMessage<Data>>;
+			teardown: <TeardownFn extends () => void> (fn: TeardownFn) => TeardownFn;
+		};
+	}
+
+	export namespace Plugin {
+		export type RegistrationOptions<Identifier extends ProtocolIdentifier, Data = unknown> = {
+			readonly filename: string;
+			readonly initialData?: Data;
+			readonly supportedProtocols: readonly Identifier[];
+			readonly teardown?: () => void;
+		};
+
+		export namespace Experimental {
+			export type Protocol<Data = unknown> = {
+				readonly available: Promise<void>;
+				readonly currentlyAvailable: boolean;
+				readonly protocol: 'experimental';
+				publish: (data: Data) => PublishedMessage<Data>;
+				subscribe: () => AsyncIterableIterator<ReceivedMessage<Data>>;
+			};
+
+			export type PublishedMessage<Data = unknown> = {
+				readonly id: string;
+				replies: () => AsyncIterableIterator<ReceivedMessage<Data>>;
+			};
+
+			export type ReceivedMessage<Data = unknown> = {
+				readonly data: Data;
+				readonly id: string;
+				reply: (data: Data) => PublishedMessage<Data>;
+			};
+		}
+	}
+}
+
+export function registerSharedWorker<Data = unknown>(options: SharedWorker.Plugin.RegistrationOptions<'experimental', Data>): SharedWorker.Plugin.Experimental.Protocol<Data>;
+// Add overloads for additional protocols.

package/plugin.js

@@ -0,0 +1,9 @@
+'use strict';
+const path = require('path');
+
+// Ensure the same AVA install is loaded by the test file as by the test worker
+if (process.env.AVA_PATH && process.env.AVA_PATH !== __dirname) {
+	module.exports = require(path.join(process.env.AVA_PATH, 'plugin'));
+} else {
+	module.exports = require('./lib/worker/plugin');
+}

package/readme.md

@@ -1,8 +1,5 @@
 # <img src="media/header.png" title="AVA" alt="AVA logo" width="530">
 
-[![Build Status](https://travis-ci.org/avajs/ava.svg?branch=master)](https://travis-ci.org/avajs/ava)  [![Coverage Status](https://codecov.io/gh/avajs/ava/branch/master/graph/badge.svg)](https://codecov.io/gh/avajs/ava/branch/master) [![XO code style](https://img.shields.io/badge/code_style-XO-5ed9c7.svg)](https://github.com/xojs/xo) [![Join the community on Spectrum](https://withspectrum.github.io/badge/badge.svg)](https://spectrum.chat/ava)
-[![Mentioned in Awesome Node.js](https://awesome.re/mentioned-badge.svg)](https://github.com/sindresorhus/awesome-nodejs)
-
 AVA is a test runner for Node.js with a concise API, detailed error output, embrace of new language features and process isolation that lets you develop with confidence 🚀
 
 Follow the [AVA Twitter account](https://twitter.com/ava__js) for updates.
@@ -143,6 +140,7 @@ We have a growing list of [common pitfalls](docs/08-common-pitfalls.md) you may
 
 ### Recipes
 
+- [Shared workers](docs/recipes/shared-workers.md)
 - [Test setup](docs/recipes/test-setup.md)
 - [Code coverage](docs/recipes/code-coverage.md)
 - [Watch mode](docs/recipes/watch-mode.md)
@@ -187,9 +185,7 @@ It's the [Andromeda galaxy](https://simple.wikipedia.org/wiki/Andromeda_galaxy).
 
 ## Support
 
-- [Stack Overflow](https://stackoverflow.com/questions/tagged/ava)
-- [Spectrum](https://spectrum.chat/ava)
-- [Twitter](https://twitter.com/ava__js)
+- [GitHub Discussions](https://github.com/avajs/ava/discussions)
 
 ## Related
 
@@ -205,7 +201,6 @@ It's the [Andromeda galaxy](https://simple.wikipedia.org/wiki/Andromeda_galaxy).
 
 - [AVA stickers, t-shirts, etc](https://www.redbubble.com/people/sindresorhus/works/30330590-ava-logo)
 - [Awesome list](https://github.com/avajs/awesome-ava)
-- [AVA Casts](http://avacasts.com)
 - [Do you like AVA? Donate here!](https://opencollective.com/ava)
 - [More…](https://github.com/avajs/awesome-ava)