parent
aa8d0809d3
commit
8accc98d28
|
@ -16,13 +16,13 @@ import {HttpEvent} from './response';
|
||||||
/**
|
/**
|
||||||
* Intercepts `HttpRequest` or `HttpResponse` and handles them.
|
* Intercepts `HttpRequest` or `HttpResponse` and handles them.
|
||||||
*
|
*
|
||||||
* Most interceptors transforms the outgoing request before passing it to the
|
* Most interceptors transform the outgoing request before passing it to the
|
||||||
* next interceptor in the chain, by calling `next.handle(transformedReq)`.
|
* next interceptor in the chain, by calling `next.handle(transformedReq)`.
|
||||||
* An interceptor may choose to transform the
|
* An interceptor may transform the
|
||||||
* response event stream as well, by applying additional Rx operators on the stream
|
* response event stream as well, by applying additional RxJS operators on the stream
|
||||||
* returned by `next.handle()`.
|
* returned by `next.handle()`.
|
||||||
*
|
*
|
||||||
* More rarely, an interceptor may choose to handle the request itself completely,
|
* More rarely, an interceptor may handle the request entirely,
|
||||||
* and compose a new event stream instead of invoking `next.handle()`. This is an
|
* and compose a new event stream instead of invoking `next.handle()`. This is an
|
||||||
* acceptable behavior, but keep in mind that further interceptors will be skipped entirely.
|
* acceptable behavior, but keep in mind that further interceptors will be skipped entirely.
|
||||||
*
|
*
|
||||||
|
@ -31,11 +31,21 @@ import {HttpEvent} from './response';
|
||||||
*
|
*
|
||||||
* @publicApi
|
* @publicApi
|
||||||
*
|
*
|
||||||
|
* @see [HTTP Guide](guide/http#intercepting-requests-and-responses)
|
||||||
|
*
|
||||||
|
* @usageNotes
|
||||||
|
*
|
||||||
|
* To use the same instance of `HttpInterceptors` for the entire app, import the `HttpClientModule`
|
||||||
|
* only in your `AppModule`, and add the interceptors to the root application injector .
|
||||||
|
* If you import `HttpClientModule` multiple times across different modules (for example, in lazy
|
||||||
|
* loading modules), each import creates a new copy of the `HttpClientModule`, which overwrites the interceptors
|
||||||
|
* provided in the root module.
|
||||||
|
*
|
||||||
*/
|
*/
|
||||||
export interface HttpInterceptor {
|
export interface HttpInterceptor {
|
||||||
/**
|
/**
|
||||||
* * **req**: The outgoing request to handle
|
* * **req**: The outgoing request to handle
|
||||||
* * **next**: The next interceptor in the chain
|
* * **next**: The next interceptor in the chain, or the backend if no interceptors in the chain.
|
||||||
*
|
*
|
||||||
*/
|
*/
|
||||||
intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>>;
|
intercept(req: HttpRequest<any>, next: HttpHandler): Observable<HttpEvent<any>>;
|
||||||
|
|
Loading…
Reference in New Issue