Improve this Doc View Source

Use `$httpProvider` to change the default behavior of the $http service.

## Methods

- ###

  `useApplyAsync([value]);`

  Configure $http service to combine processing of multiple http responses received at around the same time via $rootScope.$applyAsync. This can result in significant performance improvement for bigger applications that make many HTTP requests concurrently (common during application bootstrap).

  Defaults to false. If no value is specified, returns the current configured value.

  #### Parameters

  Param | Type | Details
  --- | --- | ---
  value (optional) | boolean | If true, when requests are loaded, they will schedule a deferred "apply" on the next tick, giving time for subsequent requests in a roughly ~10ms window to load and share the same digest cycle.

  #### Returns

  boolean Object | If a value is specified, returns the $httpProvider for chaining. otherwise, returns the current configured value.

- ###

  `useLegacyPromiseExtensions([value]);`

  Configure `$http` service to return promises without the shorthand methods `success` and `error`. This should be used to make sure that applications work without these methods.

  Defaults to false. If no value is specified, returns the current configured value.

  #### Parameters

  Param | Type | Details
  --- | --- | ---
  value (optional) | boolean | If true, `$http` will return a normal promise without the `success` and `error` methods.

  #### Returns

  boolean Object | If a value is specified, returns the $httpProvider for chaining. otherwise, returns the current configured value.

## Properties

- ### `defaults`

  | Object containing default values for all $http requests. `defaults.cache` - {Object} - an object built with `$cacheFactory` that will provide the cache for all requests who set their `cache` property to `true`. If you set the `defaults.cache = false` then only requests that specify their own custom cache object will be cached. See $http Caching for more information. `defaults.xsrfCookieName` - {string} - Name of cookie containing the XSRF token. Defaults value is `'XSRF-TOKEN'`. `defaults.xsrfHeaderName` - {string} - Name of HTTP header to populate with the XSRF token. Defaults value is `'X-XSRF-TOKEN'`. `defaults.headers` - {Object} - Default headers for all $http requests. Refer to $http for documentation on setting default headers. `defaults.headers.common` `defaults.headers.post` `defaults.headers.put` `defaults.headers.patch` `defaults.paramSerializer` - `{string|function(Object<string,string>):string}` - A function used to the prepare string representation of request parameters (specified as an object). If specified as string, it is interpreted as a function registered with the $injector. Defaults to $httpParamSerializer.

- ### `interceptors`

  | Array containing service factories for all synchronous or asynchronous $http pre-processing of request or postprocessing of responses. These service factories are ordered by request, i.e. they are applied in the same order as the array, on request, but reverse order, on response. Interceptors detailed info