@angular/upgrade/static/testing

createAngularTestingModule

function

A helper function to use when unit testing Angular services that depend upon upgraded AngularJS services.

createAngularTestingModule(
  angularJSModules: string[],
  strictDi?: boolean
): Type<any>;

A helper function to use when unit testing Angular services that depend upon upgraded AngularJS services.

This function returns an NgModule decorated class that is configured to wire up the Angular and AngularJS injectors without the need to actually bootstrap a hybrid application. This makes it simpler and faster to unit test services.

Use the returned class as an "import" when configuring the TestBed.

In the following code snippet, we are configuring the TestBed with two imports. The Ng2AppModule is the Angular part of our hybrid application and the ng1AppModule is the AngularJS part.

Once this is done we can get hold of services via the Angular Injector as normal. Services that are (or have dependencies on) an upgraded AngularJS service, will be instantiated as needed by the AngularJS $injector.

In the following code snippet, HeroesService is an Angular service that depends upon an AngularJS service, titleCase.

This helper is for testing services not Components. For Component testing you must still bootstrap a hybrid app. See UpgradeModule or downgradeModule for more information.

The resulting configuration does not wire up AngularJS digests to Zone hooks. It is the responsibility of the test writer to call $rootScope.$apply, as necessary, to trigger AngularJS handlers of async events from Angular.

The helper sets up global variables to hold the shared Angular and AngularJS injectors.

Only call this helper once per spec.
Do not use createAngularTestingModule in the same spec as createAngularJSTestingModule.

Here is the example application and its unit tests that use createAngularTestingModule and createAngularJSTestingModule.

createAngularTestingModule

Type<any>