@zimic/interceptor 0.16.0-canary.5 → 0.16.0-canary.7

package/dist/http.d.ts

@@ -1,22 +1,4 @@
-import { HttpMethodSchema, HttpRequest, HttpHeaders, HttpRequestHeadersSchema, InferPathParams, HttpSearchParams, HttpRequestSearchParamsSchema, HttpRequestBodySchema, HttpStatusCode, HttpResponseSchema, HttpHeadersInit, HttpResponse, HttpResponseHeadersSchema, HttpResponseBodySchema, HttpSchema, HttpSchemaMethod, HttpSchemaPath, HttpHeadersSchema, HttpSearchParamsSchema, HttpBody, HttpFormData, HttpResponseSchemaStatusCode, HttpMethod, LiteralHttpSchemaPathFromNonLiteral } from '@zimic/http';
-
-/**
- * Error thrown when a value is not valid JSON. HTTP interceptors might throw this error when trying to parse the body
- * of a request or response with the header `'content-type': 'application/json'`, if the content cannot be parsed to
- * JSON.
- */
-declare class InvalidJSONError extends SyntaxError {
-    constructor(value: string);
-}
-
-/**
- * Error thrown when a value is not valid {@link https://developer.mozilla.org/docs/Web/API/FormData FormData}. HTTP
- * interceptors might throw this error when trying to parse the body of a request or response with the header
- * `'content-type': 'multipart/form-data'`, if the content cannot be parsed to form data.
- */
-declare class InvalidFormDataError extends SyntaxError {
-    constructor(value: string);
-}
+import { HttpMethodSchema, HttpRequest, HttpHeaders, HttpRequestHeadersSchema, InferPathParams, HttpSearchParams, HttpRequestSearchParamsSchema, HttpRequestBodySchema, HttpStatusCode, HttpResponseSchema, HttpHeadersInit, HttpResponse, HttpResponseHeadersSchema, HttpResponseBodySchema, HttpSchema, HttpBody, HttpSchemaMethod, HttpSchemaPath, HttpHeadersSchema, HttpSearchParamsSchema, HttpFormData, HttpResponseSchemaStatusCode, HttpMethod, LiteralHttpSchemaPathFromNonLiteral } from '@zimic/http';
 
 /**
  * An error thrown when the interceptor is running and some operation requires it to be stopped first.
@@ -54,6 +36,33 @@ declare class UnknownHttpInterceptorTypeError extends TypeError {
     constructor(unknownType: unknown);
 }
 
+/**
+ * Error thrown when the safe limit of saved intercepted requests is exceeded.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests Saving intercepted requests}
+ */
+declare class RequestSavingSafeLimitExceededError extends TypeError {
+    constructor(numberOfSavedRequests: number, safeLimit: number);
+}
+
+/**
+ * Error thrown when a value is not valid {@link https://developer.mozilla.org/docs/Web/API/FormData FormData}. HTTP
+ * interceptors might throw this error when trying to parse the body of a request or response with the header
+ * `'content-type': 'multipart/form-data'`, if the content cannot be parsed to form data.
+ */
+declare class InvalidFormDataError extends SyntaxError {
+    constructor(value: string);
+}
+
+/**
+ * Error thrown when a value is not valid JSON. HTTP interceptors might throw this error when trying to parse the body
+ * of a request or response with the header `'content-type': 'application/json'`, if the content cannot be parsed to
+ * JSON.
+ */
+declare class InvalidJSONError extends SyntaxError {
+    constructor(value: string);
+}
+
 /**
  * An error thrown when the browser mock service worker is not found.
  *
@@ -151,97 +160,6 @@ interface InterceptedHttpInterceptorRequest<Path extends string, MethodSchema ex
     response: StatusCode extends [never] ? never : HttpInterceptorResponse<MethodSchema, StatusCode>;
 }
 
-type PartialHttpHeadersOrSchema<Schema extends HttpHeadersSchema> = IfNever<Schema, never, Partial<Schema> | HttpHeaders<Partial<Schema>> | HttpHeaders<Schema>>;
-/**
- * A static headers restriction to match intercepted requests.
- *
- * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction `handler.with()` API reference}
- */
-type HttpRequestHandlerHeadersStaticRestriction<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>> = PartialHttpHeadersOrSchema<HttpRequestHeadersSchema<Default<Schema[Path][Method]>>>;
-type PartialHttpSearchParamsOrSchema<Schema extends HttpSearchParamsSchema> = IfNever<Schema, never, Partial<Schema> | HttpSearchParams<Partial<Schema>> | HttpSearchParams<Schema>>;
-/**
- * A static search params restriction to match intercepted requests.
- *
- * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction `handler.with()` API reference}
- */
-type HttpRequestHandlerSearchParamsStaticRestriction<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>> = PartialHttpSearchParamsOrSchema<HttpRequestSearchParamsSchema<Default<Schema[Path][Method]>>>;
-type PartialBodyOrSchema<Body extends HttpBody> = Body extends HttpFormData<infer Schema> ? HttpFormData<Partial<Schema>> | HttpFormData<Schema> : Body extends HttpSearchParams<infer Schema> ? HttpSearchParams<Partial<Schema>> | HttpSearchParams<Schema> : Body extends Blob ? Body : DeepPartial<Body>;
-/**
- * A static body restriction to match intercepted requests.
- *
- * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction `handler.with()` API reference}
- */
-type HttpRequestHandlerBodyStaticRestriction<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>> = PartialBodyOrSchema<HttpRequestBodySchema<Default<Schema[Path][Method]>>>;
-/**
- * A static restriction to match intercepted requests.
- *
- * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction `handler.with()` API reference}
- */
-interface HttpRequestHandlerStaticRestriction<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>> {
-    /**
-     * A set of headers that the intercepted request must contain to match the handler. If exact is `true`, the request
-     * must contain exactly these headers and no others.
-     */
-    headers?: HttpRequestHandlerHeadersStaticRestriction<Schema, Method, Path>;
-    /**
-     * A set of search params that the intercepted request must contain to match the handler. If exact is `true`, the
-     * request must contain exactly these search params and no others.
-     */
-    searchParams?: HttpRequestHandlerSearchParamsStaticRestriction<Schema, Method, Path>;
-    /**
-     * The body that the intercepted request must contain to match the handler. If exact is `true`, the request must
-     * contain exactly this body and no other.
-     */
-    body?: HttpRequestHandlerBodyStaticRestriction<Schema, Method, Path>;
-    /**
-     * If `true`, the request must contain **exactly** the headers, search params, and body declared in this restriction.
-     * Otherwise, the request must contain **at least** them.
-     */
-    exact?: boolean;
-}
-/**
- * A computed restriction to match intercepted requests.
- *
- * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction `handler.with()` API reference}
- */
-type HttpRequestHandlerComputedRestriction<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>> = (request: HttpInterceptorRequest<Path, Default<Schema[Path][Method]>>) => PossiblePromise<boolean>;
-/**
- * A restriction to match intercepted requests.
- *
- * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction `handler.with()` API reference}
- */
-type HttpRequestHandlerRestriction<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>> = HttpRequestHandlerStaticRestriction<Schema, Method, Path> | HttpRequestHandlerComputedRestriction<Schema, Method, Path>;
-interface RestrictionDiff<Value> {
-    expected: Value;
-    received: Value;
-}
-interface RestrictionDiffs {
-    computed?: RestrictionDiff<boolean>;
-    headers?: RestrictionDiff<HttpHeaders<never>>;
-    searchParams?: RestrictionDiff<HttpSearchParams<never>>;
-    body?: RestrictionDiff<unknown>;
-}
-interface UnmatchedHttpInterceptorRequestGroup {
-    request: HttpInterceptorRequest<string, never>;
-    diff: RestrictionDiffs;
-}
-
-declare class TimesDeclarationPointer extends Error {
-    constructor(minNumberOfRequests: number, maxNumberOfRequests?: number);
-}
-
-interface TimesCheckErrorOptions {
-    requestLimits: Range<number>;
-    numberOfMatchedRequests: number;
-    declarationPointer: TimesDeclarationPointer | undefined;
-    unmatchedRequestGroups: UnmatchedHttpInterceptorRequestGroup[];
-    hasRestrictions: boolean;
-    hasSavedRequests: boolean;
-}
-declare class TimesCheckError extends TypeError {
-    constructor(options: TimesCheckErrorOptions);
-}
-
 type UnhandledHttpInterceptorRequestMethodSchema = HttpSchema.Method<{
     request: {
         headers: Record<string, string>;
@@ -351,20 +269,12 @@ interface SharedHttpInterceptorOptions {
      */
     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**: 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.
+     * Configures if the intercepted requests are saved and how they are handled.
      *
-     * @default false
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests Saving intercepted requests}
      * @see {@link https://github.com/zimicjs/zimic/wiki/guides‐testing‐interceptor Testing}
      */
-    saveRequests?: boolean;
+    requestSaving?: Partial<HttpInterceptorRequestSaving>;
 }
 /**
  * The options to create a
@@ -408,6 +318,81 @@ interface RemoteHttpInterceptorOptions extends SharedHttpInterceptorOptions {
  */
 type HttpInterceptorOptions = LocalHttpInterceptorOptions | RemoteHttpInterceptorOptions;
 
+type PartialHttpHeadersOrSchema<Schema extends HttpHeadersSchema> = IfNever<Schema, never, Partial<Schema> | HttpHeaders<Partial<Schema>> | HttpHeaders<Schema>>;
+/**
+ * A static headers restriction to match intercepted requests.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction `handler.with()` API reference}
+ */
+type HttpRequestHandlerHeadersStaticRestriction<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>> = PartialHttpHeadersOrSchema<HttpRequestHeadersSchema<Default<Schema[Path][Method]>>>;
+type PartialHttpSearchParamsOrSchema<Schema extends HttpSearchParamsSchema> = IfNever<Schema, never, Partial<Schema> | HttpSearchParams<Partial<Schema>> | HttpSearchParams<Schema>>;
+/**
+ * A static search params restriction to match intercepted requests.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction `handler.with()` API reference}
+ */
+type HttpRequestHandlerSearchParamsStaticRestriction<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>> = PartialHttpSearchParamsOrSchema<HttpRequestSearchParamsSchema<Default<Schema[Path][Method]>>>;
+type PartialBodyOrSchema<Body extends HttpBody> = Body extends HttpFormData<infer Schema> ? HttpFormData<Partial<Schema>> | HttpFormData<Schema> : Body extends HttpSearchParams<infer Schema> ? HttpSearchParams<Partial<Schema>> | HttpSearchParams<Schema> : Body extends Blob ? Body : DeepPartial<Body>;
+/**
+ * A static body restriction to match intercepted requests.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction `handler.with()` API reference}
+ */
+type HttpRequestHandlerBodyStaticRestriction<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>> = PartialBodyOrSchema<HttpRequestBodySchema<Default<Schema[Path][Method]>>>;
+/**
+ * A static restriction to match intercepted requests.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction `handler.with()` API reference}
+ */
+interface HttpRequestHandlerStaticRestriction<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>> {
+    /**
+     * A set of headers that the intercepted request must contain to match the handler. If exact is `true`, the request
+     * must contain exactly these headers and no others.
+     */
+    headers?: HttpRequestHandlerHeadersStaticRestriction<Schema, Method, Path>;
+    /**
+     * A set of search params that the intercepted request must contain to match the handler. If exact is `true`, the
+     * request must contain exactly these search params and no others.
+     */
+    searchParams?: HttpRequestHandlerSearchParamsStaticRestriction<Schema, Method, Path>;
+    /**
+     * The body that the intercepted request must contain to match the handler. If exact is `true`, the request must
+     * contain exactly this body and no other.
+     */
+    body?: HttpRequestHandlerBodyStaticRestriction<Schema, Method, Path>;
+    /**
+     * If `true`, the request must contain **exactly** the headers, search params, and body declared in this restriction.
+     * Otherwise, the request must contain **at least** them.
+     */
+    exact?: boolean;
+}
+/**
+ * A computed restriction to match intercepted requests.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction `handler.with()` API reference}
+ */
+type HttpRequestHandlerComputedRestriction<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>> = (request: HttpInterceptorRequest<Path, Default<Schema[Path][Method]>>) => PossiblePromise<boolean>;
+/**
+ * A restriction to match intercepted requests.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction `handler.with()` API reference}
+ */
+type HttpRequestHandlerRestriction<Schema extends HttpSchema, Method extends HttpSchemaMethod<Schema>, Path extends HttpSchemaPath<Schema, Method>> = HttpRequestHandlerStaticRestriction<Schema, Method, Path> | HttpRequestHandlerComputedRestriction<Schema, Method, Path>;
+interface RestrictionDiff<Value> {
+    expected: Value;
+    received: Value;
+}
+interface RestrictionDiffs {
+    computed?: RestrictionDiff<boolean>;
+    headers?: RestrictionDiff<HttpHeaders<never>>;
+    searchParams?: RestrictionDiff<HttpSearchParams<never>>;
+    body?: RestrictionDiff<unknown>;
+}
+interface UnmatchedHttpInterceptorRequestGroup {
+    request: HttpInterceptorRequest<string, never>;
+    diff: RestrictionDiffs;
+}
+
 /**
  * An HTTP request handler to declare responses for intercepted requests.
  *
@@ -512,8 +497,9 @@ interface LocalHttpRequestHandler<Schema extends HttpSchema, Method extends Http
      * that was not satisfied.
      *
      * When
-     * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#createhttpinterceptoroptions `saveRequests: true`}
-     * is enabled in your interceptor, the `TimesCheckError` errors will also list each unmatched request with diff of the
+     * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests
+     * `requestSaving.enabled`} is
+     * `true` in your interceptor, the `TimesCheckError` errors will also list each unmatched request with diff of the
      * expected and received data. This is useful for debugging requests that did not match a handler with
      * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction restrictions}.
      *
@@ -541,11 +527,14 @@ interface LocalHttpRequestHandler<Schema extends HttpSchema, Method extends Http
      * The intercepted requests that matched this handler, along with the responses returned to each of them. This is
      * useful for testing that the correct requests were made by your application.
      *
-     * **Important**: This method can only be used if `saveRequests` was set to `true` when creating the interceptor. See
+     * **Important**: This method can only be used if
+     * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests
+     * `requestSaving.enabled`} is
+     * `true` in the interceptor. See
      * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests Saving intercepted requests}
      * for more information.
      *
-     * @throws {DisabledRequestSavingError} If the interceptor was not created with `saveRequests: true`.
+     * @throws {DisabledRequestSavingError} If the interceptor has `requestSaving.enabled: false`.
      * @readonly
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerrequests `handler.requests` API reference}
      */
@@ -627,8 +616,9 @@ interface SyncedRemoteHttpRequestHandler<Schema extends HttpSchema, Method exten
      * that was not satisfied.
      *
      * When
-     * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#createhttpinterceptoroptions `saveRequests: true`}
-     * is enabled in your interceptor, the `TimesCheckError` errors will also list each unmatched request with diff of the
+     * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests
+     * `requestSaving.enabled`} is
+     * true in your interceptor, the `TimesCheckError` errors will also list each unmatched request with diff of the
      * expected and received data. This is useful for debugging requests that did not match a handler with
      * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction restrictions}.
      *
@@ -656,11 +646,14 @@ interface SyncedRemoteHttpRequestHandler<Schema extends HttpSchema, Method exten
      * The intercepted requests that matched this handler, along with the responses returned to each of them. This is
      * useful for testing that the correct requests were made by your application.
      *
-     * **Important**: This method can only be used if `saveRequests` was set to `true` when creating the interceptor. See
+     * **Important**: This method can only be used if
+     * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests
+     * `requestSaving.enabled`} is
+     * `true` in the interceptor. See
      * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests Saving intercepted requests}
      * for more information.
      *
-     * @throws {DisabledRequestSavingError} If the interceptor was not created with `saveRequests: true`.
+     * @throws {DisabledRequestSavingError} If the interceptor has `requestSaving.enabled: false`.
      * @readonly
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerrequests `handler.requests` API reference}
      */
@@ -709,6 +702,43 @@ type RemoteHttpRequestHandler<Schema extends HttpSchema, Method extends HttpSche
 type SyncHttpInterceptorMethodHandler<Schema extends HttpSchema, Method extends HttpMethod> = Method extends HttpSchemaMethod<Schema> ? <Path extends HttpSchemaPath.NonLiteral<Schema, Method>>(path: Path) => LocalHttpRequestHandler<Schema, Method, LiteralHttpSchemaPathFromNonLiteral<Schema, Method, Path>> : (path: never) => LocalHttpRequestHandler<any, any, never>;
 type AsyncHttpInterceptorMethodHandler<Schema extends HttpSchema, Method extends HttpMethod> = Method extends HttpSchemaMethod<Schema> ? <Path extends HttpSchemaPath.NonLiteral<Schema, Method>>(path: Path) => RemoteHttpRequestHandler<Schema, Method, LiteralHttpSchemaPathFromNonLiteral<Schema, Method, Path>> : (path: never) => RemoteHttpRequestHandler<any, any, never>;
 
+/**
+ * Configures if the intercepted requests are saved and how they are handled.
+ *
+ * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests Saving intercepted requests}
+ * @see {@link https://github.com/zimicjs/zimic/wiki/guides‐testing‐interceptor Testing}
+ */
+interface HttpInterceptorRequestSaving {
+    /**
+     * 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`}.
+     *
+     * If you are using
+     * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorchecktimes `interceptor.checkTimes()`}
+     * or
+     * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerchecktimes `handler.checkTimes()`}
+     * during tests, consider enabling this option to get more detailed information in `TimesCheckError` errors.
+     *
+     * **Important**: If `requestSaving.enabled` is `true`, make sure to regularly clear the interceptor to avoid requests
+     * accumulating 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.
+     *
+     * @default process.env.NODE_ENV === 'test'
+     */
+    enabled: boolean;
+    /**
+     * The safe number of requests to save in memory before logging warnings in the console. If `requestSaving.enabled` is
+     * `true` and the interceptor is not regularly cleared with
+     * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-interceptorclear `interceptor.clear()`},
+     * the requests may accumulate in memory and cause performance issues. This option does not limit the number of
+     * requests saved in memory, only when to log warnings.
+     *
+     * @default 1000
+     */
+    safeLimit: number;
+}
 /**
  * An interceptor to handle HTTP requests and return mock responses. The methods, paths, status codes, parameters, and
  * responses are statically-typed based on the provided service schema.
@@ -723,20 +753,12 @@ interface HttpInterceptor<_Schema extends HttpSchema> {
      */
     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**: 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.
+     * Configures if the intercepted requests are saved and how they are handled.
      *
-     * @default process.env.NODE_ENV === 'test'
      * @see {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests Saving intercepted requests}
      * @see {@link https://github.com/zimicjs/zimic/wiki/guides‐testing‐interceptor Testing}
      */
-    saveRequests: boolean;
+    requestSaving: HttpInterceptorRequestSaving;
     /**
      * The platform the interceptor is running on.
      *
@@ -784,8 +806,9 @@ interface HttpInterceptor<_Schema extends HttpSchema> {
      * of each test.
      *
      * When
-     * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#createhttpinterceptoroptions `saveRequests: true`}
-     * is enabled in your interceptor, the `TimesCheckError` errors will also list each unmatched request with diff of the
+     * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#saving-requests
+     * `requestSaving.enabled`} is
+     * `true` in your interceptor, the `TimesCheckError` errors will also list each unmatched request with diff of the
      * expected and received data. This is useful for debugging requests that did not match a handler with
      * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#http-handlerwithrestriction restrictions}.
      *
@@ -1241,6 +1264,22 @@ interface RemoteHttpInterceptor<Schema extends HttpSchema> extends HttpIntercept
     clear: () => Promise<void>;
 }
 
+declare class TimesDeclarationPointer extends Error {
+    constructor(minNumberOfRequests: number, maxNumberOfRequests?: number);
+}
+
+interface TimesCheckErrorOptions {
+    requestLimits: Range<number>;
+    numberOfMatchedRequests: number;
+    declarationPointer: TimesDeclarationPointer | undefined;
+    unmatchedRequestGroups: UnmatchedHttpInterceptorRequestGroup[];
+    hasRestrictions: boolean;
+    requestSaving: HttpInterceptorRequestSaving;
+}
+declare class TimesCheckError extends TypeError {
+    constructor(options: TimesCheckErrorOptions);
+}
+
 /**
  * Infers the schema of an
  * {@link https://github.com/zimicjs/zimic/wiki/api‐zimic‐interceptor‐http#httpinterceptor `HttpInterceptor`}.
@@ -1285,4 +1324,4 @@ declare function createHttpInterceptor<Schema extends HttpSchema>(options: Local
 declare function createHttpInterceptor<Schema extends HttpSchema>(options: RemoteHttpInterceptorOptions): RemoteHttpInterceptor<Schema>;
 declare function createHttpInterceptor<Schema extends HttpSchema>(options: HttpInterceptorOptions): LocalHttpInterceptor<Schema> | RemoteHttpInterceptor<Schema>;
 
-export { DisabledRequestSavingError, type HttpInterceptor, type HttpInterceptorOptions, type HttpInterceptorPlatform, type HttpInterceptorRequest, type HttpInterceptorResponse, type HttpInterceptorType, type HttpRequestHandler, type HttpRequestHandlerBodyStaticRestriction, type HttpRequestHandlerComputedRestriction, type HttpRequestHandlerHeadersStaticRestriction, type HttpRequestHandlerResponseDeclaration, type HttpRequestHandlerResponseDeclarationFactory, type HttpRequestHandlerRestriction, type HttpRequestHandlerSearchParamsStaticRestriction, type HttpRequestHandlerStaticRestriction, type InferHttpInterceptorSchema, type InterceptedHttpInterceptorRequest, InvalidFormDataError, InvalidJSONError, type LocalHttpInterceptor, type LocalHttpInterceptorOptions, type LocalHttpRequestHandler, NotRunningHttpInterceptorError, type PendingRemoteHttpRequestHandler, type RemoteHttpInterceptor, type RemoteHttpInterceptorOptions, type RemoteHttpRequestHandler, RunningHttpInterceptorError, type SyncedRemoteHttpRequestHandler, TimesCheckError, type UnhandledHttpInterceptorRequest, UnhandledRequestStrategy, UnknownHttpInterceptorPlatformError, UnknownHttpInterceptorTypeError, UnregisteredBrowserServiceWorkerError, createHttpInterceptor };
+export { DisabledRequestSavingError, type HttpInterceptor, type HttpInterceptorOptions, type HttpInterceptorPlatform, type HttpInterceptorRequest, type HttpInterceptorResponse, type HttpInterceptorType, type HttpRequestHandler, type HttpRequestHandlerBodyStaticRestriction, type HttpRequestHandlerComputedRestriction, type HttpRequestHandlerHeadersStaticRestriction, type HttpRequestHandlerResponseDeclaration, type HttpRequestHandlerResponseDeclarationFactory, type HttpRequestHandlerRestriction, type HttpRequestHandlerSearchParamsStaticRestriction, type HttpRequestHandlerStaticRestriction, type InferHttpInterceptorSchema, type InterceptedHttpInterceptorRequest, InvalidFormDataError, InvalidJSONError, type LocalHttpInterceptor, type LocalHttpInterceptorOptions, type LocalHttpRequestHandler, NotRunningHttpInterceptorError, type PendingRemoteHttpRequestHandler, type RemoteHttpInterceptor, type RemoteHttpInterceptorOptions, type RemoteHttpRequestHandler, RequestSavingSafeLimitExceededError, RunningHttpInterceptorError, type SyncedRemoteHttpRequestHandler, TimesCheckError, type UnhandledHttpInterceptorRequest, UnhandledRequestStrategy, UnknownHttpInterceptorPlatformError, UnknownHttpInterceptorTypeError, UnregisteredBrowserServiceWorkerError, createHttpInterceptor };