From 4ef291a96f9a55ddfa20809eccc73d7ab140ec88 Mon Sep 17 00:00:00 2001
From: Chris Duncan <chris@zoso.dev>
Date: Thu, 23 Apr 2026 14:45:49 -0700
Subject: [PATCH] Add JSdoc typing to rejection test harness and return its
 error for further inspection during test.

---
 test/GLOBALS.mjs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/test/GLOBALS.mjs b/test/GLOBALS.mjs
index deca184..d94c75b 100644
--- a/test/GLOBALS.mjs
+++ b/test/GLOBALS.mjs
@@ -263,6 +263,11 @@ export class assert {
 		}
 	}
 
+	/**
+	 * @param {(Function | Promise<any>)} fn
+	 * @param {string} [msg]
+	 * @returns {Promise<Error>}
+	 */
 	static async rejects (fn, msg) {
 		if (fn.constructor.name === 'AsyncFunction') {
 			fn = fn()
@@ -271,7 +276,9 @@ export class assert {
 			try {
 				await fn
 				throw new Error(msg ?? 'expected async function to reject')
-			} catch { }
+			} catch (err) {
+				return err
+			}
 		} else {
 			throw new Error(msg ?? 'expected async function')
 		}
-- 
2.47.3