feat(jest-worker): support passing a URL as path to worker (#13982)

CHANGELOG.md

@@ -14,6 +14,7 @@
 - `[jest-runtime, @jest/transform]` Allow V8 coverage provider to collect coverage from files which were not loaded explicitly ([#13974](https://github.com/facebook/jest/pull/13974))
 - `[jest-snapshot]` Add support to `cts` and `mts` TypeScript files to inline snapshots ([#13975](https://github.com/facebook/jest/pull/13975))
 - `[jest-worker]` Add `start` method to worker farms ([#13937](https://github.com/facebook/jest/pull/13937))
+- `[jest-worker]` Support passing a URL as path to worker ([#13982](https://github.com/facebook/jest/pull/13982))
 
 ### Fixes
 

packages/jest-worker/README.md

@@ -49,9 +49,9 @@ To use `worker_threads` instead of default `child_process` you have to pass `ena
 
 The `Worker` export is a constructor that is initialized by passing the worker path, plus an options object.
 
-### `workerPath: string` (required)
+### `workerPath: string | URL` (required)
 
-Node module name or absolute path of the file to be loaded in the child processes. Use `require.resolve` to transform a relative path into an absolute one.
+Node module name or absolute path or file URL of the file to be loaded in the child processes. You can use `require.resolve` to transform a relative path into an absolute one.
 
 ### `options: Object` (optional)
 

packages/jest-worker/src/__tests__/index.test.ts

@@ -5,6 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
+import {pathToFileURL} from 'url';
 import type {JestWorkerFarm, Worker, WorkerFarmOptions} from '../';
 import type FarmClass from '../Farm';
 import type WorkerPoolClass from '../WorkerPool';
@@ -71,6 +72,19 @@ it('makes a non-existing relative worker throw', () => {
   }).toThrow("'workerPath' must be absolute");
 });
 
+it('supports URLs', () => {
+  const workerPathUrl = pathToFileURL(__filename);
+
+  // eslint-disable-next-line no-new
+  new WorkerFarm(workerPathUrl, {exposedMethods: ['foo', 'bar']});
+  // eslint-disable-next-line no-new
+  new WorkerFarm(workerPathUrl.href, {exposedMethods: ['foo', 'bar']});
+
+  expect(WorkerPool).toHaveBeenCalledTimes(2);
+  expect(WorkerPool).toHaveBeenNthCalledWith(1, __filename, expect.anything());
+  expect(WorkerPool).toHaveBeenNthCalledWith(2, __filename, expect.anything());
+});
+
 it('exposes the right API using default working', () => {
   const farm = new WorkerFarm('/tmp/baz.js', {
     exposedMethods: ['foo', 'bar'],

packages/jest-worker/src/index.ts

@@ -11,6 +11,7 @@ import {
   cpus,
 } from 'os';
 import {isAbsolute} from 'path';
+import {fileURLToPath} from 'url';
 import Farm from './Farm';
 import WorkerPool from './WorkerPool';
 import type {
@@ -95,11 +96,17 @@ export class Worker {
   private readonly _options: WorkerFarmOptions;
   private readonly _workerPool: WorkerPoolInterface;
 
-  constructor(workerPath: string, options?: WorkerFarmOptions) {
+  constructor(workerPath: string | URL, options?: WorkerFarmOptions) {
     this._options = {...options};
     this._ending = false;
 
-    if (!isAbsolute(workerPath)) {
+    if (typeof workerPath !== 'string') {
+      workerPath = workerPath.href;
+    }
+
+    if (workerPath.startsWith('file:')) {
+      workerPath = fileURLToPath(workerPath);
+    } else if (!isAbsolute(workerPath)) {
       throw new Error(`'workerPath' must be absolute, got '${workerPath}'`);
     }