UNPKG

@angular/router

Version:
224 lines (216 loc) 6.4 kB
/** * @license Angular v7.0.1 * (c) 2010-2018 Google, Inc. https://angular.io/ * License: MIT */ import { Location, LocationStrategy } from '@angular/common'; import { MockLocationStrategy, SpyLocation } from '@angular/common/testing'; import { Compiler, Injectable, Injector, NgModule, NgModuleFactoryLoader, Optional } from '@angular/core'; import { ChildrenOutletContexts, NoPreloading, PreloadingStrategy, ROUTER_CONFIGURATION, ROUTES, Router, RouterModule, UrlHandlingStrategy, UrlSerializer, provideRoutes, ɵROUTER_PROVIDERS, ɵflatten } from '@angular/router'; /** * @fileoverview added by tsickle * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc */ /** * \@description * * Allows to simulate the loading of ng modules in tests. * * ``` * const loader = TestBed.get(NgModuleFactoryLoader); * * \@Component({template: 'lazy-loaded'}) * class LazyLoadedComponent {} * \@NgModule({ * declarations: [LazyLoadedComponent], * imports: [RouterModule.forChild([{path: 'loaded', component: LazyLoadedComponent}])] * }) * * class LoadedModule {} * * // sets up stubbedModules * loader.stubbedModules = {lazyModule: LoadedModule}; * * router.resetConfig([ * {path: 'lazy', loadChildren: 'lazyModule'}, * ]); * * router.navigateByUrl('/lazy/loaded'); * ``` * * \@publicApi */ class SpyNgModuleFactoryLoader { /** * @param {?} compiler */ constructor(compiler) { this.compiler = compiler; /** * \@docsNotRequired */ this._stubbedModules = {}; } /** * \@docsNotRequired * @param {?} modules * @return {?} */ set stubbedModules(modules) { /** @type {?} */ const res = {}; for (const t of Object.keys(modules)) { res[t] = this.compiler.compileModuleAsync(modules[t]); } this._stubbedModules = res; } /** * \@docsNotRequired * @return {?} */ get stubbedModules() { return this._stubbedModules; } /** * @param {?} path * @return {?} */ load(path) { if (this._stubbedModules[path]) { return this._stubbedModules[path]; } else { return /** @type {?} */ (Promise.reject(new Error(`Cannot find module ${path}`))); } } } SpyNgModuleFactoryLoader.decorators = [ { type: Injectable } ]; /** @nocollapse */ SpyNgModuleFactoryLoader.ctorParameters = () => [ { type: Compiler } ]; /** * @param {?} opts * @return {?} */ function isUrlHandlingStrategy(opts) { // This property check is needed because UrlHandlingStrategy is an interface and doesn't exist at // runtime. return 'shouldProcessUrl' in opts; } /** * Router setup factory function used for testing. * * \@publicApi * @param {?} urlSerializer * @param {?} contexts * @param {?} location * @param {?} loader * @param {?} compiler * @param {?} injector * @param {?} routes * @param {?=} opts * @param {?=} urlHandlingStrategy * @return {?} */ function setupTestingRouter(urlSerializer, contexts, location, loader, compiler, injector, routes, opts, urlHandlingStrategy) { /** @type {?} */ const router = new Router(/** @type {?} */ ((null)), urlSerializer, contexts, location, injector, loader, compiler, ɵflatten(routes)); if (opts) { // Handle deprecated argument ordering. if (isUrlHandlingStrategy(opts)) { router.urlHandlingStrategy = opts; } else { // Handle ExtraOptions if (opts.malformedUriErrorHandler) { router.malformedUriErrorHandler = opts.malformedUriErrorHandler; } if (opts.paramsInheritanceStrategy) { router.paramsInheritanceStrategy = opts.paramsInheritanceStrategy; } } } if (urlHandlingStrategy) { router.urlHandlingStrategy = urlHandlingStrategy; } return router; } /** * \@description * * Sets up the router to be used for testing. * * The modules sets up the router to be used for testing. * It provides spy implementations of `Location`, `LocationStrategy`, and {\@link * NgModuleFactoryLoader}. * * \@usageNotes * ### Example * * ``` * beforeEach(() => { * TestBed.configureTestModule({ * imports: [ * RouterTestingModule.withRoutes( * [{path: '', component: BlankCmp}, {path: 'simple', component: SimpleCmp}] * ) * ] * }); * }); * ``` * * \@publicApi */ class RouterTestingModule { /** * @param {?} routes * @param {?=} config * @return {?} */ static withRoutes(routes, config) { return { ngModule: RouterTestingModule, providers: [ provideRoutes(routes), { provide: ROUTER_CONFIGURATION, useValue: config ? config : {} }, ] }; } } RouterTestingModule.decorators = [ { type: NgModule, args: [{ exports: [RouterModule], providers: [ ɵROUTER_PROVIDERS, { provide: Location, useClass: SpyLocation }, { provide: LocationStrategy, useClass: MockLocationStrategy }, { provide: NgModuleFactoryLoader, useClass: SpyNgModuleFactoryLoader }, { provide: Router, useFactory: setupTestingRouter, deps: [ UrlSerializer, ChildrenOutletContexts, Location, NgModuleFactoryLoader, Compiler, Injector, ROUTES, ROUTER_CONFIGURATION, [UrlHandlingStrategy, new Optional()] ] }, { provide: PreloadingStrategy, useExisting: NoPreloading }, provideRoutes([]) ] },] } ]; /** * @fileoverview added by tsickle * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc */ /** * @fileoverview added by tsickle * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc */ // This file only reexports content of the `src` folder. Keep it that way. /** * @fileoverview added by tsickle * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc */ /** * Generated bundle index. Do not edit. */ export { setupTestingRouter, SpyNgModuleFactoryLoader, RouterTestingModule }; //# sourceMappingURL=testing.js.map