feat: Throw DomException with name AbortError

source/errors/DOMException.ts

@@ -1,8 +1,20 @@
-const DOMException = globalThis.DOMException ?? Error;
+// DOMException is supported on most modern browsers and Node.js 18+.
+// @see https://developer.mozilla.org/en-US/docs/Web/API/DOMException#browser_compatibility
+const isDomExceptionSupported = Boolean(globalThis.DOMException);
 
-export default DOMException;
-
-// When targeting Node.js 18, use `signal.throwIfAborted()` (https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/throwIfAborted)
+// TODO: When targeting Node.js 18, use `signal.throwIfAborted()` (https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/throwIfAborted)
 export function composeAbortError(signal?: AbortSignal) {
-	return new DOMException(signal?.reason ?? 'The operation was aborted.');
+	/*
+	NOTE: Use DomException with AbortError name as specified in MDN docs (https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort)
+	> When abort() is called, the fetch() promise rejects with an Error of type DOMException, with name AbortError.
+	*/
+	if (isDomExceptionSupported) {
+		return new DOMException(signal?.reason ?? 'The operation was aborted.', 'AbortError');
+	}
+
+	// DOMException not supported. Fall back to use of error and override name.
+	const error = new Error(signal?.reason ?? 'The operation was aborted.');
+	error.name = 'AbortError';
+
+	return error;
 }

test/main.ts

@@ -582,7 +582,7 @@ test('ky.extend()', async t => {
 	await server.close();
 });
 
-test('throws DOMException when aborted by user', async t => {
+test('throws DOMException/Error with name AbortError when aborted by user', async t => {
 	const server = await createHttpTestServer();
 	// eslint-disable-next-line @typescript-eslint/no-empty-function
 	server.get('/', () => {});
@@ -592,8 +592,10 @@ test('throws DOMException when aborted by user', async t => {
 	const response = ky(server.url, {signal});
 	abortController.abort();
 
-	const {name} = (await t.throwsAsync(response))!;
-	t.true(['DOMException', 'Error'].includes(name), `Expected DOMException or Error, got ${name}`);
+	const error = (await t.throwsAsync(response))!;
+
+	t.true(['DomException', 'Error'].includes(error.constructor.name), `Expected DOMException or Error, got ${error.constructor.name}`);
+	t.is(error.name, 'AbortError', `Expected AbortError, got ${error.name}`);
 });
 
 test('supports Request instance as input', async t => {