- Introduce `InjectionToken<T>` which is a parameterized and type-safe version of `OpaqueToken`. DEPRECATION: - `OpaqueToken` is now deprecated, use `InjectionToken<T>` instead. - `Injector.get(token: any, notFoundValue?: any): any` is now deprecated use the same method which is now overloaded as `Injector.get<T>(token: Type<T>|InjectionToken<T>, notFoundValue?: T): T;`. Migration - Replace `OpaqueToken` with `InjectionToken<?>` and parameterize it. - Migrate your code to only use `Type<?>` or `InjectionToken<?>` as injection tokens. Using other tokens will not be supported in the future. BREAKING CHANGE: - Because `injector.get()` is now parameterize it is possible that code which used to work no longer type checks. Example would be if one injects `Foo` but configures it as `{provide: Foo, useClass: MockFoo}`. The injection instance will be that of `MockFoo` but the type will be `Foo` instead of `any` as in the past. This means that it was possible to call a method on `MockFoo` in the past which now will fail type check. See this example: ``` class Foo {} class MockFoo extends Foo { setupMock(); } var PROVIDERS = [ {provide: Foo, useClass: MockFoo} ]; ... function myTest(injector: Injector) { var foo = injector.get(Foo); // This line used to work since `foo` used to be `any` before this // change, it will now be `Foo`, and `Foo` does not have `setUpMock()`. // The fix is to downcast: `injector.get(Foo) as MockFoo`. foo.setUpMock(); } ``` PR Close #13785
76 lines
2.1 KiB
TypeScript
76 lines
2.1 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright Google Inc. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
* found in the LICENSE file at https://angular.io/license
|
|
*/
|
|
|
|
import {LowerCasePipe, NgIf} from '@angular/common';
|
|
import {ANALYZE_FOR_ENTRY_COMPONENTS, Component, ComponentFactoryResolver, Directive, Inject, Injectable, InjectionToken, Input, ModuleWithProviders, NgModule, Pipe} from '@angular/core';
|
|
|
|
@Injectable()
|
|
export class SomeService {
|
|
public prop = 'someValue';
|
|
}
|
|
|
|
@Injectable()
|
|
export class ServiceUsingLibModule {
|
|
}
|
|
|
|
@Directive({selector: '[someDir]', host: {'[title]': 'someDir'}})
|
|
export class SomeDirectiveInRootModule {
|
|
@Input()
|
|
someDir: string;
|
|
}
|
|
|
|
@Directive({selector: '[someDir]', host: {'[title]': 'someDir'}})
|
|
export class SomeDirectiveInLibModule {
|
|
@Input()
|
|
someDir: string;
|
|
}
|
|
|
|
@Pipe({name: 'somePipe'})
|
|
export class SomePipeInRootModule {
|
|
transform(value: string): any { return `transformed ${value}`; }
|
|
}
|
|
|
|
@Pipe({name: 'somePipe'})
|
|
export class SomePipeInLibModule {
|
|
transform(value: string): any { return `transformed ${value}`; }
|
|
}
|
|
|
|
@Component({selector: 'comp', template: `<div [someDir]="'someValue' | somePipe"></div>`})
|
|
export class CompUsingRootModuleDirectiveAndPipe {
|
|
}
|
|
|
|
@Component({selector: 'comp', template: `<div [someDir]="'someValue' | somePipe"></div>`})
|
|
export class CompUsingLibModuleDirectiveAndPipe {
|
|
}
|
|
|
|
export const SOME_TOKEN = new InjectionToken('someToken');
|
|
|
|
export function provideValueWithEntryComponents(value: any) {
|
|
return [
|
|
{provide: SOME_TOKEN, useValue: value},
|
|
{provide: ANALYZE_FOR_ENTRY_COMPONENTS, useValue: value, multi: true},
|
|
];
|
|
}
|
|
|
|
@NgModule({
|
|
declarations: [SomeDirectiveInLibModule, SomePipeInLibModule, CompUsingLibModuleDirectiveAndPipe],
|
|
exports: [CompUsingLibModuleDirectiveAndPipe],
|
|
entryComponents: [CompUsingLibModuleDirectiveAndPipe],
|
|
})
|
|
export class SomeLibModule {
|
|
static withProviders() {
|
|
return {
|
|
ngModule: SomeLibModule,
|
|
providers: [
|
|
ServiceUsingLibModule, provideValueWithEntryComponents(
|
|
[{a: 'b', component: CompUsingLibModuleDirectiveAndPipe}])
|
|
]
|
|
};
|
|
}
|
|
}
|