🤖 Merge PR DefinitelyTyped#74610 node: v25.5 by @Renegade334

Renegade334 · web-flow · commit ee54dfb7f243 · 2026-03-12T08:31:08.000-07:00
diff --git a/types/node/fs.d.ts b/types/node/fs.d.ts
@@ -3553,10 +3553,12 @@ declare module "node:fs" {
      */
     function unwatchFile(filename: PathLike, listener?: StatsListener): void;
     function unwatchFile(filename: PathLike, listener?: BigIntStatsListener): void;
+    type WatchIgnorePredicate = string | RegExp | ((filename: string) => boolean);
     interface WatchOptions extends Abortable {
         encoding?: BufferEncoding | "buffer" | undefined;
         persistent?: boolean | undefined;
         recursive?: boolean | undefined;
+        ignore?: WatchIgnorePredicate | readonly WatchIgnorePredicate[] | undefined;
     }
     interface WatchOptionsWithBufferEncoding extends WatchOptions {
         encoding: "buffer";
diff --git a/types/node/inspector.d.ts b/types/node/inspector.d.ts
@@ -218,6 +218,51 @@ declare module "node:inspector" {
          */
         function put(url: string, data: string): void;
     }
+    namespace DOMStorage {
+        /**
+         * This feature is only available with the
+         * `--experimental-storage-inspection` flag enabled.
+         *
+         * Broadcasts the `DOMStorage.domStorageItemAdded` event to connected frontends.
+         * This event indicates that a new item has been added to the storage.
+         * @since v25.5.0
+         */
+        function domStorageItemAdded(params: DomStorageItemAddedEventDataType): void;
+        /**
+         * This feature is only available with the
+         * `--experimental-storage-inspection` flag enabled.
+         *
+         * Broadcasts the `DOMStorage.domStorageItemRemoved` event to connected frontends.
+         * This event indicates that an item has been removed from the storage.
+         * @since v25.5.0
+         */
+        function domStorageItemRemoved(params: DomStorageItemRemovedEventDataType): void;
+        /**
+         * This feature is only available with the
+         * `--experimental-storage-inspection` flag enabled.
+
+         * Broadcasts the `DOMStorage.domStorageItemUpdated` event to connected frontends.
+         * This event indicates that a storage item has been updated.
+         * @since v25.5.0
+         */
+        function domStorageItemUpdated(params: DomStorageItemUpdatedEventDataType): void;
+        /**
+         * This feature is only available with the
+         * `--experimental-storage-inspection` flag enabled.
+         *
+         * Broadcasts the `DOMStorage.domStorageItemsCleared` event to connected
+         * frontends. This event indicates that all items have been cleared from the
+         * storage.
+         * @since v25.5.0
+         */
+        function domStorageItemsCleared(params: DomStorageItemsClearedEventDataType): void;
+        /**
+         * This feature is only available with the
+         * `--experimental-storage-inspection` flag enabled.
+         * @since v25.5.0
+         */
+        function registerStorage(params: unknown): void;
+    }
 }
 declare module "inspector" {
     export * from "node:inspector";
diff --git a/types/node/inspector.generated.d.ts b/types/node/inspector.generated.d.ts
diff --git a/types/node/node-tests/fs.ts b/types/node/node-tests/fs.ts
@@ -267,6 +267,7 @@ async function testPromisify() {
         persistent: true,
         encoding: "utf8",
         signal: new AbortSignal(),
+        ignore: (filename) => filename.startsWith("_"),
     }, (event, filename) => {
         console.log(event, filename);
     });
diff --git a/types/node/node-tests/sqlite.ts b/types/node/node-tests/sqlite.ts
@@ -73,13 +73,23 @@ import { TextEncoder } from "node:util";
 }
 
 {
-    new DatabaseSync(":memory:", {
+    const db = new DatabaseSync(":memory:", {
         timeout: 10_000,
         readBigInts: true,
         returnArrays: true,
         allowBareNamedParameters: false,
         allowUnknownNamedParameters: true,
     });
+
+    const stmt = db.prepare("SELECT 1", {
+        readBigInts: true,
+        returnArrays: true,
+        allowBareNamedParameters: false,
+        allowUnknownNamedParameters: true,
+    });
+
+    // $ExpectType SQLOutputValue
+    stmt.get()![0];
 }
 
 {
diff --git a/types/node/node-tests/test.ts b/types/node/node-tests/test.ts
@@ -6,6 +6,7 @@ import {
     before,
     beforeEach,
     describe,
+    expectFailure,
     it,
     Mock,
     mock,
@@ -222,6 +223,7 @@ describe("options with values", {
     skip: "reason for skip",
     timeout: Infinity,
     todo: "reason for todo",
+    expectFailure: true,
 });
 
 it("options with values", {
@@ -231,6 +233,7 @@ it("options with values", {
     skip: "reason for skip",
     timeout: Infinity,
     todo: "reason for todo",
+    expectFailure: true,
 });
 
 describe("options with booleans", {
@@ -341,6 +344,39 @@ it.only("only shorthand", {
     timeout: Infinity,
 });
 
+expectFailure("x", {
+    concurrency: 1,
+    only: true,
+    signal: new AbortController().signal,
+    timeout: Infinity,
+});
+expectFailure((t, cb) => {
+    // $ExpectType TestContext
+    t;
+    // $ExpectType (result?: any) => void
+    cb;
+    // $ExpectType void
+    cb({ x: "anything" });
+});
+test.expectFailure("x", {
+    concurrency: 1,
+    only: true,
+    signal: new AbortController().signal,
+    timeout: Infinity,
+});
+describe.expectFailure("x", {
+    concurrency: 1,
+    only: true,
+    signal: new AbortController().signal,
+    timeout: Infinity,
+});
+it.expectFailure("x", {
+    concurrency: 1,
+    only: true,
+    signal: new AbortController().signal,
+    timeout: Infinity,
+});
+
 // Test with suite context
 describe(s => {
     // $ExpectType SuiteContext
diff --git a/types/node/node-tests/tls.ts b/types/node/node-tests/tls.ts
@@ -277,26 +277,31 @@ import {
     socket = socket.addListener("OCSPResponse", (response) => {
         const _response: Buffer = response;
     });
+    socket = socket.addListener("secure", () => {});
     socket = socket.addListener("secureConnect", () => {});
 
     socket = socket.on("OCSPResponse", (response) => {
         const _response: Buffer = response;
     });
+    socket = socket.on("secure", () => {});
     socket = socket.on("secureConnect", () => {});
 
     socket = socket.once("OCSPResponse", (response) => {
         const _response: Buffer = response;
     });
+    socket = socket.once("secure", () => {});
     socket = socket.once("secureConnect", () => {});
 
     socket = socket.prependListener("OCSPResponse", (response) => {
         const _response: Buffer = response;
     });
+    socket = socket.prependListener("secure", () => {});
     socket = socket.prependListener("secureConnect", () => {});
 
     socket = socket.prependOnceListener("OCSPResponse", (response) => {
         const _response: Buffer = response;
     });
+    socket = socket.prependOnceListener("secure", () => {});
     socket = socket.prependOnceListener("secureConnect", () => {});
 
     socket.once("session", (buff: Buffer) => {});
diff --git a/types/node/node-tests/v8.ts b/types/node/node-tests/v8.ts
@@ -19,11 +19,9 @@ v8.takeCoverage();
 v8.stopCoverage();
 
 {
-    const profiler = new v8.GCProfiler();
+    using profiler = new v8.GCProfiler();
     profiler.start();
-    setTimeout(() => {
-        console.log(profiler.stop());
-    }, 1000);
+    profiler.stop();
 }
 
 const disable = v8.promiseHooks.createHook({
diff --git a/types/node/package.json b/types/node/package.json
@@ -1,7 +1,7 @@
 {
     "private": true,
     "name": "@types/node",
-    "version": "25.4.9999",
+    "version": "25.5.9999",
     "nonNpm": "conflict",
     "nonNpmDescription": "Node.js",
     "projects": [
diff --git a/types/node/process.d.ts b/types/node/process.d.ts
@@ -729,7 +729,8 @@ declare module "node:process" {
                  * arguments passed when the Node.js process was launched. The first element will
                  * be {@link execPath}. See `process.argv0` if access to the original value
                  * of `argv[0]` is needed. The second element will be the path to the JavaScript
-                 * file being executed. The remaining elements will be any additional command-line
+                 * file being executed. If a [program entry point](https://nodejs.org/docs/latest-v25.x/api/cli.html#program-entry-point) was provided, the second element
+                 * will be the absolute path to it. The remaining elements are additional command-line
                  * arguments.
                  *
                  * For example, assuming the following script for `process-args.js`:
diff --git a/types/node/sqlite.d.ts b/types/node/sqlite.d.ts
@@ -128,7 +128,7 @@ declare module "node:sqlite" {
          * language features that allow ordinary SQL to deliberately corrupt the database file are disabled.
          * The defensive flag can also be set using `enableDefensive()`.
          * @since v25.1.0
-         * @default false
+         * @default true
          */
         defensive?: boolean | undefined;
     }
@@ -233,6 +233,28 @@ declare module "node:sqlite" {
          */
         inverse?: ((accumulator: T, ...args: SQLOutputValue[]) => T) | undefined;
     }
+    interface PrepareOptions {
+        /**
+         * If `true`, integer fields are read as `BigInt`s.
+         * @since v25.5.0
+         */
+        readBigInts?: boolean | undefined;
+        /**
+         * If `true`, results are returned as arrays.
+         * @since v25.5.0
+         */
+        returnArrays?: boolean | undefined;
+        /**
+         * If `true`, allows binding named parameters without the prefix character.
+         * @since v25.5.0
+         */
+        allowBareNamedParameters?: boolean | undefined;
+        /**
+         * If `true`, unknown named parameters are ignored.
+         * @since v25.5.0
+         */
+        allowUnknownNamedParameters?: boolean | undefined;
+    }
     /**
      * This class represents a single [connection](https://www.sqlite.org/c3ref/sqlite3.html) to a SQLite database. All APIs
      * exposed by this class execute synchronously.
@@ -425,9 +447,10 @@ declare module "node:sqlite" {
          * around [`sqlite3_prepare_v2()`](https://www.sqlite.org/c3ref/prepare.html).
          * @since v22.5.0
          * @param sql A SQL string to compile to a prepared statement.
+         * @param options Optional configuration for the prepared statement.
          * @return The prepared statement.
          */
-        prepare(sql: string): StatementSync;
+        prepare(sql: string, options?: PrepareOptions): StatementSync;
         /**
          * Creates a new {@link SQLTagStore}, which is a Least Recently Used (LRU) cache
          * for storing prepared statements. This allows for the efficient reuse of
diff --git a/types/node/test.d.ts b/types/node/test.d.ts
@@ -191,6 +191,11 @@ declare module "node:test" {
             function only(name?: string, fn?: SuiteFn): Promise<void>;
             function only(options?: TestOptions, fn?: SuiteFn): Promise<void>;
             function only(fn?: SuiteFn): Promise<void>;
+            // added in v25.5.0, undocumented
+            function expectFailure(name?: string, options?: TestOptions, fn?: SuiteFn): Promise<void>;
+            function expectFailure(name?: string, fn?: SuiteFn): Promise<void>;
+            function expectFailure(options?: TestOptions, fn?: SuiteFn): Promise<void>;
+            function expectFailure(fn?: SuiteFn): Promise<void>;
         }
         /**
          * Shorthand for skipping a test. This is the same as calling {@link test} with `options.skip` set to `true`.
@@ -216,6 +221,11 @@ declare module "node:test" {
         function only(name?: string, fn?: TestFn): Promise<void>;
         function only(options?: TestOptions, fn?: TestFn): Promise<void>;
         function only(fn?: TestFn): Promise<void>;
+        // added in v25.5.0, undocumented
+        function expectFailure(name?: string, options?: TestOptions, fn?: TestFn): Promise<void>;
+        function expectFailure(name?: string, fn?: TestFn): Promise<void>;
+        function expectFailure(options?: TestOptions, fn?: TestFn): Promise<void>;
+        function expectFailure(fn?: TestFn): Promise<void>;
         /**
          * The type of a function passed to {@link test}. The first argument to this function is a {@link TestContext} object.
          * If the test uses callbacks, the callback function is passed as the second argument.
@@ -1364,6 +1374,8 @@ declare module "node:test" {
              * @since v22.2.0
              */
             plan?: number | undefined;
+            // added in v25.5.0, undocumented
+            expectFailure?: boolean | undefined;
         }
         /**
          * This function creates a hook that runs before executing a suite.
diff --git a/types/node/tls.d.ts b/types/node/tls.d.ts
@@ -210,6 +210,7 @@ declare module "node:tls" {
     interface TLSSocketEventMap extends net.SocketEventMap {
         "keylog": [line: NonSharedBuffer];
         "OCSPResponse": [response: NonSharedBuffer];
+        "secure": [];
         "secureConnect": [];
         "session": [session: NonSharedBuffer];
     }
diff --git a/types/node/v8.d.ts b/types/node/v8.d.ts
@@ -95,7 +95,7 @@ declare module "node:v8" {
      * buffers and external strings.
      *
      * `total_allocated_bytes` The value of total allocated bytes since the Isolate
-     * creation
+     * creation.
      *
      * ```js
      * {
@@ -112,7 +112,8 @@ declare module "node:v8" {
      *   number_of_detached_contexts: 0,
      *   total_global_handles_size: 8192,
      *   used_global_handles_size: 3296,
-     *   external_memory: 318824
+     *   external_memory: 318824,
+     *   total_allocated_bytes: 45224088
      * }
      * ```
      * @since v1.0.0
@@ -736,6 +737,11 @@ declare module "node:v8" {
          * @since v19.6.0, v18.15.0
          */
         stop(): GCProfilerResult;
+        /**
+         * Stop collecting GC data, and discard the profile.
+         * @since v25.5.0
+         */
+        [Symbol.dispose](): void;
     }
     interface GCProfilerResult {
         version: number;

Original file line number	Diff line number	Diff line change
`@@ -73,13 +73,23 @@ import { TextEncoder } from "node:util";`
`73`	`73`	`}`
`74`	`74`
`75`	`75`	`{`
`76`		`- new DatabaseSync(":memory:", {`
	`76`	`+ const db = new DatabaseSync(":memory:", {`
`77`	`77`	`timeout: 10_000,`
`78`	`78`	`readBigInts: true,`
`79`	`79`	`returnArrays: true,`
`80`	`80`	`allowBareNamedParameters: false,`
`81`	`81`	`allowUnknownNamedParameters: true,`
`82`	`82`	`});`
	`83`	`+`
	`84`	`+ const stmt = db.prepare("SELECT 1", {`
	`85`	`+ readBigInts: true,`
	`86`	`+ returnArrays: true,`
	`87`	`+ allowBareNamedParameters: false,`
	`88`	`+ allowUnknownNamedParameters: true,`
	`89`	`+ });`
	`90`	`+`
	`91`	`+ // $ExpectType SQLOutputValue`
	`92`	`+ stmt.get()![0];`
`83`	`93`	`}`
`84`	`94`
`85`	`95`	`{`
Original file line number	Diff line number	Diff line change
`@@ -19,11 +19,9 @@ v8.takeCoverage();`
`19`	`19`	`v8.stopCoverage();`
`20`	`20`
`21`	`21`	`{`
`22`		`- const profiler = new v8.GCProfiler();`
	`22`	`+ using profiler = new v8.GCProfiler();`
`23`	`23`	`profiler.start();`
`24`		`- setTimeout(() => {`
`25`		`- console.log(profiler.stop());`
`26`		`- }, 1000);`
	`24`	`+ profiler.stop();`
`27`	`25`	`}`
`28`	`26`
`29`	`27`	`const disable = v8.promiseHooks.createHook({`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"private": true,`
`3`	`3`	`"name": "@types/node",`
`4`		`- "version": "25.4.9999",`
	`4`	`+ "version": "25.5.9999",`
`5`	`5`	`"nonNpm": "conflict",`
`6`	`6`	`"nonNpmDescription": "Node.js",`
`7`	`7`	`"projects": [`