Help Angular by taking a 1 minute survey!Go to surveyHome

HttpRequest

An outgoing HTTP request with an optional typed body.

See more...

class HttpRequest<T> { constructor(method: string, url: string, third?: T | { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; }, fourth?: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; }) body: T | null headers: HttpHeaders reportProgress: boolean withCredentials: boolean responseType: 'arraybuffer' | 'blob' | 'json' | 'text' method: string params: HttpParams urlWithParams: string url: string serializeBody(): ArrayBuffer | Blob | FormData | string | null detectContentTypeHeader(): string | null clone(update: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; body?: any; method?: string; url?: string; setHeaders?: { ...; }; setParams?: { ...; }; } = {}): HttpRequest<any> }
      
      class HttpRequest<T> {
  constructor(method: string, url: string, third?: T | { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; }, fourth?: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; })
  body: T | null
  headers: HttpHeaders
  reportProgress: boolean
  withCredentials: boolean
  responseType: 'arraybuffer' | 'blob' | 'json' | 'text'
  method: string
  params: HttpParams
  urlWithParams: string
  url: string
  serializeBody(): ArrayBuffer | Blob | FormData | string | null
  detectContentTypeHeader(): string | null
  clone(update: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; body?: any; method?: string; url?: string; setHeaders?: { ...; }; setParams?: { ...; }; } = {}): HttpRequest<any>
}
    

Description

HttpRequest represents an outgoing request, including URL, method, headers, body, and other request configuration options. Instances should be assumed to be immutable. To modify a HttpRequest, the clone method should be used.

Constructor

Overload #1
constructor(method: "DELETE" | "GET" | "HEAD" | "JSONP" | "OPTIONS", url: string, init?: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; })
      
      constructor(method: "DELETE" | "GET" | "HEAD" | "JSONP" | "OPTIONS", url: string, init?: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; })
    
Parameters
method "DELETE" | "GET" | "HEAD" | "JSONP" | "OPTIONS"
url string
init object

Optional. Default is undefined.


Overload #2
constructor(method: "POST" | "PUT" | "PATCH", url: string, body: T, init?: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; })
      
      constructor(method: "POST" | "PUT" | "PATCH", url: string, body: T, init?: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; })
    
Parameters
method "POST" | "PUT" | "PATCH"
url string
body T
init object

Optional. Default is undefined.


Overload #3
constructor(method: string, url: string, body: T, init?: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; })
      
      constructor(method: string, url: string, body: T, init?: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; })
    
Parameters
method string
url string
body T
init object

Optional. Default is undefined.

Properties

Property Description
body: T | null Read-only.

The request body, or null if one isn't set.

Bodies are not enforced to be immutable, as they can include a reference to any user-defined data type. However, interceptors should take care to preserve idempotence by treating them as such.

headers: HttpHeaders Read-only.

Outgoing headers for this request.

reportProgress: boolean Read-only.

Whether this request should be made in a way that exposes progress events.

Progress events are expensive (change detection runs on each event) and so they should only be requested if the consumer intends to monitor them.

withCredentials: boolean Read-only.

Whether this request should be sent with outgoing credentials (cookies).

responseType: 'arraybuffer' | 'blob' | 'json' | 'text' Read-only.

The expected response type of the server.

This is used to parse the response appropriately before returning it to the requestee.

method: string Read-only.

The outgoing HTTP request method.

params: HttpParams Read-only.

Outgoing URL parameters.

urlWithParams: string Read-only.

The outgoing URL with all URL parameters set.

url: string Read-only. Declared in constructor.

Methods

Transform the free-form body into a serialized format suitable for transmission to the server.

serializeBody(): ArrayBuffer | Blob | FormData | string | null
      
      serializeBody(): ArrayBuffer | Blob | FormData | string | null
    
Parameters

There are no parameters.

Returns

ArrayBuffer | Blob | FormData | string | null

Examine the body and attempt to infer an appropriate MIME type for it.

detectContentTypeHeader(): string | null
      
      detectContentTypeHeader(): string | null
    
Parameters

There are no parameters.

Returns

string | null

If no such type can be inferred, this method will return null.

Overload #1
clone(): HttpRequest<T>
      
      clone(): HttpRequest<T>
    
Parameters

There are no parameters.

Returns

HttpRequest<T>


Overload #2
clone(update: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; body?: T; method?: string; url?: string; setHeaders?: { ...; }; setParams?: { ...; }; }): HttpRequest<T>
      
      clone(update: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; body?: T; method?: string; url?: string; setHeaders?: { ...; }; setParams?: { ...; }; }): HttpRequest<T>
    
Parameters
update object
Returns

HttpRequest<T>


Overload #3
clone<V>(update: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; body?: V; method?: string; url?: string; setHeaders?: { ...; }; setParams?: { ...; }; }): HttpRequest<V>
      
      clone<V>(update: { headers?: HttpHeaders; reportProgress?: boolean; params?: HttpParams; responseType?: "arraybuffer" | "blob" | "text" | "json"; withCredentials?: boolean; body?: V; method?: string; url?: string; setHeaders?: { ...; }; setParams?: { ...; }; }): HttpRequest<V>
    
Parameters
update object
Returns

HttpRequest<V>