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

Методы

• provider(name, provider);

  Регистрирует функцию поставщика в $injector. Функции поставщика — это функции-конструкторы, экземпляры которых отвечают за «предоставление» фабрики для сервиса.

  Имена поставщиков сервисов начинаются с имени предоставляемого сервиса, за которым следует Provider. Например, у сервиса $log есть поставщик, называемый $logProvider.

  Объекты поставщиков сервисов могут иметь дополнительные методы, которые позволяют настроить поставщика и его сервис. Важно, что вы можете настроить тип создаваемого сервиса с помощью метода $get или то, как этот сервис будет действовать. Например, у $logProvider есть метод debugEnabled, который позволяет указать, будет ли сервис $log выводить отладочные сообщения в консоль или нет.

  Параметры

  Параметр	Тип	Описание
  name	string	Имя экземпляра. ПРИМЕЧАНИЕ: поставщик будет доступен под ключом name + 'Provider'.
  provider	Objectfunction()	Если поставщик: Object: тогда он должен иметь метод $get. Метод $get будет вызван с помощью $injector.invoke() при необходимости создания экземпляра. Constructor: будет создан новый экземпляр поставщика с использованием $injector.instantiate(), затем он будет обработан как object.

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

  Object

  зарегистрированный экземпляр поставщика

• factory(name, $getFn);

  Регистрирует фабрику сервиса, которая будет вызвана для возврата экземпляра сервиса. Это сокращенная запись для регистрации сервиса, где его поставщик состоит только из свойства $get, которое является заданной функцией фабрики сервиса. Используйте $provide.factory(getFn), если вам не нужно настраивать свой сервис в поставщике.

  Параметры

  Параметр	Тип	Описание
  name	string	Имя экземпляра.
  $getFn	function()Array.<(string|function())>	Инжектируемая $getFn для создания экземпляра. Внутренне это сокращение для $provide.provider(name, {$get: $getFn}).

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

  Object

  зарегистрированный экземпляр поставщика

• service(name, constructor);

  Регистрирует конструктор сервиса, который будет вызван с new для создания экземпляра сервиса. Это сокращенная запись для регистрации сервиса, где свойство $get поставщика — это функция фабрики, которая возвращает экземпляр, созданный инжектором из функции-конструктора сервиса.

  Внутренне это выглядит примерно так:

  {
    $get: function() {
      return $injector.instantiate(constructor);
    }
  }
  

  Используйте $provide.service(class), если вы определяете свой сервис как тип/класс.

  Параметры

  Параметр	Тип	Описание
  name	string	Имя экземпляра.
  constructor	function()Array.<(string|function())>	Инжектируемый класс (функция-конструктор), который будет создан.

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

  Object

  зарегистрированный экземпляр поставщика

• value(name, value);

  Регистрирует сервис со значением в $injector, например, строку, число, массив, объект или функцию. Это сокращение для регистрации сервиса, где свойство $get поставщика — это функция фабрики, которая не принимает аргументов и возвращает сервис со значением. Это также означает, что в сервис со значением нельзя инжектировать другие сервисы.

  Сервисы со значением похожи на константные сервисы, за исключением того, что их нельзя инжектировать в функцию конфигурации модуля (см. angular.Module), но их можно переопределить с помощью декоратора Angular.

  Параметры

  Параметр	Тип	Описание
  name	string	Имя экземпляра.
  value	*	Значение.

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

  Object

  зарегистрированный экземпляр поставщика

• constant(name, value);

  Регистрирует константный сервис в $injector, например, строку, число, массив, объект или функцию. Как и в случае с сервисом value, другие сервисы в константу инжектировать нельзя.

  Но в отличие от сервиса value, константу можно инжектировать в функцию конфигурации модуля (см. angular.Module), и ее нельзя переопределить с помощью декоратора Angular.

  Параметры

  Параметр	Тип	Описание
  name	string	Имя константы.
  value	*	Значение константы.

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

  Object

  зарегистрированный экземпляр

• decorator(name, decorator);

  Регистрирует декоратор сервиса в $injector. Декоратор сервиса перехватывает создание сервиса, позволяя ему переопределить или изменить поведение сервиса. Объект, возвращаемый декоратором, может быть исходным сервисом или новым объектом сервиса, который заменяет или оборачивает и делегирует исходному сервису.

  Параметры

  Параметр	Тип	Описание
  name	string	Имя сервиса, который нужно декорировать.
  decorator	function()Array.<(string|function())>	Эта функция будет вызвана при необходимости создания экземпляра сервиса и должна вернуть декорированный экземпляр сервиса. Функция вызывается с помощью метода injector.invoke и поэтому полностью инжектируема. Локальные аргументы инъекции: $delegate - Исходный экземпляр сервиса, который можно подменить, настроить, декорировать или делегировать.