Spec-Zone.ru › Angular.js 1.8

Улучшить эту документацию Просмотреть исходный код $httpProvider

  1. $http
  2. provider в модуле ng

Обзор

Используйте $httpProvider для изменения поведения по умолчанию сервиса $http.

Методы

  • useApplyAsync([value]);

    Настройка сервиса $http для объединения обработки нескольких ответов HTTP, полученных примерно в одно и то же время, с помощью $rootScope.$applyAsync. Это может значительно улучшить производительность больших приложений, которые отправляют много одновременных запросов HTTP (часто во время загрузки приложения).

    По умолчанию false. Если значение не указано, возвращает текущее значение конфигурации.

    Параметры

    Параметр Тип Описание
    value
    (необязательно)
    boolean

    Если true, при загрузке запросов будет запланировано отложенное выполнение «apply» в следующей момент, давая время последующим запросам в окне примерно ~10 мс загрузиться и поделиться одним циклом обработки данных.

    Возвращаемое значение

    booleanObject

    Если значение указано, возвращает $httpProvider для цепочки вызовов. В противном случае возвращает текущее значение конфигурации.

Свойства

  • defaults

    Объект, содержащий значения по умолчанию для всех запросов $http.

    • defaults.cache - {boolean|Object} - Булево значение или объект, созданный с помощью $cacheFactory, для включения или отключения кеширования ответов HTTP по умолчанию. Подробнее см. $http Кеширование.

    • defaults.headers - {Object} - Заголовки по умолчанию для всех запросов $http. Документацию по настройке заголовков по умолчанию см. в $http.

      • defaults.headers.common
      • defaults.headers.post
      • defaults.headers.put
      • defaults.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} - Имя куки, содержащей маркер XSRF. Значение по умолчанию 'XSRF-TOKEN'.

    • defaults.xsrfHeaderName - {string} - Имя HTTP-заголовка для заполнения маркером XSRF. Значение по умолчанию 'X-XSRF-TOKEN'.

  • interceptors

    Массив фабрик сервисов для обработки запросов $http (синхронных или асинхронных) до их обработки или обработки ответов после.

    Эти фабрики сервисов упорядочены по запросу, то есть применяются в том же порядке, что и в массиве, при обработке запроса, но в обратном порядке при обработке ответа.

    Подробная информация об интерцепторах

  • xsrfTrustedOrigins

    Массив URL-адресов, происхождения которых доверяется для получения маркера XSRF. Подробнее о XSRF см. разделы Рекомендации по безопасности.

    Примечание: "Происхождение" состоит из схемы URI, имени хоста и номера порта. Для http: и https:, номер порта можно опустить, если используются стандартные порты (80 и 443 соответственно). Примеры: http://example.com, https://api.example.com:9876

    Невозможно доверять конкретным URL-адресам/путям. Части path, query и fragment URL-адреса будут проигнорированы. Например, https://foo.com/path/bar?query=baz#fragment будет обрабатываться как https://foo.com, что означает, что все запросы на URL-адреса, начинающиеся с https://foo.com/ будут включать маркер XSRF.
  • xsrfWhitelistedOrigins

    Устарело: (с версии 1.8.1)

    Это свойство устарело. Используйте xsrfTrustedOrigins вместо него.

© 2010–2020 Google, Inc.
Licensed under the Creative Commons Attribution License 3.0.
https://code.angularjs.org/1.8.2/docs/api/ng/provider/$httpProvider

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API