test: add Symbol.dispose support to mock timers

PR-URL: #48549
Reviewed-By: Colin Ihrig <[email protected]>
Reviewed-By: Moshe Atlow <[email protected]>
Reviewed-By: Antoine du Hamel <[email protected]>
Reviewed-By: Erick Wendel <[email protected]>

Author: benjamingr

doc/api/test.md

@@ -1580,6 +1580,10 @@ const { mock } = require('node:test');
 mock.timers.reset();
 ```
 
+### `timers[Symbol.dispose]()`
+
+Calls `timers.reset()`.
+
 ### `timers.tick(milliseconds)`
 
 <!-- YAML

lib/internal/test_runner/mock/mock_timers.js

@@ -13,6 +13,7 @@ const {
   FunctionPrototypeBind,
   Promise,
   SymbolAsyncIterator,
+  SymbolDispose,
   globalThis,
 } = primordials;
 const {
@@ -316,6 +317,10 @@ class MockTimers {
     this.#toggleEnableTimers(true);
   }
 
+  [SymbolDispose]() {
+    this.reset();
+  }
+
   reset() {
     // Ignore if not enabled
     if (!this.#isEnabled) return;

test/parallel/test-runner-mock-timers.js

@@ -61,6 +61,21 @@ describe('Mock Timers Test Suite', () => {
       assert.strictEqual(fn.mock.callCount(), 0);
     });
 
+    it('should reset all timers when calling Symbol.dispose', (t) => {
+      t.mock.timers.enable();
+      const fn = t.mock.fn();
+      global.setTimeout(fn, 1000);
+      // TODO(benjamingr) refactor to `using`
+      t.mock.timers[Symbol.dispose]();
+      assert.throws(() => {
+        t.mock.timers.tick(1000);
+      }, {
+        code: 'ERR_INVALID_STATE',
+      });
+
+      assert.strictEqual(fn.mock.callCount(), 0);
+    });
+
     it('should execute in order if timeout is the same', (t) => {
       t.mock.timers.enable();
       const order = [];