@angular/upgrade/static

downgradeInjectable

function

A helper function to allow an Angular service to be accessible from AngularJS.

downgradeInjectable(
  token: any,
  downgradedModule?: string
): Function;

A helper function to allow an Angular service to be accessible from AngularJS.

Part of the upgrade/static library for hybrid upgrade apps that support AOT compilation

This helper function returns a factory function that provides access to the Angular service identified by the token parameter.

Examples

First ensure that the service to be downgraded is provided in an NgModule that will be part of the upgrade application. For example, let's assume we have defined HeroesService

and that we have included this in our upgrade app NgModule

Now we can register the downgradeInjectable factory function for the service on an AngularJS module.

Inside an AngularJS component's controller we can get hold of the downgraded service via the name we gave when downgrading.

When using downgradeModule(), downgraded injectables will not be available until the Angular module that provides them is instantiated. In order to be safe, you need to ensure that the downgraded injectables are not used anywhere outside the part of the app where it is guaranteed that their module has been instantiated.

For example, it is OK to use a downgraded service in an upgraded component that is only used from a downgraded Angular component provided by the same Angular module as the injectable, but it is not OK to use it in an AngularJS component that may be used independently of Angular or use it in a downgraded Angular component from a different module.