assert: move CallTracker to EOL

The `assert.CallTracker` API has been deprecateed since v20. The
`node:test` `mock.fn` API provides a better alternative for the
functionality.

PR-URL: #58006
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
Reviewed-By: Jacob Smith <jacob@frende.me>
Reviewed-By: Edy Silva <edigleyssonsilva@gmail.com>

Author: jasnell

doc/api/assert.md

@@ -215,331 +215,6 @@ try {
 }
 ```
 
-## Class: `assert.CallTracker`
-
-<!-- YAML
-added:
-  - v14.2.0
-  - v12.19.0
-changes:
-  - version: v20.1.0
-    pr-url: https://github.com/nodejs/node/pull/47740
-    description: the `assert.CallTracker` class has been deprecated and will be
-                  removed in a future version.
--->
-
-> Stability: 0 - Deprecated
-
-This feature is deprecated and will be removed in a future version.
-Please consider using alternatives such as the
-[`mock`][] helper function.
-
-### `new assert.CallTracker()`
-
-<!-- YAML
-added:
-  - v14.2.0
-  - v12.19.0
--->
-
-Creates a new [`CallTracker`][] object which can be used to track if functions
-were called a specific number of times. The `tracker.verify()` must be called
-for the verification to take place. The usual pattern would be to call it in a
-[`process.on('exit')`][] handler.
-
-```mjs
-import assert from 'node:assert';
-import process from 'node:process';
-
-const tracker = new assert.CallTracker();
-
-function func() {}
-
-// callsfunc() must be called exactly 1 time before tracker.verify().
-const callsfunc = tracker.calls(func, 1);
-
-callsfunc();
-
-// Calls tracker.verify() and verifies if all tracker.calls() functions have
-// been called exact times.
-process.on('exit', () => {
-  tracker.verify();
-});
-```
-
-```cjs
-const assert = require('node:assert');
-const process = require('node:process');
-
-const tracker = new assert.CallTracker();
-
-function func() {}
-
-// callsfunc() must be called exactly 1 time before tracker.verify().
-const callsfunc = tracker.calls(func, 1);
-
-callsfunc();
-
-// Calls tracker.verify() and verifies if all tracker.calls() functions have
-// been called exact times.
-process.on('exit', () => {
-  tracker.verify();
-});
-```
-
-### `tracker.calls([fn][, exact])`
-
-<!-- YAML
-added:
-  - v14.2.0
-  - v12.19.0
--->
-
-* `fn` {Function} **Default:** A no-op function.
-* `exact` {number} **Default:** `1`.
-* Returns: {Function} A function that wraps `fn`.
-
-The wrapper function is expected to be called exactly `exact` times. If the
-function has not been called exactly `exact` times when
-[`tracker.verify()`][] is called, then [`tracker.verify()`][] will throw an
-error.
-
-```mjs
-import assert from 'node:assert';
-
-// Creates call tracker.
-const tracker = new assert.CallTracker();
-
-function func() {}
-
-// Returns a function that wraps func() that must be called exact times
-// before tracker.verify().
-const callsfunc = tracker.calls(func);
-```
-
-```cjs
-const assert = require('node:assert');
-
-// Creates call tracker.
-const tracker = new assert.CallTracker();
-
-function func() {}
-
-// Returns a function that wraps func() that must be called exact times
-// before tracker.verify().
-const callsfunc = tracker.calls(func);
-```
-
-### `tracker.getCalls(fn)`
-
-<!-- YAML
-added:
-  - v18.8.0
-  - v16.18.0
--->
-
-* `fn` {Function}
-
-* Returns: {Array} An array with all the calls to a tracked function.
-
-* Object {Object}
-  * `thisArg` {Object}
-  * `arguments` {Array} the arguments passed to the tracked function
-
-```mjs
-import assert from 'node:assert';
-
-const tracker = new assert.CallTracker();
-
-function func() {}
-const callsfunc = tracker.calls(func);
-callsfunc(1, 2, 3);
-
-assert.deepStrictEqual(tracker.getCalls(callsfunc),
-                       [{ thisArg: undefined, arguments: [1, 2, 3] }]);
-```
-
-```cjs
-const assert = require('node:assert');
-
-// Creates call tracker.
-const tracker = new assert.CallTracker();
-
-function func() {}
-const callsfunc = tracker.calls(func);
-callsfunc(1, 2, 3);
-
-assert.deepStrictEqual(tracker.getCalls(callsfunc),
-                       [{ thisArg: undefined, arguments: [1, 2, 3] }]);
-```
-
-### `tracker.report()`
-
-<!-- YAML
-added:
-  - v14.2.0
-  - v12.19.0
--->
-
-* Returns: {Array} An array of objects containing information about the wrapper
-  functions returned by [`tracker.calls()`][].
-* Object {Object}
-  * `message` {string}
-  * `actual` {number} The actual number of times the function was called.
-  * `expected` {number} The number of times the function was expected to be
-    called.
-  * `operator` {string} The name of the function that is wrapped.
-  * `stack` {Object} A stack trace of the function.
-
-The arrays contains information about the expected and actual number of calls of
-the functions that have not been called the expected number of times.
-
-```mjs
-import assert from 'node:assert';
-
-// Creates call tracker.
-const tracker = new assert.CallTracker();
-
-function func() {}
-
-// Returns a function that wraps func() that must be called exact times
-// before tracker.verify().
-const callsfunc = tracker.calls(func, 2);
-
-// Returns an array containing information on callsfunc()
-console.log(tracker.report());
-// [
-//  {
-//    message: 'Expected the func function to be executed 2 time(s) but was
-//    executed 0 time(s).',
-//    actual: 0,
-//    expected: 2,
-//    operator: 'func',
-//    stack: stack trace
-//  }
-// ]
-```
-
-```cjs
-const assert = require('node:assert');
-
-// Creates call tracker.
-const tracker = new assert.CallTracker();
-
-function func() {}
-
-// Returns a function that wraps func() that must be called exact times
-// before tracker.verify().
-const callsfunc = tracker.calls(func, 2);
-
-// Returns an array containing information on callsfunc()
-console.log(tracker.report());
-// [
-//  {
-//    message: 'Expected the func function to be executed 2 time(s) but was
-//    executed 0 time(s).',
-//    actual: 0,
-//    expected: 2,
-//    operator: 'func',
-//    stack: stack trace
-//  }
-// ]
-```
-
-### `tracker.reset([fn])`
-
-<!-- YAML
-added:
-  - v18.8.0
-  - v16.18.0
--->
-
-* `fn` {Function} a tracked function to reset.
-
-Reset calls of the call tracker.
-If a tracked function is passed as an argument, the calls will be reset for it.
-If no arguments are passed, all tracked functions will be reset.
-
-```mjs
-import assert from 'node:assert';
-
-const tracker = new assert.CallTracker();
-
-function func() {}
-const callsfunc = tracker.calls(func);
-
-callsfunc();
-// Tracker was called once
-assert.strictEqual(tracker.getCalls(callsfunc).length, 1);
-
-tracker.reset(callsfunc);
-assert.strictEqual(tracker.getCalls(callsfunc).length, 0);
-```
-
-```cjs
-const assert = require('node:assert');
-
-const tracker = new assert.CallTracker();
-
-function func() {}
-const callsfunc = tracker.calls(func);
-
-callsfunc();
-// Tracker was called once
-assert.strictEqual(tracker.getCalls(callsfunc).length, 1);
-
-tracker.reset(callsfunc);
-assert.strictEqual(tracker.getCalls(callsfunc).length, 0);
-```
-
-### `tracker.verify()`
-
-<!-- YAML
-added:
-  - v14.2.0
-  - v12.19.0
--->
-
-Iterates through the list of functions passed to
-[`tracker.calls()`][] and will throw an error for functions that
-have not been called the expected number of times.
-
-```mjs
-import assert from 'node:assert';
-
-// Creates call tracker.
-const tracker = new assert.CallTracker();
-
-function func() {}
-
-// Returns a function that wraps func() that must be called exact times
-// before tracker.verify().
-const callsfunc = tracker.calls(func, 2);
-
-callsfunc();
-
-// Will throw an error since callsfunc() was only called once.
-tracker.verify();
-```
-
-```cjs
-const assert = require('node:assert');
-
-// Creates call tracker.
-const tracker = new assert.CallTracker();
-
-function func() {}
-
-// Returns a function that wraps func() that must be called exact times
-// before tracker.verify().
-const callsfunc = tracker.calls(func, 2);
-
-callsfunc();
-
-// Will throw an error since callsfunc() was only called once.
-tracker.verify();
-```
-
 ## `assert(value[, message])`
 
 <!-- YAML
@@ -2760,7 +2435,6 @@ assert.partialDeepStrictEqual(
 [`===` operator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Strict_equality
 [`==` operator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Equality
 [`AssertionError`]: #class-assertassertionerror
-[`CallTracker`]: #class-assertcalltracker
 [`Class`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes
 [`ERR_INVALID_RETURN_VALUE`]: errors.md#err_invalid_return_value
 [`Error.captureStackTrace`]: errors.md#errorcapturestacktracetargetobject-constructoropt
@@ -2777,9 +2451,5 @@ assert.partialDeepStrictEqual(
 [`assert.strictEqual()`]: #assertstrictequalactual-expected-message
 [`assert.throws()`]: #assertthrowsfn-error-message
 [`getColorDepth()`]: tty.md#writestreamgetcolordepthenv
-[`mock`]: test.md#mocking
-[`process.on('exit')`]: process.md#event-exit
-[`tracker.calls()`]: #trackercallsfn-exact
-[`tracker.verify()`]: #trackerverify
 [enumerable "own" properties]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Enumerability_and_ownership_of_properties
 [prototype-spec]: https://tc39.github.io/ecma262/#sec-ordinary-object-internal-methods-and-internal-slots

doc/api/deprecations.md

@@ -3570,16 +3570,17 @@ be added when a function is bound to an `AsyncResource`.
 
 <!-- YAML
 changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/00000
+    description: End-of-Life.
   - version: v20.1.0
     pr-url: https://github.com/nodejs/node/pull/47740
     description: Runtime deprecation.
 -->
 
-Type: Runtime
+Type: End-of-Life
 
-In a future version of Node.js, [`assert.CallTracker`][],
-will be removed.
-Consider using alternatives such as the [`mock`][] helper function.
+The `assert.CallTracker` API has been removed.
 
 ### DEP0174: calling `promisify` on a function that returns a `Promise`
 
@@ -3926,7 +3927,6 @@ upon `require('node:module').builtinModules`.
 [`Server.listen({fd: <number>})`]: net.md#serverlistenhandle-backlog-callback
 [`String.prototype.toWellFormed`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toWellFormed
 [`WriteStream.open()`]: fs.md#class-fswritestream
-[`assert.CallTracker`]: assert.md#class-assertcalltracker
 [`assert`]: assert.md
 [`asyncResource.runInAsyncScope()`]: async_context.md#asyncresourceruninasyncscopefn-thisarg-args
 [`buffer.subarray`]: buffer.md#bufsubarraystart-end
@@ -3988,7 +3988,6 @@ upon `require('node:module').builtinModules`.
 [`message.socket`]: http.md#messagesocket
 [`message.trailersDistinct`]: http.md#messagetrailersdistinct
 [`message.trailers`]: http.md#messagetrailers
-[`mock`]: test.md#mocking
 [`module.createRequire()`]: module.md#modulecreaterequirefilename
 [`os.networkInterfaces()`]: os.md#osnetworkinterfaces
 [`os.tmpdir()`]: os.md#ostmpdir