@angular/common 17.0.0-next.7 → 17.0.0-rc.0

package/http/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v17.0.0-next.7
+ * @license Angular v17.0.0-rc.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -24,7 +24,6 @@ import { XhrFactory } from '@angular/common';
  * @see {@link HttpHandler}
  *
  * @publicApi
- * @developerPreview
  */
 export declare class FetchBackend implements HttpBackend {
     private readonly fetchImpl;
@@ -148,6 +147,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'arraybuffer';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<ArrayBuffer>;
     /**
      * Constructs a request that interprets the body as a blob and returns
@@ -172,6 +174,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'blob';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<Blob>;
     /**
      * Constructs a request that interprets the body as a text string and
@@ -196,6 +201,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<string>;
     /**
      * Constructs a request that interprets the body as an `ArrayBuffer` and returns the
@@ -221,6 +229,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'arraybuffer';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<ArrayBuffer>>;
     /**
      * Constructs a request that interprets the body as a `Blob` and returns
@@ -246,6 +257,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'blob';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<Blob>>;
     /**
      * Constructs a request which interprets the body as a text string and returns the full event
@@ -271,6 +285,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<string>>;
     /**
      * Constructs a request which interprets the body as a JavaScript object and returns the full
@@ -296,6 +313,9 @@ export declare class HttpClient {
         };
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<any>>;
     /**
      * Constructs a request which interprets the body as a JavaScript object and returns the full
@@ -321,6 +341,9 @@ export declare class HttpClient {
         };
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<R>>;
     /**
      * Constructs a request which interprets the body as an `ArrayBuffer`
@@ -345,6 +368,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'arraybuffer';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<ArrayBuffer>>;
     /**
      * Constructs a request which interprets the body as a `Blob` and returns the full `HttpResponse`.
@@ -368,6 +394,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'blob';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<Blob>>;
     /**
      * Constructs a request which interprets the body as a text stream and returns the full
@@ -392,6 +421,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<string>>;
     /**
      * Constructs a request which interprets the body as a JavaScript object and returns the full
@@ -441,6 +473,9 @@ export declare class HttpClient {
         };
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<R>>;
     /**
      * Constructs a request which interprets the body as a JavaScript object and returns the full
@@ -465,6 +500,9 @@ export declare class HttpClient {
         responseType?: 'json';
         reportProgress?: boolean;
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<Object>;
     /**
      * Constructs a request which interprets the body as a JavaScript object
@@ -489,6 +527,9 @@ export declare class HttpClient {
         responseType?: 'json';
         reportProgress?: boolean;
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<R>;
     /**
      * Constructs a request where response type and requested observable are not known statically.
@@ -512,6 +553,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'arraybuffer' | 'blob' | 'json' | 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<any>;
     /**
      * Constructs a `DELETE` request that interprets the body as an `ArrayBuffer`
@@ -885,6 +929,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'arraybuffer';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<ArrayBuffer>;
     /**
      * Constructs a `GET` request that interprets the body as a `Blob`
@@ -907,6 +954,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'blob';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<Blob>;
     /**
      * Constructs a `GET` request that interprets the body as a text string
@@ -929,6 +979,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<string>;
     /**
      * Constructs a `GET` request that interprets the body as an `ArrayBuffer` and returns
@@ -952,6 +1005,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'arraybuffer';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<ArrayBuffer>>;
     /**
      * Constructs a `GET` request that interprets the body as a `Blob` and
@@ -974,6 +1030,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'blob';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<Blob>>;
     /**
      * Constructs a `GET` request that interprets the body as a text string and returns
@@ -996,6 +1055,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<string>>;
     /**
      * Constructs a `GET` request that interprets the body as JSON
@@ -1018,6 +1080,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<Object>>;
     /**
      * Constructs a `GET` request that interprets the body as JSON and returns the full
@@ -1040,6 +1105,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<T>>;
     /**
      * Constructs a `GET` request that interprets the body as an `ArrayBuffer` and
@@ -1063,6 +1131,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'arraybuffer';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<ArrayBuffer>>;
     /**
      * Constructs a `GET` request that interprets the body as a `Blob` and
@@ -1086,6 +1157,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'blob';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<Blob>>;
     /**
      * Constructs a `GET` request that interprets the body as a text stream and
@@ -1109,6 +1183,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<string>>;
     /**
      * Constructs a `GET` request that interprets the body as JSON and
@@ -1132,6 +1209,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<Object>>;
     /**
      * Constructs a `GET` request that interprets the body as JSON and
@@ -1155,6 +1235,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<T>>;
     /**
      * Constructs a `GET` request that interprets the body as JSON and
@@ -1178,6 +1261,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<Object>;
     /**
      * Constructs a `GET` request that interprets the body as JSON and returns
@@ -1200,6 +1286,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<T>;
     /**
      * Constructs a `HEAD` request that interprets the body as an `ArrayBuffer` and
@@ -1222,6 +1311,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'arraybuffer';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<ArrayBuffer>;
     /**
      * Constructs a `HEAD` request that interprets the body as a `Blob` and returns
@@ -1244,6 +1336,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'blob';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<Blob>;
     /**
      * Constructs a `HEAD` request that interprets the body as a text string and returns the response
@@ -1266,6 +1361,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<string>;
     /**
      * Constructs a `HEAD` request that interprets the body as an  `ArrayBuffer`
@@ -1289,6 +1387,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'arraybuffer';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<ArrayBuffer>>;
     /**
      * Constructs a `HEAD` request that interprets the body as a `Blob` and
@@ -1312,6 +1413,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'blob';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<Blob>>;
     /**
      * Constructs a `HEAD` request that interprets the body as a text string
@@ -1335,6 +1439,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<string>>;
     /**
      * Constructs a `HEAD` request that interprets the body as JSON
@@ -1358,6 +1465,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<Object>>;
     /**
      * Constructs a `HEAD` request that interprets the body as JSON and
@@ -1381,6 +1491,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<T>>;
     /**
      * Constructs a `HEAD` request that interprets the body as an `ArrayBuffer`
@@ -1404,6 +1517,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'arraybuffer';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<ArrayBuffer>>;
     /**
      * Constructs a `HEAD` request that interprets the body as a `Blob` and returns
@@ -1427,6 +1543,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'blob';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<Blob>>;
     /**
      * Constructs a `HEAD` request that interprets the body as text stream
@@ -1450,6 +1569,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<string>>;
     /**
      * Constructs a `HEAD` request that interprets the body as JSON and
@@ -1473,6 +1595,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<Object>>;
     /**
      * Constructs a `HEAD` request that interprets the body as JSON
@@ -1496,6 +1621,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<T>>;
     /**
 
@@ -1519,6 +1647,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<Object>;
     /**
      * Constructs a `HEAD` request that interprets the body as JSON and returns
@@ -1542,6 +1673,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<T>;
     /**
      * Constructs a `JSONP` request for the given URL and name of the callback parameter.
@@ -2285,6 +2419,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'arraybuffer';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<ArrayBuffer>;
     /**
      * Constructs a `POST` request that interprets the body as a `Blob` and returns the
@@ -2308,6 +2445,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'blob';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<Blob>;
     /**
      * Constructs a `POST` request that interprets the body as a text string and
@@ -2331,6 +2471,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<string>;
     /**
      * Constructs a `POST` request that interprets the body as an `ArrayBuffer` and
@@ -2355,6 +2498,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'arraybuffer';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<ArrayBuffer>>;
     /**
      * Constructs a `POST` request that interprets the body as a `Blob`
@@ -2378,6 +2524,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'blob';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<Blob>>;
     /**
      * Constructs a `POST` request that interprets the body as a text string and returns the full
@@ -2402,6 +2551,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<string>>;
     /**
      * Constructs a POST request that interprets the body as JSON and returns the full
@@ -2426,6 +2578,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<Object>>;
     /**
      * Constructs a POST request that interprets the body as JSON and returns the full
@@ -2450,6 +2605,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpEvent<T>>;
     /**
      * Constructs a POST request that interprets the body as an `ArrayBuffer`
@@ -2474,6 +2632,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'arraybuffer';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<ArrayBuffer>>;
     /**
      * Constructs a `POST` request that interprets the body as a `Blob` and returns the full
@@ -2498,6 +2659,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'blob';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<Blob>>;
     /**
      * Constructs a `POST` request that interprets the body as a text stream and returns
@@ -2522,6 +2686,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType: 'text';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<string>>;
     /**
      * Constructs a `POST` request that interprets the body as JSON
@@ -2546,6 +2713,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<Object>>;
     /**
      * Constructs a `POST` request that interprets the body as JSON and returns the
@@ -2571,6 +2741,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<HttpResponse<T>>;
     /**
      * Constructs a `POST` request that interprets the body as JSON
@@ -2594,6 +2767,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<Object>;
     /**
      * Constructs a `POST` request that interprets the body as JSON
@@ -2618,6 +2794,9 @@ export declare class HttpClient {
         reportProgress?: boolean;
         responseType?: 'json';
         withCredentials?: boolean;
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     }): Observable<T>;
     /**
      * Constructs a `PUT` request that interprets the body as an `ArrayBuffer` and returns the
@@ -3703,15 +3882,59 @@ export declare class HttpRequest<T> {
      * The outgoing URL with all URL parameters set.
      */
     readonly urlWithParams: string;
-    constructor(method: 'DELETE' | 'GET' | 'HEAD' | 'JSONP' | 'OPTIONS', url: string, init?: {
+    /**
+     * The HttpTransferCache option for the request
+     */
+    readonly transferCache?: {
+        includeHeaders?: string[];
+    } | boolean;
+    constructor(method: 'GET' | 'HEAD', url: string, init?: {
+        headers?: HttpHeaders;
+        context?: HttpContext;
+        reportProgress?: boolean;
+        params?: HttpParams;
+        responseType?: 'arraybuffer' | 'blob' | 'json' | 'text';
+        withCredentials?: boolean;
+        /**
+         * This property accepts either a boolean to enable/disable transferring cache for eligible
+         * requests performed using `HttpClient`, or an object, which allows to configure cache
+         * parameters, such as which headers should be included (no headers are included by default).
+         *
+         * Setting this property will override the options passed to `provideClientHydration()` for this
+         * particular request
+         */
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
+    });
+    constructor(method: 'DELETE' | 'JSONP' | 'OPTIONS', url: string, init?: {
+        headers?: HttpHeaders;
+        context?: HttpContext;
+        reportProgress?: boolean;
+        params?: HttpParams;
+        responseType?: 'arraybuffer' | 'blob' | 'json' | 'text';
+        withCredentials?: boolean;
+    });
+    constructor(method: 'POST', url: string, body: T | null, init?: {
         headers?: HttpHeaders;
         context?: HttpContext;
         reportProgress?: boolean;
         params?: HttpParams;
         responseType?: 'arraybuffer' | 'blob' | 'json' | 'text';
         withCredentials?: boolean;
+        /**
+         * This property accepts either a boolean to enable/disable transferring cache for eligible
+         * requests performed using `HttpClient`, or an object, which allows to configure cache
+         * parameters, such as which headers should be included (no headers are included by default).
+         *
+         * Setting this property will override the options passed to `provideClientHydration()` for this
+         * particular request
+         */
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     });
-    constructor(method: 'POST' | 'PUT' | 'PATCH', url: string, body: T | null, init?: {
+    constructor(method: 'PUT' | 'PATCH', url: string, body: T | null, init?: {
         headers?: HttpHeaders;
         context?: HttpContext;
         reportProgress?: boolean;
@@ -3726,6 +3949,17 @@ export declare class HttpRequest<T> {
         params?: HttpParams;
         responseType?: 'arraybuffer' | 'blob' | 'json' | 'text';
         withCredentials?: boolean;
+        /**
+         * This property accepts either a boolean to enable/disable transferring cache for eligible
+         * requests performed using `HttpClient`, or an object, which allows to configure cache
+         * parameters, such as which headers should be included (no headers are included by default).
+         *
+         * Setting this property will override the options passed to `provideClientHydration()` for this
+         * particular request
+         */
+        transferCache?: {
+            includeHeaders?: string[];
+        } | boolean;
     });
     /**
      * Transform the free-form body into a serialized format suitable for
@@ -3945,6 +4179,25 @@ export declare const enum HttpStatusCode {
     NetworkAuthenticationRequired = 511
 }
 
+/**
+ * Options to configure how TransferCache should be used to cache requests made via HttpClient.
+ *
+ * @param includeHeaders Specifies which headers should be included into cached responses. No
+ *     headers are included by default.
+ * @param filter A function that receives a request as an argument and returns a boolean to indicate
+ *     whether a request should be included into the cache.
+ * @param includePostRequests Enables caching for POST requests. By default, only GET and HEAD
+ *     requests are cached. This option can be enabled if POST requests are used to retrieve data
+ *     (for example using GraphQL).
+ *
+ * @publicApi
+ */
+export declare type HttpTransferCacheOptions = {
+    includeHeaders?: string[];
+    filter?: (req: HttpRequest<unknown>) => boolean;
+    includePostRequests?: boolean;
+};
+
 /**
  * An upload progress event.
  *
@@ -4113,6 +4366,19 @@ export declare class JsonpInterceptor {
  * feature functions to `provideHttpClient`. For example, HTTP interceptors can be added using the
  * `withInterceptors(...)` feature.
  *
+ * <div class="alert is-helpful">
+ *
+ * It's strongly recommended to enable
+ * [`fetch`](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) for applications that use
+ * Server-Side Rendering for better performance and compatibility. To enable `fetch`, add
+ * `withFetch()` feature to the `provideHttpClient()` call at the root of the application:
+ *
+ * ```
+ * provideHttpClient(withFetch());
+ * ```
+ *
+ * </div>
+ *
  * @see {@link withInterceptors}
  * @see {@link withInterceptorsFromDi}
  * @see {@link withXsrfConfiguration}
@@ -4132,7 +4398,6 @@ export declare function provideHttpClient(...features: HttpFeature<HttpFeatureKi
  * Note: The Fetch API doesn't support progress report on uploads.
  *
  * @publicApi
- * @developerPreview
  */
 export declare function withFetch(): HttpFeature<HttpFeatureKind.Fetch>;
 
@@ -4220,6 +4485,6 @@ export declare function withXsrfConfiguration({ cookieName, headerName }: {
  * load time.
  *
  */
-export declare function ɵwithHttpTransferCache(): Provider[];
+export declare function ɵwithHttpTransferCache(cacheOptions: HttpTransferCacheOptions): Provider[];
 
 export { }