Add filterNodeArgumentsForWorkerThreads option

This filter function can be used to remove node arguments that may be applied to the main process, but cannot be used to start worker threads. It can only be configured in a JavaScript configuration file. It does not apply when using child processes.

Co-authored-by: Tommy <tmitchell7@uh.edu>
Co-authored-by: Mark Wubben <mark@novemberborn.net>

Author: 3 people

docs/06-configuration.md

@@ -337,3 +337,19 @@ These may also export a function which is then invoked, and can receive argument
 The `nodeArguments` configuration may be used to specify additional arguments for launching worker processes. These are combined with `--node-arguments` passed on the CLI and any arguments passed to the `node` binary when starting AVA.
 
 [CLI]: ./05-command-line.md
+
+## Node arguments filter for worker threads
+
+In a config file only, `filterNodeArgumentsForWorkerThreads` may provide a function used for filtering `nodeArguments` sent to worker threads. This enables excluding arguments that throw if sent to a thread. The filter is ignored by worker processes.
+
+`ava.config.js`:
+```js
+const processOnly = new Set([
+	'--allow-natives-syntax',
+	'--expose-gc'
+]);
+
+export default {
+	filterNodeArgumentsForWorkerThreads: argument => !processOnly.has(argument)
+}
+```

lib/cli.js

@@ -388,9 +388,15 @@ export default async function loadCli() { // eslint-disable-line complexity
 		exit(error.message);
 	}
 
+	const workerThreads = combined.workerThreads !== false;
+
 	let nodeArguments;
 	try {
 		nodeArguments = normalizeNodeArguments(conf.nodeArguments, argv['node-arguments']);
+		if (workerThreads && 'filterNodeArgumentsForWorkerThreads' in conf) {
+			const {filterNodeArgumentsForWorkerThreads: filter} = conf;
+			nodeArguments = nodeArguments.filter(argument => filter(argument));
+		}
 	} catch (error) {
 		exit(error.message);
 	}

lib/load-config.js

@@ -157,6 +157,13 @@ export async function loadConfig({configFile, resolveFrom = process.cwd(), defau
 		...defaults, nonSemVerExperiments: {}, ...fileConf, ...packageConf, projectDir, configFile,
 	};
 
+	if (
+		'filterNodeArgumentsForWorkerThreads' in config
+		&& typeof config.filterNodeArgumentsForWorkerThreads !== 'function'
+	) {
+		throw new Error(`filterNodeArgumentsForWorkerThreads from ${fileForErrorMessage} must be a function`);
+	}
+
 	const {nonSemVerExperiments: experiments} = config;
 	if (!isPlainObject(experiments)) {
 		throw new Error(`nonSemVerExperiments from ${fileForErrorMessage} must be an object`);

test-tap/api.js

@@ -1,5 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
 import ciInfo from 'ci-info';
@@ -20,6 +21,7 @@ async function apiCreator(options = {}) {
 	options.globs = normalizeGlobs({
 		files: options.files, ignoredByWatcher: options.watchMode?.ignoreChanges, extensions: options.extensions, providers: [],
 	});
+	options.nodeArguments = process.execArgv;
 	const instance = new Api(options);
 
 	return instance;

test-tap/fixture/load-config/non-function/ava.config.js

@@ -0,0 +1,3 @@
+export default {
+	filterNodeArgumentsForWorkerThreads: [],
+};

test-tap/fixture/load-config/non-function/package.json

@@ -0,0 +1,3 @@
+{
+	"type": "module"
+}

test/config/loader.js

@@ -117,6 +117,8 @@ test.serial('throws an error if a .js config file has no default export', notOk(
 
 test.serial('throws an error if a config file contains `ava` property', notOk('contains-ava-property'));
 
+test.serial('throws an error if a config file contains a non-function `filterNodeArgumentsForWorkerThreads` property', notOk('non-function'));
+
 test.serial('throws an error if a config file contains a non-object `nonSemVerExperiments` property', notOk('non-object-experiments'));
 
 test.serial('throws an error if a config file enables an unsupported experiment', notOk('unsupported-experiments'));

test/config/snapshots/loader.js.md

@@ -40,6 +40,12 @@ Generated by [AVA](https://avajs.dev).
 
     'Encountered ’ava’ property in ava.config.js; avoid wrapping the configuration'
 
+## throws an error if a config file contains a non-function `filterNodeArgumentsForWorkerThreads` property
+
+> error message
+
+    'filterNodeArgumentsForWorkerThreads from ava.config.js must be a function'
+
 ## throws an error if a config file contains a non-object `nonSemVerExperiments` property
 
 > error message
@@ -57,3 +63,9 @@ Generated by [AVA](https://avajs.dev).
 > error message
 
     'Conflicting configuration in ava.config.js and ava.config.cjs'
+
+## throws an error if a config file contains a non-function `threadArgumentsFilter` property
+
+> error message
+
+    'threadArgumentsFilter from ava.config.js must be a function'

test/config/snapshots/loader.js.snap

@@ -0,0 +1,3 @@
+{
+	"type": "module"
+}