test: add Symbol.dispose support to mock timers

PR-URL: #48549 Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Moshe Atlow <moshe@atlow.co.il> Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com> Reviewed-By: Erick Wendel <erick.workspace@gmail.com>

Author: benjamingr

doc/api/test.md

@@ -1601,6 +1601,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 = [];