feat: upgrade to undici@8

.github/workflows/nodejs.yml

@@ -41,7 +41,7 @@ jobs:
       fail-fast: false
       matrix:
         os: ['ubuntu-latest', 'macos-latest', 'windows-latest']
-        node: ['22', '24', '25']
+        node: ['22', '24', '26']
 
     name: Test (${{ matrix.os }}, ${{ matrix.node }})
     runs-on: ${{ matrix.os }}

package.json

@@ -75,7 +75,7 @@
     "mime-types": "^2.1.35",
     "qs": "^6.15.0",
     "type-fest": "^4.41.0",
-    "undici": "^7.24.0",
+    "undici": "^8.4.1",
     "ylru": "^2.0.0"
   },
   "devDependencies": {
@@ -110,7 +110,7 @@
     }
   },
   "engines": {
-    "node": ">= 22.0.0"
+    "node": ">= 22.19.0"
   },
   "packageManager": "pnpm@11.6.0"
 }

src/HttpClient.ts

@@ -74,7 +74,7 @@ const debug = debuglog('urllib:HttpClient');
 
 export type ClientOptions = {
   defaultArgs?: RequestOptions;
-  /** Allow to use HTTP2 first. Default is `false` */
+  /** Allow negotiating HTTP/2 with capable servers via ALPN. Since undici@8 this is enabled by default. */
   allowH2?: boolean;
   /** Custom DNS lookup function, default is `dns.lookup`. */
   lookup?: LookupFunction;

src/Request.ts

@@ -14,7 +14,7 @@ export type RequestURL = string | URL;
 export type FixJSONCtlCharsHandler = (data: string) => string;
 export type FixJSONCtlChars = boolean | FixJSONCtlCharsHandler;
 
-type AbortSignal = unknown;
+type AbortSignal = globalThis.AbortSignal;
 
 export type RequestOptions = {
   /** Request method, defaults to GET. Could be GET, POST, DELETE or PUT. Alias 'type'. */

src/index.ts

@@ -55,7 +55,7 @@ interface UrllibRequestOptions extends RequestOptions {
    * verification fails. Default: `true`
    */
   rejectUnauthorized?: boolean;
-  /** Allow to use HTTP2 first. Default is `false` */
+  /** Allow negotiating HTTP/2 with capable servers via ALPN. Since undici@8 this is enabled by default. */
   allowH2?: boolean;
 }
 

test/HttpClient.test.ts

@@ -121,7 +121,9 @@ describe('HttpClient.test.ts', () => {
         httpClient.request(_url),
       ]);
       // console.log(httpClient.getDispatcherPoolStats());
-      assert.equal(httpClient.getDispatcherPoolStats()['https://registry.npmmirror.com'].connected, 4);
+      // undici@8 negotiates HTTP/2 with h2-capable servers, so all requests are
+      // multiplexed over a single connection instead of opening one per request.
+      assert.equal(httpClient.getDispatcherPoolStats()['https://registry.npmmirror.com'].connected, 1);
       assert(httpClient.getDispatcherPoolStats()[_url.substring(0, _url.length - 1)].connected > 1);
     });
 

test/options.dispatcher.test.ts

@@ -11,6 +11,7 @@ describe('options.dispatcher.test.ts', () => {
   let _url: string;
   let proxyServer: any;
   let proxyServerUrl: string;
+  const proxyAgents: ProxyAgent[] = [];
   beforeAll(async () => {
     const { closeServer, url } = await startServer();
     close = closeServer;
@@ -27,13 +28,16 @@ describe('options.dispatcher.test.ts', () => {
 
   afterAll(async () => {
     await close();
+    // close keep-alive proxy connections so the proxy server can shut down
+    await Promise.all(proxyAgents.map((proxyAgent) => proxyAgent.close()));
     await new Promise((resolve) => {
       proxyServer.close(resolve);
     });
   });
 
   it('should work with proxyAgent dispatcher', async () => {
     const proxyAgent = new ProxyAgent(proxyServerUrl);
+    proxyAgents.push(proxyAgent);
     const response = await request(`${_url}html`, {
       dispatcher: proxyAgent,
       dataType: 'text',
@@ -55,6 +59,7 @@ describe('options.dispatcher.test.ts', () => {
   it('should work with getGlobalDispatcher() dispatcher', async () => {
     const agent = getGlobalDispatcher();
     const proxyAgent = new ProxyAgent(proxyServerUrl);
+    proxyAgents.push(proxyAgent);
     setGlobalDispatcher(proxyAgent);
     const response = await request(`${_url}html`, {
       dataType: 'text',

test/options.timeout.test.ts

@@ -104,9 +104,10 @@ describe('options.timeout.test.ts', () => {
         // console.error(err);
         assert.equal(err.name, 'HttpClientRequestTimeoutError');
         assert.equal(err.message, 'Request timeout for 10 ms');
-        assert.equal(err.cause.name, 'InformationalError');
-        assert.equal(err.cause.message, 'HTTP/2: "stream timeout after 10"');
-        assert.equal(err.cause.code, 'UND_ERR_INFO');
+        // undici@8 reports HTTP/2 headers timeout as a standard HeadersTimeoutError
+        assert.equal(err.cause.name, 'HeadersTimeoutError');
+        assert.equal(err.cause.message, 'HTTP/2: "headers timeout after 10"');
+        assert.equal(err.cause.code, 'UND_ERR_HEADERS_TIMEOUT');
 
         assert.equal(err.res.status, -1);
         assert(err.res.rt > 10, `actual ${err.res.rt}`);