This is the archived documentation for Angular v6. Please visit angular.io to see documentation for the current version of Angular.

Request

Creates Request instances from provided values.

See more...

Deprecated: see https://angular.io/guide/http

      
      class Request extends Body {
  constructor(requestOptions: RequestArgs)
  method: RequestMethod
  headers: Headers
  url: string
  withCredentials: boolean
  responseType: ResponseContentType
  detectContentType(): ContentType
  detectContentTypeFromBody(): ContentType
  getBody(): any
}
    

Description

The Request's interface is inspired by the Request constructor defined in the Fetch Spec, but is considered a static value whose body can be accessed many times. There are other differences in the implementation, but this is the most significant.

Request instances are typically created by higher-level classes, like Http and Jsonp, but it may occasionally be useful to explicitly create Request instances. One such example is when creating services that wrap higher-level services, like Http, where it may be useful to generate a Request with arbitrary headers and search params.

import {Injectable, Injector} from '@angular/core'; import {HTTP_PROVIDERS, Http, Request, RequestMethod} from '@angular/http'; @Injectable() class AutoAuthenticator { constructor(public http:Http) {} request(url:string) { return this.http.request(new Request({ method: RequestMethod.Get, url: url, search: 'password=123' })); } } var injector = Injector.resolveAndCreate([HTTP_PROVIDERS, AutoAuthenticator]); var authenticator = injector.get(AutoAuthenticator); authenticator.request('people.json').subscribe(res => { //URL should have included '?password=123' console.log('people', res.json()); });
      
      import {Injectable, Injector} from '@angular/core';
import {HTTP_PROVIDERS, Http, Request, RequestMethod} from '@angular/http';

@Injectable()
class AutoAuthenticator {
  constructor(public http:Http) {}
  request(url:string) {
    return this.http.request(new Request({
      method: RequestMethod.Get,
      url: url,
      search: 'password=123'
    }));
  }
}

var injector = Injector.resolveAndCreate([HTTP_PROVIDERS, AutoAuthenticator]);
var authenticator = injector.get(AutoAuthenticator);
authenticator.request('people.json').subscribe(res => {
  //URL should have included '?password=123'
  console.log('people', res.json());
});
    

Constructor

constructor(requestOptions: RequestArgs)
      
      constructor(requestOptions: RequestArgs)
    

Parameters

requestOptions

Type: RequestArgs.

Properties

Property Description
method: RequestMethod

Http method with which to perform the request.

headers: Headers Headers

instance

url: string

Url of the remote resource

withCredentials: boolean

Enable use credentials

responseType: ResponseContentType

Buffer to store the response

Methods

Returns the content type enum based on header options.

detectContentType(): ContentType
      
      detectContentType(): ContentType
    

Parameters

There are no parameters.

Returns

ContentType

Returns the content type of request's body based on its type.

detectContentTypeFromBody(): ContentType
      
      detectContentTypeFromBody(): ContentType
    

Parameters

There are no parameters.

Returns

ContentType

Returns the request's body according to its type. If body is undefined, return null.

getBody(): any
      
      getBody(): any
    

Parameters

There are no parameters.

Returns

any