@axe-core/watcher 4.3.0-next.edd20fc3 → 4.3.0-next.f6c299b0

package/dist/utils/sync-fetch-worker.mjs

@@ -101,8 +101,70 @@ export const shouldUseEnvProxy = function () {
  * @property {Object} options - The fetch options.
  * @property {number} timeout - The timeout in milliseconds.
  * @property {MessagePort} port - The message port for communication.
+ * @property {SharedArrayBuffer} signalBuffer - Used to wake the main thread.
+ *   Encoding: Int32Array of length 2.
+ *     [0] wake-reason: 0 = still waiting, 1 = postMessage delivered,
+ *                      2 = worker died before delivering a message.
+ *     [1] exit code when [0] === 2; otherwise 0.
  */
-const { url, options, timeout, port } = workerData
+const SIGNAL_WAITING = 0
+const SIGNAL_POSTMESSAGE = 1
+const SIGNAL_DIED = 2
+
+const { url, options, timeout, port, signalBuffer } = workerData
+const signalArray = new Int32Array(signalBuffer)
+
+/**
+ * Wake the main thread, which is blocked in Atomics.wait on signalArray[0].
+ * Call after every postMessage so the caller never spins waiting for a
+ * message that's already arrived. Idempotent — once signalArray[0] has been
+ * set, re-entry is a no-op.
+ */
+function notifyMainThread() {
+  if (Atomics.load(signalArray, 0) !== SIGNAL_WAITING) {
+    return
+  }
+  Atomics.store(signalArray, 0, SIGNAL_POSTMESSAGE)
+  Atomics.notify(signalArray, 0)
+}
+
+// Worker-death watchdogs. These run inside the worker thread (unlike
+// worker.on('error') / worker.on('exit') on the parent, which can't fire
+// before syncFetch's synchronous throw because libuv events don't deliver
+// while the main thread is in Atomics.wait or running sync code).
+//
+// They sit between top-level destructuring and the fetch try-block, which
+// means any error originating before this point (bad workerData, broken
+// imports) still falls back to the main thread's plain timeout. That trade
+// is acceptable: catastrophic-startup is rare and unrecoverable.
+process.on('uncaughtException', error => {
+  if (Atomics.load(signalArray, 0) !== SIGNAL_WAITING) {
+    return
+  }
+  // Forward through the normal port channel so the caller gets the full
+  // error chain. If postMessage itself throws (e.g. error wasn't cloneable),
+  // we have no remaining channel to deliver the error — force an exit so
+  // the death watchdog below fires synchronously and wakes the parent.
+  // Without this, installing an uncaughtException handler suppresses Node's
+  // default exit and the parent blocks for the full mainThreadTimeout.
+  try {
+    const wrapped = new FetchWorkerError({ url: sanitizeUrl(url) })
+    wrapped.cause = error
+    port.postMessage({ error: wrapped })
+    notifyMainThread()
+  } catch {
+    process.exit(1)
+  }
+})
+
+process.on('exit', code => {
+  if (Atomics.load(signalArray, 0) !== SIGNAL_WAITING) {
+    return
+  }
+  Atomics.store(signalArray, 1, code)
+  Atomics.store(signalArray, 0, SIGNAL_DIED)
+  Atomics.notify(signalArray, 0)
+})
 
 try {
   let dispatcher = getGlobalDispatcher()
@@ -133,6 +195,7 @@ try {
   port.postMessage({
     data: responseData
   })
+  notifyMainThread()
 } catch (error) {
   const HTTP_PROXY = process.env.http_proxy || process.env.HTTP_PROXY
   const HTTPS_PROXY = process.env.https_proxy || process.env.HTTPS_PROXY
@@ -165,6 +228,7 @@ try {
   port.postMessage({
     error: err
   })
+  notifyMainThread()
 } finally {
   port.close()
 }

package/dist/utils/sync-fetch.d.ts

@@ -1,5 +1,13 @@
 export interface SyncFetchCustomOptions {
     timeout?: number;
+    /**
+     * @internal Test-only override for the worker script path. Allows tests to
+     * substitute a fixture worker that intentionally dies before notifying, so
+     * the in-worker death watchdogs (process.on('uncaughtException') /
+     * process.on('exit')) and the signalBuffer-driven timeout error can be
+     * exercised end-to-end.
+     */
+    _workerPath?: string;
 }
 export interface SyncFetchResponse {
     status: number;
@@ -9,3 +17,27 @@ export interface SyncFetchResponse {
     ok: boolean;
 }
 export declare function syncFetch(url: string, options?: RequestInit, customOptions?: SyncFetchCustomOptions): SyncFetchResponse;
+/**
+ * Wake-reason values written to `signalArray[0]` by sync-fetch-worker.mjs.
+ *
+ * @internal Exported for tests.
+ */
+export declare const SIGNAL_WAITING = 0;
+/** @internal */
+export declare const SIGNAL_POSTMESSAGE = 1;
+/** @internal */
+export declare const SIGNAL_DIED = 2;
+/**
+ * Build the diagnostic Error thrown when the worker fails to deliver a message
+ * before the main-thread timeout. When the worker's death-watchdog fired
+ * (`wakeReason === SIGNAL_DIED`) the exit code is folded into the message so
+ * the failure is debuggable instead of opaque. Otherwise the wait simply
+ * timed out and we report the plain timeout.
+ *
+ * @internal Exported for tests.
+ */
+export declare function buildTimeoutError(args: {
+    mainThreadTimeout: number;
+    wakeReason: number;
+    exitCode: number;
+}): Error;

package/dist/utils/sync-fetch.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SIGNAL_DIED = exports.SIGNAL_POSTMESSAGE = exports.SIGNAL_WAITING = void 0;
 exports.syncFetch = syncFetch;
+exports.buildTimeoutError = buildTimeoutError;
 const node_worker_threads_1 = require("node:worker_threads");
 const node_path_1 = require("node:path");
 function syncFetch(url, options = {}, customOptions = {
@@ -10,28 +12,34 @@ function syncFetch(url, options = {}, customOptions = {
     const processingBuffer = 3000;
     const mainThreadTimeout = timeout + processingBuffer;
     const { port1, port2 } = new node_worker_threads_1.MessageChannel();
-    const sleepBuffer = new SharedArrayBuffer(4);
-    const sleepArray = new Int32Array(sleepBuffer);
-    const worker = new node_worker_threads_1.Worker((0, node_path_1.join)(__dirname, 'sync-fetch-worker.mjs'), {
+    const signalBuffer = new SharedArrayBuffer(8);
+    const signalArray = new Int32Array(signalBuffer);
+    const workerPath = customOptions._workerPath ?? (0, node_path_1.join)(__dirname, 'sync-fetch-worker.mjs');
+    const worker = new node_worker_threads_1.Worker(workerPath, {
         name: 'sync-fetch',
         eval: false,
         workerData: {
             url,
             options,
             timeout,
-            port: port2
+            port: port2,
+            signalBuffer
         },
         transferList: [port2]
     });
-    const { startTime } = performance.mark('axe-watcher:sync-fetch:start');
+    worker.on('error', () => {
+    });
+    performance.mark('axe-watcher:sync-fetch:start');
     let message;
     try {
-        while (message === undefined) {
-            if (performance.now() - startTime > mainThreadTimeout) {
-                throw new Error(`Request timed out - worker thread did not respond within ${mainThreadTimeout}ms`);
-            }
-            Atomics.wait(sleepArray, 0, 0, 5);
-            message = (0, node_worker_threads_1.receiveMessageOnPort)(port1);
+        Atomics.wait(signalArray, 0, 0, mainThreadTimeout);
+        message = (0, node_worker_threads_1.receiveMessageOnPort)(port1);
+        if (message === undefined) {
+            throw buildTimeoutError({
+                mainThreadTimeout,
+                wakeReason: Atomics.load(signalArray, 0),
+                exitCode: Atomics.load(signalArray, 1)
+            });
         }
         const { data, error } = message.message;
         if (error) {
@@ -63,6 +71,16 @@ function syncFetch(url, options = {}, customOptions = {
         });
     }
 }
+exports.SIGNAL_WAITING = 0;
+exports.SIGNAL_POSTMESSAGE = 1;
+exports.SIGNAL_DIED = 2;
+function buildTimeoutError(args) {
+    const { mainThreadTimeout, wakeReason, exitCode } = args;
+    const reason = wakeReason === exports.SIGNAL_DIED
+        ? `worker exited with code ${exitCode} before responding`
+        : `worker thread did not respond within ${mainThreadTimeout}ms`;
+    return new Error(`Request timed out - ${reason}`);
+}
 function sanitizeHeaders(headers) {
     if (!headers) {
         return undefined;

package/dist/utils/sync-fetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync-fetch.js","sourceRoot":"","sources":["../../src/utils/sync-fetch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sync-fetch.js","sourceRoot":"","sources":["../../src/utils/sync-fetch.ts"],"names":[],"mappings":"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"}