Улучшить эту документацию Просмотреть исходный код $httpProvider
Обзор
Используйте $httpProvider для изменения поведения по умолчанию сервиса $http.
Методы
-
useApplyAsync([value]);
Настройка сервиса $http для объединения обработки нескольких ответов http, полученных примерно в одно и то же время, через $rootScope.$applyAsync. Это может привести к значительному улучшению производительности для больших приложений, которые выполняют множество HTTP-запросов одновременно (часто во время загрузки приложения).
По умолчанию значение false. Если значение не указано, возвращается текущее значение конфигурации.
Параметры
Параметр Тип Подробности value (необязательно)booleanЕсли true, при загрузке запросов, они будут планировать отложенное «применение» на следующем тике, давая время последующим запросам в окне примерно ~10мс загрузиться и поделиться одним и тем же циклом обработки.
Возвращаемое значение
booleanObjectЕсли значение указано, возвращает $httpProvider для цепочки. В противном случае возвращает текущее значение конфигурации.
Свойства
-
defaults
Объект, содержащий значения по умолчанию для всех запросов $http.
-
defaults.cache- {boolean|Object} - Логическое значение или объект, созданный с помощью$cacheFactory, для включения или отключения кеширования HTTP-ответов по умолчанию. Дополнительную информацию см. в $http Кэширование. -
defaults.headers- {Object} - Заголовки по умолчанию для всех запросов $http. Документацию по настройке заголовков по умолчанию см. в $http.defaults.headers.commondefaults.headers.postdefaults.headers.putdefaults.headers.patch
-
defaults.jsonpCallbackParam-{string}- имя параметра запроса, передающего имя обратного вызова в запросе JSONP. Значение этого параметра будет заменено выражением, сгенерированным сервисом$jsonpCallbacks. По умолчанию'callback'. -
defaults.paramSerializer-{string|function(Object<string,string>):string}- функция, используемая для подготовки строкового представления параметров запроса (указанных как объект). Если указана строка, она интерпретируется как функция, зарегистрированная в $injector. По умолчанию $httpParamSerializer. -
defaults.transformRequest-{Array<function(data, headersGetter)>|function(data, headersGetter)}- массив функций (или одна функция), применяемых к данным запроса. По умолчанию это массив с одной функцией преобразования запроса:- Если свойство
dataобъекта конфигурации запроса содержит объект, сериализуйте его в формате JSON.
- Если свойство
-
defaults.transformResponse-{Array<function(data, headersGetter, status)>|function(data, headersGetter, status)}- массив функций (или одна функция), применяемых к данным ответа. По умолчанию это массив, который применяет одну функцию преобразования ответа, выполняющую две задачи:- Если обнаружен префикс XSRF, удалите его (см. Раздел «Рекомендации по безопасности» в документации $http).
- Если
Content-Typeимеет значениеapplication/jsonили ответ выглядит как JSON, десериализуйте его с помощью парсера JSON.
-
defaults.xsrfCookieName- {string} - Имя cookie, содержащего XSRF-токен. Значение по умолчанию -'XSRF-TOKEN'. -
defaults.xsrfHeaderName- {string} - Имя HTTP-заголовка, который нужно заполнить XSRF-токеном. Значение по умолчанию -'X-XSRF-TOKEN'.
-
-
interceptors
Массив фабрик сервисов для всех синхронных или асинхронных предварительной обработки запросов $http или последующей обработки ответов.
Эти фабрики сервисов упорядочены по запросам, т.е. они применяются в том же порядке, что и массив, по запросу, но в обратном порядке при получении ответа.
-
xsrfWhitelistedOrigins
Массив URL-адресов, чьи источники доверяются для получения XSRF-токена. Подробнее о XSRF см. раздел Рекомендации по безопасности.
Примечание: «Источник» состоит из схемы URI, домена и номера порта. Для
http:иhttps:, номер порта можно опустить, если используется стандартный порт (80 и 443 соответственно). Примеры:http://example.com,https://api.example.com:9876Невозможно внести в белый список определенные URL-адреса/пути. Частиpath,queryиfragmentURL будут проигнорированы. Например,https://foo.com/path/bar?query=baz#fragmentбудет рассматриваться какhttps://foo.com, что означает, что все запросы к URL, начинающимся сhttps://foo.com/будут включать XSRF-токен.
© 2010–2018 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.7.8/docs/api/ng/provider/$httpProvider