[node] v20.11 updates

- test_runner: Add Date to the supported mock APIs // copied from DefinitelyTyped#67035
- esm: add import.meta.dirname and import.meta.filename // changed to non-optional fields

types/node/module.d.ts

@@ -280,13 +280,13 @@ declare module "module" {
              * The directory name of the current module. This is the same as the `path.dirname()` of the `import.meta.filename`.
              * **Caveat:** only present on `file:` modules.
              */
-            dirname?: string;
+            dirname: string;
             /**
              * The full absolute path and filename of the current module, with symlinks resolved.
              * This is the same as the `url.fileURLToPath()` of the `import.meta.url`.
              * **Caveat:** only local modules support this property. Modules not using the `file:` protocol will not provide it.
              */
-            filename?: string;
+            filename: string;
             /**
              * The absolute `file:` URL of the module.
              */

types/node/test.d.ts

@@ -1012,7 +1012,12 @@ declare module "node:test" {
          */
         restore(): void;
     }
-    type Timer = "setInterval" | "clearInterval" | "setTimeout" | "clearTimeout";
+    type Timer = "setInterval" | "setTimeout" | "setImmediate" | "Date";
+
+    interface MockTimersOptions {
+        apis: Timer[];
+        now?: number | Date;
+    }
     /**
      * Mocking timers is a technique commonly used in software testing to simulate and
      * control the behavior of timers, such as `setInterval` and `setTimeout`,
@@ -1066,7 +1071,29 @@ declare module "node:test" {
          * and `globalThis` will be mocked. As well as the global `Date` object.
          * @since v20.4.0
          */
-        enable(timers?: Timer[]): void;
+        enable(options?: MockTimersOptions): void;
+        /**
+         * Sets the current Unix timestamp that will be used as reference for any mocked`Date` objects.
+         *
+         * ```js
+         * import assert from 'node:assert';
+         * import { test } from 'node:test';
+         *
+         * test('runAll functions following the given order', (context) => {
+         *   const now = Date.now();
+         *   const setTime = 1000;
+         *   // Date.now is not mocked
+         *   assert.deepStrictEqual(Date.now(), now);
+         *
+         *   context.mock.timers.enable({ apis: ['Date'] });
+         *   context.mock.timers.setTime(setTime);
+         *   // Date.now is now 1000
+         *   assert.strictEqual(Date.now(), setTime);
+         * });
+         * ```
+         * @since v20.11.0
+         */
+        setTime(time: number): void;
         /**
          * This function restores the default behavior of all mocks that were previously
          * created by this `MockTimers` instance and disassociates the mocks

types/node/test/module.ts

@@ -52,6 +52,8 @@ const entry: Module.SourceMapping = smap.findEntry(1, 1);
 // global
 {
     const importmeta: ImportMeta = {} as any; // Fake because we cannot really access the true `import.meta` with the current build target
+    importmeta.dirname; // $ExpectType string
+    importmeta.filename; // $ExpectType string
     importmeta.url; // $ExpectType string
     importmeta.resolve("local"); // $ExpectType string
     importmeta.resolve("local", "/parent"); // $ExpectType string

types/node/test/test.ts

@@ -662,10 +662,26 @@ new lcov();
 
 describe("Mock Timers Test Suite", () => {
     it((t) => {
+        t.mock.timers.enable({ apis: ["setTimeout"] });
+        // new Date suite
+        t.mock.timers.enable({ apis: ["Date"] });
+        // immediates suite
+        t.mock.timers.enable({ apis: ["setImmediate"] });
+        t.mock.timers.enable({ apis: ["setTimeout"], now: 1000 });
+        t.mock.timers.enable({ apis: ["setTimeout"], now: new Date() });
+        t.mock.timers.enable();
+        // @ts-expect-error
         t.mock.timers.enable(["setTimeout"]);
         // @ts-expect-error
-        t.mock.timers.enable(["DOES_NOT_EXIST"]);
+        t.mock.timers.enable({ apis: ["NOT_THERE"] });
         t.mock.timers.enable();
+        t.mock.timers.setTime(1000);
+        // @ts-expect-error
+        t.mock.timers.setTime("1000");
+        // @ts-expect-error
+        t.mock.timers.setTime(new Date());
+        // @ts-expect-error
+        t.mock.timers.setTime();
         t.mock.timers.reset();
         t.mock.timers.tick(1000);
     });

types/node/ts4.8/module.d.ts

@@ -280,13 +280,13 @@ declare module "module" {
              * The directory name of the current module. This is the same as the `path.dirname()` of the `import.meta.filename`.
              * **Caveat:** only present on `file:` modules.
              */
-            dirname?: string;
+            dirname: string;
             /**
              * The full absolute path and filename of the current module, with symlinks resolved.
              * This is the same as the `url.fileURLToPath()` of the `import.meta.url`.
              * **Caveat:** only local modules support this property. Modules not using the `file:` protocol will not provide it.
              */
-            filename?: string;
+            filename: string;
             /**
              * The absolute `file:` URL of the module.
              */

types/node/ts4.8/test.d.ts

@@ -1012,7 +1012,12 @@ declare module "node:test" {
          */
         restore(): void;
     }
-    type Timer = "setInterval" | "clearInterval" | "setTimeout" | "clearTimeout";
+    type Timer = "setInterval" | "setTimeout" | "setImmediate" | "Date";
+
+    interface MockTimersOptions {
+        apis: Timer[];
+        now?: number | Date;
+    }
     /**
      * Mocking timers is a technique commonly used in software testing to simulate and
      * control the behavior of timers, such as `setInterval` and `setTimeout`,
@@ -1066,7 +1071,29 @@ declare module "node:test" {
          * and `globalThis` will be mocked. As well as the global `Date` object.
          * @since v20.4.0
          */
-        enable(timers?: Timer[]): void;
+        enable(options?: MockTimersOptions): void;
+        /**
+         * Sets the current Unix timestamp that will be used as reference for any mocked`Date` objects.
+         *
+         * ```js
+         * import assert from 'node:assert';
+         * import { test } from 'node:test';
+         *
+         * test('runAll functions following the given order', (context) => {
+         *   const now = Date.now();
+         *   const setTime = 1000;
+         *   // Date.now is not mocked
+         *   assert.deepStrictEqual(Date.now(), now);
+         *
+         *   context.mock.timers.enable({ apis: ['Date'] });
+         *   context.mock.timers.setTime(setTime);
+         *   // Date.now is now 1000
+         *   assert.strictEqual(Date.now(), setTime);
+         * });
+         * ```
+         * @since v20.11.0
+         */
+        setTime(time: number): void;
         /**
          * This function restores the default behavior of all mocks that were previously
          * created by this `MockTimers` instance and disassociates the mocks

types/node/ts4.8/test/module.ts

@@ -52,6 +52,8 @@ const entry: Module.SourceMapping = smap.findEntry(1, 1);
 // global
 {
     const importmeta: ImportMeta = {} as any; // Fake because we cannot really access the true `import.meta` with the current build target
+    importmeta.dirname; // $ExpectType string
+    importmeta.filename; // $ExpectType string
     importmeta.url; // $ExpectType string
     importmeta.resolve("local"); // $ExpectType string
     importmeta.resolve("local", "/parent"); // $ExpectType string

types/node/ts4.8/test/test.ts

@@ -1,6 +1,6 @@
 import { Transform, TransformCallback, TransformOptions } from "node:stream";
 import { after, afterEach, before, beforeEach, describe, it, Mock, mock, only, run, skip, test, todo } from "node:test";
-import { dot, junit, spec, tap, TestEvent } from "node:test/reporters";
+import { dot, junit, lcov, spec, tap, TestEvent } from "node:test/reporters";
 
 // run without options
 // $ExpectType TestsStream
@@ -657,13 +657,31 @@ new spec();
 junit();
 // $ExpectType AsyncGenerator<string, void, unknown>
 junit("" as any);
+// $ExpectType Lcov
+new lcov();
 
 describe("Mock Timers Test Suite", () => {
     it((t) => {
+        t.mock.timers.enable({ apis: ["setTimeout"] });
+        // new Date suite
+        t.mock.timers.enable({ apis: ["Date"] });
+        // immediates suite
+        t.mock.timers.enable({ apis: ["setImmediate"] });
+        t.mock.timers.enable({ apis: ["setTimeout"], now: 1000 });
+        t.mock.timers.enable({ apis: ["setTimeout"], now: new Date() });
+        t.mock.timers.enable();
+        // @ts-expect-error
         t.mock.timers.enable(["setTimeout"]);
         // @ts-expect-error
-        t.mock.timers.enable(["DOES_NOT_EXIST"]);
+        t.mock.timers.enable({ apis: ["NOT_THERE"] });
         t.mock.timers.enable();
+        t.mock.timers.setTime(1000);
+        // @ts-expect-error
+        t.mock.timers.setTime("1000");
+        // @ts-expect-error
+        t.mock.timers.setTime(new Date());
+        // @ts-expect-error
+        t.mock.timers.setTime();
         t.mock.timers.reset();
         t.mock.timers.tick(1000);
     });