@zimic/interceptor 0.15.0-canary.1 → 0.15.0-canary.3

package/dist/server.d.ts

@@ -29,14 +29,16 @@ interface InterceptorServerOptions {
  */
 interface InterceptorServer {
     /**
-     * The hostname of the server.
+     * The hostname of the server. It can be reassigned to a new value if the server is not running.
      *
+     * @throws {RunningInterceptorServerError} When trying to reassign a new hostname with the server still running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server `zimic-interceptor server` API reference}
      */
     hostname: string;
     /**
-     * The port of the server.
+     * The port of the server. It can be reassigned to a new value if the server is not running.
      *
+     * @throws {RunningInterceptorServerError} When trying to reassign a new port with the server still running.
      * @see {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server `zimic-interceptor server` API reference}
      */
     port: number | undefined;
@@ -47,18 +49,13 @@ interface InterceptorServer {
      * @see {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server `zimic-interceptor server` API reference}
      */
     logUnhandledRequests: boolean;
-    /**
-     * The HTTP URL of the server.
-     *
-     * @see {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server `zimic-interceptor server` API reference}
-     */
-    httpURL: string | undefined;
     /**
      * Whether the server is running.
      *
+     * @readonly
      * @see {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server `zimic-interceptor server` API reference}
      */
-    isRunning: boolean;
+    get isRunning(): boolean;
     /**
      * Starts the server.
      *
@@ -104,8 +101,17 @@ declare class InterceptorServerNamespace {
     create: typeof createInterceptorServer;
 }
 
+/**
+ * An error thrown when the interceptor server is running and some operation requires it to be stopped first.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐server `@zimic/interceptor/server` - API reference}
+ */
+declare class RunningInterceptorServerError extends Error {
+    constructor(additionalMessage: string);
+}
+
 /** An error thrown when the interceptor server is not running. */
-declare class NotStartedInterceptorServerError extends Error {
+declare class NotRunningInterceptorServerError extends Error {
     constructor();
 }
 
@@ -128,4 +134,4 @@ declare const DEFAULT_PREFLIGHT_STATUS_CODE = 204;
  */
 declare const interceptorServer: Readonly<InterceptorServerNamespace>;
 
-export { DEFAULT_ACCESS_CONTROL_HEADERS, DEFAULT_PREFLIGHT_STATUS_CODE, type InterceptorServer, InterceptorServerNamespace, type InterceptorServerOptions, NotStartedInterceptorServerError, interceptorServer };
+export { DEFAULT_ACCESS_CONTROL_HEADERS, DEFAULT_PREFLIGHT_STATUS_CODE, type InterceptorServer, InterceptorServerNamespace, type InterceptorServerOptions, NotRunningInterceptorServerError, RunningInterceptorServerError, interceptorServer };

package/dist/server.js

@@ -1,25 +1,29 @@
 'use strict';
 
-var chunkCWBDZYUG_js = require('./chunk-CWBDZYUG.js');
+var chunkR2ROSKU4_js = require('./chunk-R2ROSKU4.js');
 require('./chunk-WCQVDF3K.js');
 
 
 
 Object.defineProperty(exports, "DEFAULT_ACCESS_CONTROL_HEADERS", {
   enumerable: true,
-  get: function () { return chunkCWBDZYUG_js.DEFAULT_ACCESS_CONTROL_HEADERS; }
+  get: function () { return chunkR2ROSKU4_js.DEFAULT_ACCESS_CONTROL_HEADERS; }
 });
 Object.defineProperty(exports, "DEFAULT_PREFLIGHT_STATUS_CODE", {
   enumerable: true,
-  get: function () { return chunkCWBDZYUG_js.DEFAULT_PREFLIGHT_STATUS_CODE; }
+  get: function () { return chunkR2ROSKU4_js.DEFAULT_PREFLIGHT_STATUS_CODE; }
 });
-Object.defineProperty(exports, "NotStartedInterceptorServerError", {
+Object.defineProperty(exports, "NotRunningInterceptorServerError", {
   enumerable: true,
-  get: function () { return chunkCWBDZYUG_js.NotStartedInterceptorServerError_default; }
+  get: function () { return chunkR2ROSKU4_js.NotRunningInterceptorServerError_default; }
+});
+Object.defineProperty(exports, "RunningInterceptorServerError", {
+  enumerable: true,
+  get: function () { return chunkR2ROSKU4_js.RunningInterceptorServerError_default; }
 });
 Object.defineProperty(exports, "interceptorServer", {
   enumerable: true,
-  get: function () { return chunkCWBDZYUG_js.interceptorServer; }
+  get: function () { return chunkR2ROSKU4_js.interceptorServer; }
 });
 //# sourceMappingURL=server.js.map
 //# sourceMappingURL=server.js.map

package/dist/server.mjs

@@ -1,4 +1,4 @@
-export { DEFAULT_ACCESS_CONTROL_HEADERS, DEFAULT_PREFLIGHT_STATUS_CODE, NotStartedInterceptorServerError_default as NotStartedInterceptorServerError, interceptorServer } from './chunk-3O3YPVEG.mjs';
+export { DEFAULT_ACCESS_CONTROL_HEADERS, DEFAULT_PREFLIGHT_STATUS_CODE, NotRunningInterceptorServerError_default as NotRunningInterceptorServerError, RunningInterceptorServerError_default as RunningInterceptorServerError, interceptorServer } from './chunk-6TSSHQW5.mjs';
 import './chunk-CGILA3WO.mjs';
 //# sourceMappingURL=server.mjs.map
 //# sourceMappingURL=server.mjs.map

package/package.json

@@ -14,7 +14,7 @@
     "api",
     "static"
   ],
-  "version": "0.15.0-canary.1",
+  "version": "0.15.0-canary.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/zimicjs/zimic.git",
@@ -74,7 +74,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@whatwg-node/server": "0.9.70",
+    "@whatwg-node/server": "0.10.1",
     "chalk": "4.1.2",
     "execa": "9.5.2",
     "isomorphic-ws": "5.0.0",
@@ -86,21 +86,21 @@
     "bufferutil": "4.0.9"
   },
   "devDependencies": {
-    "@types/node": "^22.13.8",
-    "@types/ws": "^8.5.14",
+    "@types/node": "^22.13.10",
+    "@types/ws": "^8.18.0",
     "@types/yargs": "^17.0.33",
-    "@vitest/browser": "^3.0.7",
-    "@vitest/coverage-istanbul": "^3.0.7",
+    "@vitest/browser": "^3.0.8",
+    "@vitest/coverage-istanbul": "^3.0.8",
     "dotenv-cli": "^8.0.0",
-    "eslint": "^9.21.0",
-    "playwright": "^1.50.1",
+    "eslint": "^9.22.0",
+    "playwright": "^1.51.0",
     "tsup": "^8.4.0",
     "typescript": "^5.8.2",
-    "vitest": "^3.0.7",
-    "@zimic/eslint-config-node": "0.0.0",
-    "@zimic/lint-staged-config": "0.0.0",
+    "vitest": "^3.0.8",
+    "@zimic/utils": "0.0.0",
     "@zimic/tsconfig": "0.0.0",
-    "@zimic/utils": "0.0.0"
+    "@zimic/lint-staged-config": "0.0.0",
+    "@zimic/eslint-config-node": "0.0.0"
   },
   "peerDependencies": {
     "@zimic/http": "^0.1.0 || ^0.1.0-canary.0",

package/src/cli/server/start.ts

@@ -59,7 +59,7 @@ async function startInterceptorServer({
 
   await server.start();
 
-  logWithPrefix(`${ephemeral ? 'Ephemeral s' : 'S'}erver is running on ${server.httpURL}`);
+  logWithPrefix(`${ephemeral ? 'Ephemeral s' : 'S'}erver is running on ${server.hostname}:${server.port}`);
 
   if (onReady) {
     try {

package/src/http/index.ts

@@ -1,11 +1,9 @@
-import { HttpMethodSchema, HttpStatusCode } from '@zimic/http';
-
 import HttpInterceptorNamespace from './namespace/HttpInterceptorNamespace';
-import { InterceptedHttpInterceptorRequest } from './requestHandler/types/requests';
 
 export { default as InvalidJSONError } from './interceptorWorker/errors/InvalidJSONError';
 export { default as InvalidFormDataError } from './interceptorWorker/errors/InvalidFormDataError';
-export { default as NotStartedHttpInterceptorError } from './interceptor/errors/NotStartedHttpInterceptorError';
+export { default as RunningHttpInterceptorError } from './interceptor/errors/RunningHttpInterceptorError';
+export { default as NotRunningHttpInterceptorError } from './interceptor/errors/NotRunningHttpInterceptorError';
 export { default as UnknownHttpInterceptorPlatformError } from './interceptor/errors/UnknownHttpInterceptorPlatformError';
 export { default as UnknownHttpInterceptorTypeError } from './interceptor/errors/UnknownHttpInterceptorTypeError';
 export { default as UnregisteredBrowserServiceWorkerError } from './interceptorWorker/errors/UnregisteredBrowserServiceWorkerError';
@@ -20,16 +18,6 @@ export type {
   InterceptedHttpInterceptorRequest,
 } from './requestHandler/types/requests';
 
-/**
- * @deprecated This type was renamed to {@link InterceptedHttpInterceptorRequest `InterceptedHttpInterceptorRequest`}.
- *   Please use it instead.
- */
-export type TrackedHttpInterceptorRequest<
-  Path extends string,
-  MethodSchema extends HttpMethodSchema,
-  StatusCode extends HttpStatusCode = never,
-> = InterceptedHttpInterceptorRequest<Path, MethodSchema, StatusCode>;
-
 export type {
   LocalHttpRequestHandler,
   RemoteHttpRequestHandler,

package/src/http/interceptor/HttpInterceptorClient.ts

@@ -9,7 +9,9 @@ import {
 } from '@zimic/http';
 import { Default, PossiblePromise } from '@zimic/utils/types';
 import createRegExpFromURL from '@zimic/utils/url/createRegExpFromURL';
+import excludeURLParams from '@zimic/utils/url/excludeURLParams';
 import joinURL from '@zimic/utils/url/joinURL';
+import validateURLProtocol from '@zimic/utils/url/validateURLProtocol';
 
 import HttpInterceptorWorker from '../interceptorWorker/HttpInterceptorWorker';
 import LocalHttpInterceptorWorker from '../interceptorWorker/LocalHttpInterceptorWorker';
@@ -18,7 +20,8 @@ import LocalHttpRequestHandler from '../requestHandler/LocalHttpRequestHandler';
 import RemoteHttpRequestHandler from '../requestHandler/RemoteHttpRequestHandler';
 import { HttpRequestHandler, InternalHttpRequestHandler } from '../requestHandler/types/public';
 import { HttpInterceptorRequest } from '../requestHandler/types/requests';
-import NotStartedHttpInterceptorError from './errors/NotStartedHttpInterceptorError';
+import NotRunningHttpInterceptorError from './errors/NotRunningHttpInterceptorError';
+import RunningHttpInterceptorError from './errors/RunningHttpInterceptorError';
 import HttpInterceptorStore from './HttpInterceptorStore';
 import { UnhandledRequestStrategy } from './types/options';
 import { HttpInterceptorRequestContext } from './types/requests';
@@ -32,10 +35,14 @@ class HttpInterceptorClient<
   private worker: HttpInterceptorWorker;
   private store: HttpInterceptorStore;
 
-  private _baseURL: URL;
+  private _baseURL!: URL;
+  private _saveRequests = false;
+
+  onUnhandledRequest?: HandlerConstructor extends typeof LocalHttpRequestHandler
+    ? UnhandledRequestStrategy.Local
+    : UnhandledRequestStrategy.Remote;
+
   isRunning = false;
-  onUnhandledRequest?: UnhandledRequestStrategy;
-  shouldSaveRequests = false;
 
   private Handler: HandlerConstructor;
 
@@ -55,26 +62,51 @@ class HttpInterceptorClient<
     worker: HttpInterceptorWorker;
     store: HttpInterceptorStore;
     baseURL: URL;
-    Handler: HandlerConstructor;
-    onUnhandledRequest?: UnhandledRequestStrategy;
     saveRequests?: boolean;
+    onUnhandledRequest?: UnhandledRequestStrategy;
+    Handler: HandlerConstructor;
   }) {
     this.worker = options.worker;
     this.store = options.store;
-    this._baseURL = options.baseURL;
+
+    this.baseURL = options.baseURL;
+    this._saveRequests = options.saveRequests ?? false;
+    this.onUnhandledRequest = options.onUnhandledRequest satisfies
+      | UnhandledRequestStrategy
+      | undefined as this['onUnhandledRequest'];
+
     this.Handler = options.Handler;
-    this.onUnhandledRequest = options.onUnhandledRequest;
-    this.shouldSaveRequests = options.saveRequests ?? false;
   }
 
-  get baseURLAsString() {
-    const baseURL = this._baseURL;
+  get baseURL() {
+    return this._baseURL;
+  }
 
-    if (baseURL.href === `${baseURL.origin}/`) {
-      return baseURL.origin;
+  set baseURL(newBaseURL: URL) {
+    if (this.isRunning) {
+      throw new RunningHttpInterceptorError(
+        'Did you forget to call `await interceptor.stop()` before changing the base URL?',
+      );
     }
 
-    return baseURL.href;
+    validateURLProtocol(newBaseURL, SUPPORTED_BASE_URL_PROTOCOLS);
+    excludeURLParams(newBaseURL);
+    this._baseURL = newBaseURL;
+  }
+
+  get baseURLAsString() {
+    if (this.baseURL.href === `${this.baseURL.origin}/`) {
+      return this.baseURL.origin;
+    }
+    return this.baseURL.href;
+  }
+
+  get saveRequests() {
+    return this._saveRequests;
+  }
+
+  set saveRequests(saveRequests: boolean) {
+    this._saveRequests = saveRequests;
   }
 
   get platform() {
@@ -102,7 +134,7 @@ class HttpInterceptorClient<
     if (this.worker instanceof LocalHttpInterceptorWorker) {
       this.store.markLocalInterceptorAsRunning(this, isRunning);
     } else {
-      this.store.markRemoteInterceptorAsRunning(this, isRunning, this._baseURL);
+      this.store.markRemoteInterceptorAsRunning(this, isRunning, this.baseURL);
     }
     this.isRunning = isRunning;
   }
@@ -111,7 +143,7 @@ class HttpInterceptorClient<
     if (this.worker instanceof LocalHttpInterceptorWorker) {
       return this.store.numberOfRunningLocalInterceptors;
     } else {
-      return this.store.numberOfRunningRemoteInterceptors(this._baseURL);
+      return this.store.numberOfRunningRemoteInterceptors(this.baseURL);
     }
   }
 
@@ -148,7 +180,7 @@ class HttpInterceptorClient<
     Path extends HttpSchemaPath<Schema, Method>,
   >(method: Method, path: Path): HttpRequestHandler<Schema, Method, Path> {
     if (!this.isRunning) {
-      throw new NotStartedHttpInterceptorError();
+      throw new NotRunningHttpInterceptorError();
     }
 
     const handler = new this.Handler<Schema, Method, Path>(this as SharedHttpInterceptorClient<Schema>, method, path);
@@ -214,7 +246,7 @@ class HttpInterceptorClient<
     const responseDeclaration = await matchedHandler.applyResponseDeclaration(parsedRequest);
     const response = HttpInterceptorWorker.createResponseFromDeclaration(request, responseDeclaration);
 
-    if (this.shouldSaveRequests) {
+    if (this._saveRequests) {
       const responseClone = response.clone();
 
       const parsedResponse = await HttpInterceptorWorker.parseRawResponse<
@@ -265,7 +297,7 @@ class HttpInterceptorClient<
 
   clear(options: { onCommitSuccess?: () => void; onCommitError?: () => void } = {}) {
     if (!this.isRunning) {
-      throw new NotStartedHttpInterceptorError();
+      throw new NotRunningHttpInterceptorError();
     }
 
     const clearResults: PossiblePromise<AnyHttpRequestHandlerClient | void>[] = [];

package/src/http/interceptor/LocalHttpInterceptor.ts

@@ -1,31 +1,23 @@
 import { HttpSchema, HttpSchemaMethod, HttpSchemaPath } from '@zimic/http';
-import excludeURLParams from '@zimic/utils/url/excludeURLParams';
-import validateURLProtocol from '@zimic/utils/url/validateURLProtocol';
 
 import LocalHttpRequestHandler from '../requestHandler/LocalHttpRequestHandler';
-import HttpInterceptorClient, { SUPPORTED_BASE_URL_PROTOCOLS } from './HttpInterceptorClient';
+import HttpInterceptorClient from './HttpInterceptorClient';
 import HttpInterceptorStore from './HttpInterceptorStore';
 import { SyncHttpInterceptorMethodHandler } from './types/handlers';
 import { LocalHttpInterceptorOptions } from './types/options';
 import { LocalHttpInterceptor as PublicLocalHttpInterceptor } from './types/public';
 
 class LocalHttpInterceptor<Schema extends HttpSchema> implements PublicLocalHttpInterceptor<Schema> {
-  readonly type: 'local';
-
   private store = new HttpInterceptorStore();
 
-  client: HttpInterceptorClient<Schema>;
+  client: HttpInterceptorClient<Schema, typeof LocalHttpRequestHandler>;
 
   constructor(options: LocalHttpInterceptorOptions) {
-    this.type = options.type;
-
     const baseURL = new URL(options.baseURL);
-    validateURLProtocol(baseURL, SUPPORTED_BASE_URL_PROTOCOLS);
-    excludeURLParams(baseURL);
 
     const worker = this.store.getOrCreateLocalWorker({});
 
-    this.client = new HttpInterceptorClient<Schema>({
+    this.client = new HttpInterceptorClient<Schema, typeof LocalHttpRequestHandler>({
       worker,
       store: this.store,
       baseURL,
@@ -35,10 +27,34 @@ class LocalHttpInterceptor<Schema extends HttpSchema> implements PublicLocalHttp
     });
   }
 
+  get type() {
+    return 'local' as const;
+  }
+
   get baseURL() {
     return this.client.baseURLAsString;
   }
 
+  set baseURL(baseURL: LocalHttpInterceptorOptions['baseURL']) {
+    this.client.baseURL = new URL(baseURL);
+  }
+
+  get saveRequests() {
+    return this.client.saveRequests;
+  }
+
+  set saveRequests(saveRequests: NonNullable<LocalHttpInterceptorOptions['saveRequests']>) {
+    this.client.saveRequests = saveRequests;
+  }
+
+  get onUnhandledRequest() {
+    return this.client.onUnhandledRequest;
+  }
+
+  set onUnhandledRequest(onUnhandledRequest: LocalHttpInterceptorOptions['onUnhandledRequest']) {
+    this.client.onUnhandledRequest = onUnhandledRequest;
+  }
+
   get platform() {
     return this.client.platform;
   }

package/src/http/interceptor/RemoteHttpInterceptor.ts

@@ -1,30 +1,21 @@
 import { HttpSchema, HttpSchemaMethod, HttpSchemaPath } from '@zimic/http';
-import excludeURLParams from '@zimic/utils/url/excludeURLParams';
-import validateURLProtocol from '@zimic/utils/url/validateURLProtocol';
 
 import RemoteHttpRequestHandler from '../requestHandler/RemoteHttpRequestHandler';
-import HttpInterceptorClient, { SUPPORTED_BASE_URL_PROTOCOLS } from './HttpInterceptorClient';
+import HttpInterceptorClient from './HttpInterceptorClient';
 import HttpInterceptorStore from './HttpInterceptorStore';
 import { AsyncHttpInterceptorMethodHandler } from './types/handlers';
 import { RemoteHttpInterceptorOptions } from './types/options';
 import { RemoteHttpInterceptor as PublicRemoteHttpInterceptor } from './types/public';
 
 class RemoteHttpInterceptor<Schema extends HttpSchema> implements PublicRemoteHttpInterceptor<Schema> {
-  readonly type: 'remote';
-
   private store = new HttpInterceptorStore();
 
   client: HttpInterceptorClient<Schema, typeof RemoteHttpRequestHandler>;
 
   constructor(options: RemoteHttpInterceptorOptions) {
-    this.type = options.type;
-
     const baseURL = new URL(options.baseURL);
-    validateURLProtocol(baseURL, SUPPORTED_BASE_URL_PROTOCOLS);
-    excludeURLParams(baseURL);
 
     const serverURL = new URL(baseURL.origin);
-
     const worker = this.store.getOrCreateRemoteWorker({ serverURL });
 
     this.client = new HttpInterceptorClient<Schema, typeof RemoteHttpRequestHandler>({
@@ -37,10 +28,34 @@ class RemoteHttpInterceptor<Schema extends HttpSchema> implements PublicRemoteHt
     });
   }
 
+  get type() {
+    return 'remote' as const;
+  }
+
   get baseURL() {
     return this.client.baseURLAsString;
   }
 
+  set baseURL(baseURL: string) {
+    this.client.baseURL = new URL(baseURL);
+  }
+
+  get saveRequests() {
+    return this.client.saveRequests;
+  }
+
+  set saveRequests(saveRequests: NonNullable<RemoteHttpInterceptorOptions['saveRequests']>) {
+    this.client.saveRequests = saveRequests;
+  }
+
+  get onUnhandledRequest() {
+    return this.client.onUnhandledRequest;
+  }
+
+  set onUnhandledRequest(onUnhandledRequest: RemoteHttpInterceptorOptions['onUnhandledRequest']) {
+    this.client.onUnhandledRequest = onUnhandledRequest;
+  }
+
   get platform() {
     return this.client.platform;
   }

package/src/http/interceptor/errors/{NotStartedHttpInterceptorError.ts → NotRunningHttpInterceptorError.ts}

@@ -5,11 +5,11 @@
  * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorstop `interceptor.stop()` API reference}
  * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorisrunning `interceptor.isRunning` API reference}
  */
-class NotStartedHttpInterceptorError extends Error {
+class NotRunningHttpInterceptorError extends Error {
   constructor() {
     super('Interceptor is not running. Did you forget to call `await interceptor.start()`?');
-    this.name = 'NotStartedHttpInterceptorError';
+    this.name = 'NotRunningHttpInterceptorError';
   }
 }
 
-export default NotStartedHttpInterceptorError;
+export default NotRunningHttpInterceptorError;

package/src/http/interceptor/errors/RunningHttpInterceptorError.ts

@@ -0,0 +1,15 @@
+/**
+ * An error thrown when the interceptor is running and some operation requires it to be stopped first.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorstart `interceptor.start()` API reference}
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorstop `interceptor.stop()` API reference}
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorisrunning `interceptor.isRunning` API reference}
+ */
+class RunningHttpInterceptorError extends Error {
+  constructor(additionalMessage: string) {
+    super(`The interceptor is running.${additionalMessage}`);
+    this.name = 'RunningHttpInterceptorError';
+  }
+}
+
+export default RunningHttpInterceptorError;

package/src/http/interceptor/types/options.ts

@@ -116,19 +116,17 @@ export interface SharedHttpInterceptorOptions {
    * {@link https://github.com/zimicjs/zimic/wiki/cli‐zimic‐server#zimic-server interceptor server}. It may include
    * additional paths to differentiate between conflicting mocks.
    */
-  baseURL: string | URL;
+  baseURL: string;
 
   /**
    * Whether {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httprequesthandler request handlers}
    * should save their intercepted requests in memory and make them accessible through
    * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerrequests `handler.requests`}.
    *
-   * **Important**: Saving the intercepted requests will lead to a memory leak if not accompanied by clearing of the
-   * interceptor or disposal of the handlers (i.e. garbage collection). If you plan on accessing those requests, such as
-   * to assert them in your tests, set this option to `true` and make sure to regularly clear the interceptor. A common
-   * practice is to call
+   * **Important**: If `saveRequests` is true, make sure to regularly clear the interceptor to avoid that the requests
+   * accumulate in memory. A common practice is to call
    * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorclear `interceptor.clear()`}
-   * after each test. This prevents leaking memory from the accumulated requests.
+   * after each test.
    *
    * @default false
    * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests Saving intercepted requests}