Spec-Zone.ru › Angular.js 1.7

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

  1. $http
  2. поставщик в модуле ng

Обзор

Используйте $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.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} - Имя 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 и fragment URL будут проигнорированы. Например, 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

Spec-Zone.ru

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