@types/node 26.1.2 → 26.2.0

node/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for node (https://nodejs.org/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
 
 ### Additional Details
- * Last updated: Mon, 27 Jul 2026 17:32:10 GMT
+ * Last updated: Fri, 07 Aug 2026 17:46:44 GMT
  * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
 
 # Credits

node/child_process.d.ts

@@ -227,7 +227,6 @@ declare module "node:child_process" {
          * new process in a shell or with the use of the `shell` option of `ChildProcess`:
          *
          * ```js
-         * 'use strict';
          * import { spawn } from 'node:child_process';
          *
          * const subprocess = spawn(

node/crypto.d.ts

@@ -2698,12 +2698,12 @@ declare module "node:crypto" {
      */
     function sign(
         algorithm: string | null | undefined,
-        data: ArrayBufferLike | NodeJS.ArrayBufferView,
+        data: BinaryLike,
         key: KeyLike | SignKeyObjectInput | SignPrivateKeyInput | SignJsonWebKeyInput,
     ): NonSharedBuffer;
     function sign(
         algorithm: string | null | undefined,
-        data: ArrayBufferLike | NodeJS.ArrayBufferView,
+        data: BinaryLike,
         key: KeyLike | SignKeyObjectInput | SignPrivateKeyInput | SignJsonWebKeyInput,
         callback: (error: Error | null, data: NonSharedBuffer) => void,
     ): void;
@@ -2729,15 +2729,15 @@ declare module "node:crypto" {
      */
     function verify(
         algorithm: string | null | undefined,
-        data: ArrayBufferLike | NodeJS.ArrayBufferView,
+        data: BinaryLike,
         key: KeyLike | VerifyKeyObjectInput | VerifyPublicKeyInput | VerifyJsonWebKeyInput,
-        signature: ArrayBufferLike | NodeJS.ArrayBufferView,
+        signature: BinaryLike,
     ): boolean;
     function verify(
         algorithm: string | null | undefined,
-        data: ArrayBufferLike | NodeJS.ArrayBufferView,
+        data: BinaryLike,
         key: KeyLike | VerifyKeyObjectInput | VerifyPublicKeyInput | VerifyJsonWebKeyInput,
-        signature: ArrayBufferLike | NodeJS.ArrayBufferView,
+        signature: BinaryLike,
         callback: (error: Error | null, result: boolean) => void,
     ): void;
     /**

node/dns/promises.d.ts

@@ -183,7 +183,7 @@ declare module "node:dns/promises" {
      *     refresh: 900,
      *     retry: 900,
      *     expire: 1800,
-     *     minttl: 60 } ]
+     *     minttl: 60 } ];
      * ```
      * @since v10.6.0
      */
@@ -226,7 +226,7 @@ declare module "node:dns/promises" {
      *   regexp: '',
      *   replacement: '_sip._udp.example.com',
      *   order: 30,
-     *   preference: 100
+     *   preference: 100,
      * }
      * ```
      * @since v10.6.0
@@ -265,7 +265,7 @@ declare module "node:dns/promises" {
      *   refresh: 10000,
      *   retry: 2400,
      *   expire: 604800,
-     *   minttl: 3600
+     *   minttl: 3600,
      * }
      * ```
      * @since v10.6.0
@@ -285,7 +285,7 @@ declare module "node:dns/promises" {
      *   priority: 10,
      *   weight: 5,
      *   port: 21223,
-     *   name: 'service.example.com'
+     *   name: 'service.example.com',
      * }
      * ```
      * @since v10.6.0
@@ -306,7 +306,7 @@ declare module "node:dns/promises" {
      *   certUsage: 3,
      *   selector: 1,
      *   match: 1,
-     *   data: [ArrayBuffer]
+     *   data: [ArrayBuffer],
      * }
      * ```
      * @since v23.9.0, v22.15.0

node/dns.d.ts

@@ -490,7 +490,7 @@ declare module "node:dns" {
      *   regexp: '',
      *   replacement: '_sip._udp.example.com',
      *   order: 30,
-     *   preference: 100
+     *   preference: 100,
      * }
      * ```
      * @since v0.9.12
@@ -547,7 +547,7 @@ declare module "node:dns" {
      *   refresh: 10000,
      *   retry: 2400,
      *   expire: 604800,
-     *   minttl: 3600
+     *   minttl: 3600,
      * }
      * ```
      * @since v0.11.10
@@ -573,7 +573,7 @@ declare module "node:dns" {
      *   priority: 10,
      *   weight: 5,
      *   port: 21223,
-     *   name: 'service.example.com'
+     *   name: 'service.example.com',
      * }
      * ```
      * @since v0.1.27
@@ -600,7 +600,7 @@ declare module "node:dns" {
      *   certUsage: 3,
      *   selector: 1,
      *   match: 1,
-     *   data: [ArrayBuffer]
+     *   data: [ArrayBuffer],
      * }
      * ```
      * @since v23.9.0, v22.15.0
@@ -650,7 +650,7 @@ declare module "node:dns" {
      *     refresh: 900,
      *     retry: 900,
      *     expire: 1800,
-     *     minttl: 60 } ]
+     *     minttl: 60 } ];
      * ```
      *
      * DNS server operators may choose not to respond to `ANY` queries. It may be better to call individual methods like {@link resolve4}, {@link resolveMx}, and so on. For more details, see

node/fs.d.ts

@@ -48,6 +48,13 @@ declare module "node:fs" {
         mtime: Date;
         ctime: Date;
         birthtime: Date;
+        // Deliberately not defining a type alias here... it'd be exported, and something in the ecosystem would inevitably start using it.
+        // TODO: replace with Temporal builtins once @types/node no longer supports TS <6.0.
+        atimeInstant: typeof globalThis extends { Temporal: { Instant: new(...args: any[]) => infer T } } ? T : unknown;
+        mtimeInstant: typeof globalThis extends { Temporal: { Instant: new(...args: any[]) => infer T } } ? T : unknown;
+        ctimeInstant: typeof globalThis extends { Temporal: { Instant: new(...args: any[]) => infer T } } ? T : unknown;
+        birthtimeInstant: typeof globalThis extends { Temporal: { Instant: new(...args: any[]) => infer T } } ? T
+            : unknown;
     }
     interface Stats extends StatsBase<number> {}
     /**

node/http.d.ts

@@ -922,6 +922,36 @@ declare module "node:http" {
             headers?: OutgoingHttpHeaders | OutgoingHttpHeader[],
         ): this;
         writeHead(statusCode: number, headers?: OutgoingHttpHeaders | OutgoingHttpHeader[]): this;
+        /**
+         * Sends an arbitrary HTTP/1.1 1xx informational response to the client. This
+         * is a generic equivalent of `response.writeContinue()`,
+         * `response.writeProcessing()` and `response.writeEarlyHints()`, and
+         * can be called multiple times before the final response. After the final
+         * response headers have been sent (via `response.writeHead()` or an
+         * implicit header), calling this method throws `ERR_HTTP_HEADERS_SENT`.
+         *
+         * Clients receive these responses via the [`'information'`](https://nodejs.org/docs/latest-v26.x/api/http.html#event-information)
+         * event on `http.ClientRequest`.
+         *
+         * ```js
+         * response.writeInformation(110, { 'X-Progress': '50%' });
+         * ```
+         * @since v26.2.0
+         * @param statusCode An HTTP 1xx informational status code, between `100`
+         * and `199` inclusive, excluding `101` (Switching Protocols) which is only
+         * available through the [`'upgrade'`](https://nodejs.org/docs/latest-v26.x/api/http.html#event-upgrade) event.
+         * @param headers An optional set of headers to send with the
+         * informational response. Accepts the same shapes as
+         * `response.writeHead()`.
+         * @param callback Optional, called once the message has been written
+         * to the socket.
+         */
+        writeInformation(
+            statusCode: number,
+            headers?: OutgoingHttpHeaders | readonly string[],
+            callback?: () => void,
+        ): void;
+        writeInformation(statusCode: number, callback: () => void): void;
         /**
          * Sends a HTTP/1.1 102 Processing message to the client, indicating that
          * the request body should be sent.

node/http2.d.ts

@@ -59,7 +59,7 @@ declare module "node:http2" {
         "ready": [];
         "streamClosed": [code: number];
         "timeout": [];
-        "trailers": [trailers: IncomingHttpHeaders, flags: number];
+        "trailers": [headers: IncomingHttpHeaders, flags: number, rawHeaders: string[]];
         "wantTrailers": [];
     }
     interface Http2Stream extends stream.Duplex {
@@ -245,7 +245,7 @@ declare module "node:http2" {
     interface ClientHttp2StreamEventMap extends Http2StreamEventMap {
         "continue": [];
         "headers": [headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number, rawHeaders: string[]];
-        "push": [headers: IncomingHttpHeaders, flags: number];
+        "push": [headers: IncomingHttpHeaders, flags: number, rawHeaders: string[]];
         "response": [headers: IncomingHttpHeaders & IncomingHttpStatusHeader, flags: number, rawHeaders: string[]];
     }
     interface ClientHttp2Stream extends Http2Stream {
@@ -1644,8 +1644,8 @@ declare module "node:http2" {
          *
          * Then `request.url` will be:
          *
-         * ```js
-         * '/status?name=ryan'
+         * ```json
+         * "/status?name=ryan"
          * ```
          *
          * To parse the url into its parts, `new URL()` can be used:

node/os.d.ts

@@ -122,7 +122,7 @@ declare module "node:os" {
      *       irq: 20,
      *     },
      *   },
-     * ]
+     * ];
      * ```
      *
      * `nice` values are POSIX-only. On Windows, the `nice` values of all processors
@@ -167,44 +167,44 @@ declare module "node:os" {
      *
      * The properties available on the assigned network address object include:
      *
-     * ```js
+     * ```json
      * {
-     *   lo: [
+     *   "lo": [
      *     {
-     *       address: '127.0.0.1',
-     *       netmask: '255.0.0.0',
-     *       family: 'IPv4',
-     *       mac: '00:00:00:00:00:00',
-     *       internal: true,
-     *       cidr: '127.0.0.1/8'
+     *       "address:": "127.0.0.1",
+     *       "netmask:": "255.0.0.0",
+     *       "family:": "IPv4",
+     *       "mac:": "00:00:00:00:00:00",
+     *       "internal:": true,
+     *       "cidr:": "127.0.0.1/8"
      *     },
      *     {
-     *       address: '::1',
-     *       netmask: 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff',
-     *       family: 'IPv6',
-     *       mac: '00:00:00:00:00:00',
-     *       scopeid: 0,
-     *       internal: true,
-     *       cidr: '::1/128'
+     *       "address:": "::1",
+     *       "netmask:": "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
+     *       "family:": "IPv6",
+     *       "mac:": "00:00:00:00:00:00",
+     *       "scopeid:": 0,
+     *       "internal:": true,
+     *       "cidr:": "::1/128"
      *     }
      *   ],
-     *   eth0: [
+     *   "eth0": [
      *     {
-     *       address: '192.168.1.108',
-     *       netmask: '255.255.255.0',
-     *       family: 'IPv4',
-     *       mac: '01:02:03:0a:0b:0c',
-     *       internal: false,
-     *       cidr: '192.168.1.108/24'
+     *       "address:": "192.168.1.108",
+     *       "netmask:": "255.255.255.0",
+     *       "family:": "IPv4",
+     *       "mac:": "01:02:03:0a:0b:0c",
+     *       "internal:": false,
+     *       "cidr:": "192.168.1.108/24"
      *     },
      *     {
-     *       address: 'fe80::a00:27ff:fe4e:66a1',
-     *       netmask: 'ffff:ffff:ffff:ffff::',
-     *       family: 'IPv6',
-     *       mac: '01:02:03:0a:0b:0c',
-     *       scopeid: 1,
-     *       internal: false,
-     *       cidr: 'fe80::a00:27ff:fe4e:66a1/64'
+     *       "address:": "fe80::a00:27ff:fe4e:66a1",
+     *       "netmask:": "ffff:ffff:ffff:ffff::",
+     *       "family:": "IPv6",
+     *       "mac:": "01:02:03:0a:0b:0c",
+     *       "scopeid:": 1,
+     *       "internal:": false,
+     *       "cidr:": "fe80::a00:27ff:fe4e:66a1/64"
      *     }
      *   ]
      * }

node/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "26.1.2",
+    "version": "26.2.0",
     "description": "TypeScript definitions for node",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -150,6 +150,6 @@
         "undici-types": "~8.3.0"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "359a01a58cecf5a30fb7b7a7b10c4f5c332339421ef5cbc9932fc492f472a5b4",
+    "typesPublisherContentHash": "e8c7e12bafdd8ff8648e4d416be7af2d4373bffe17a7498d815e251898739e7c",
     "typeScriptVersion": "5.6"
 }

node/perf_hooks.d.ts

@@ -11,6 +11,7 @@ declare module "node:perf_hooks" {
         | "measure" // available on the Web
         | "net" // Node.js only
         | "node" // Node.js only
+        | "quic" // Node.js only
         | "resource"; // available on the Web
     interface ConnectionTimingInfo {
         domainLookupStartTime: number;
@@ -214,7 +215,7 @@ declare module "node:perf_hooks" {
          * @since v16.0.0
          */
         readonly detail: any;
-        readonly entryType: "dns" | "function" | "gc" | "http2" | "http" | "net" | "node";
+        readonly entryType: "dns" | "function" | "gc" | "http2" | "http" | "net" | "node" | "quic";
     }
     interface UVMetrics {
         /**

node/process.d.ts

@@ -791,14 +791,14 @@ declare module "node:process" {
                  *
                  * Results in `process.execArgv`:
                  *
-                 * ```js
+                 * ```json
                  * ["--icu-data-dir=./foo", "--require", "./bar.js"]
                  * ```
                  *
                  * And `process.argv`:
                  *
-                 * ```js
-                 * ['/usr/local/bin/node', 'script.js', '--version']
+                 * ```json
+                 * ["/usr/local/bin/node", "script.js", "--version"]
                  * ```
                  *
                  * Refer to `Worker constructor` for the detailed behavior of worker
@@ -810,8 +810,8 @@ declare module "node:process" {
                  * The `process.execPath` property returns the absolute pathname of the executable
                  * that started the Node.js process. Symbolic links, if any, are resolved.
                  *
-                 * ```js
-                 * '/usr/local/bin/node'
+                 * ```json
+                 * "/usr/local/bin/node"
                  * ```
                  * @since v0.1.100
                  */
@@ -994,18 +994,18 @@ declare module "node:process" {
                  *
                  * An example of this object looks like:
                  *
-                 * ```js
+                 * ```json
                  * {
-                 *   TERM: 'xterm-256color',
-                 *   SHELL: '/usr/local/bin/bash',
-                 *   USER: 'maciej',
-                 *   PATH: '~/.bin/:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin',
-                 *   PWD: '/Users/maciej',
-                 *   EDITOR: 'vim',
-                 *   SHLVL: '1',
-                 *   HOME: '/Users/maciej',
-                 *   LOGNAME: 'maciej',
-                 *   _: '/usr/local/bin/node'
+                 *   "TERM": "xterm-256color",
+                 *   "SHELL": "/usr/local/bin/bash",
+                 *   "USER": "maciej",
+                 *   "PATH": "~/.bin/:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin",
+                 *   "PWD": "/Users/maciej",
+                 *   "EDITOR": "vim",
+                 *   "SHLVL": "1",
+                 *   "HOME": "/Users/maciej",
+                 *   "LOGNAME": "maciej",
+                 *   "_": "/usr/local/bin/node"
                  * }
                  * ```
                  *
@@ -1540,29 +1540,28 @@ declare module "node:process" {
                  *
                  * An example of the possible output looks like:
                  *
-                 * ```js
+                 * ```json
                  * {
-                 *   target_defaults:
-                 *    { cflags: [],
-                 *      default_configuration: 'Release',
-                 *      defines: [],
-                 *      include_dirs: [],
-                 *      libraries: [] },
-                 *   variables:
+                 *   "target_defaults":
+                 *    { "cflags": [],
+                 *      "default_configuration": "Release",
+                 *      "defines": [],
+                 *      "include_dirs": [],
+                 *      "libraries": [] },
+                 *   "variables":
                  *    {
-                 *      host_arch: 'x64',
-                 *      napi_build_version: 5,
-                 *      node_install_npm: 'true',
-                 *      node_prefix: '',
-                 *      node_shared_cares: 'false',
-                 *      node_shared_http_parser: 'false',
-                 *      node_shared_libuv: 'false',
-                 *      node_shared_zlib: 'false',
-                 *      node_use_openssl: 'true',
-                 *      node_shared_openssl: 'false',
-                 *      strict_aliasing: 'true',
-                 *      target_arch: 'x64',
-                 *      v8_use_snapshot: 1
+                 *      "host_arch": "x64",
+                 *      "napi_build_version": 5,
+                 *      "node_install_npm": "true",
+                 *      "node_prefix": "",
+                 *      "node_shared_cares": "false",
+                 *      "node_shared_http_parser": "false",
+                 *      "node_shared_libuv": "false",
+                 *      "node_shared_zlib": "false",
+                 *      "node_use_openssl": "true",
+                 *      "node_shared_openssl": "false",
+                 *      "target_arch": "x64",
+                 *      "v8_use_snapshot": 1
                  *    }
                  * }
                  * ```
@@ -1876,13 +1875,13 @@ declare module "node:process" {
                  *
                  * `process.release` contains the following properties:
                  *
-                 * ```js
+                 * ```json
                  * {
-                 *   name: 'node',
-                 *   lts: 'Hydrogen',
-                 *   sourceUrl: 'https://nodejs.org/download/release/v18.12.0/node-v18.12.0.tar.gz',
-                 *   headersUrl: 'https://nodejs.org/download/release/v18.12.0/node-v18.12.0-headers.tar.gz',
-                 *   libUrl: 'https://nodejs.org/download/release/v18.12.0/win-x64/node.lib'
+                 *   "name": "node",
+                 *   "lts": "Hydrogen",
+                 *   "sourceUrl": "https://nodejs.org/download/release/v18.12.0/node-v18.12.0.tar.gz",
+                 *   "headersUrl": "https://nodejs.org/download/release/v18.12.0/node-v18.12.0-headers.tar.gz",
+                 *   "libUrl": "https://nodejs.org/download/release/v18.12.0/win-x64/node.lib"
                  * }
                  * ```
                  *