d169c2434e
- 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
80 lines
2.1 KiB
TypeScript
80 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 * as common from '@angular/common';
|
|
import {CUSTOM_ELEMENTS_SCHEMA, Component, Directive, EventEmitter, Inject, InjectionToken, NgModule, Output} from '@angular/core';
|
|
import {Observable} from 'rxjs/Observable';
|
|
|
|
import {wrapInArray} from './funcs';
|
|
|
|
export const SOME_INJECTON_TOKEN = new InjectionToken('injectionToken');
|
|
|
|
@Component({
|
|
selector: 'comp-providers',
|
|
template: '',
|
|
providers: [
|
|
{provide: 'strToken', useValue: 'strValue'},
|
|
{provide: SOME_INJECTON_TOKEN, useValue: 10},
|
|
{provide: 'reference', useValue: common.NgIf},
|
|
{provide: 'complexToken', useValue: {a: 1, b: ['test', SOME_INJECTON_TOKEN]}},
|
|
]
|
|
})
|
|
export class CompWithProviders {
|
|
constructor(@Inject('strToken') public ctxProp: string) {}
|
|
}
|
|
|
|
@Component({
|
|
selector: 'cmp-reference',
|
|
template: `
|
|
<input #a [(ngModel)]="foo" required>{{a.value}}
|
|
<div *ngIf="true">{{a.value}}</div>
|
|
`
|
|
})
|
|
export class CompWithReferences {
|
|
foo: string;
|
|
}
|
|
|
|
@Component({selector: 'cmp-pipes', template: `<div *ngIf>{{test | somePipe}}</div>`})
|
|
export class CompUsingPipes {
|
|
}
|
|
|
|
@Component({
|
|
selector: 'cmp-custom-els',
|
|
template: `
|
|
<some-custom-element [someUnknownProp]="true"></some-custom-element>
|
|
`,
|
|
})
|
|
export class CompUsingCustomElements {
|
|
}
|
|
|
|
@Component({
|
|
selector: 'cmp-event',
|
|
template: `
|
|
<div (click)="handleDomEventVoid($event)"></div>
|
|
<div (click)="handleDomEventPreventDefault($event)"></div>
|
|
<div (dirEvent)="handleDirEvent($event)"></div>
|
|
`,
|
|
})
|
|
export class CompConsumingEvents {
|
|
handleDomEventVoid(e: any): void {}
|
|
handleDomEventPreventDefault(e: any): boolean { return false; }
|
|
handleDirEvent(e: any): void {}
|
|
}
|
|
|
|
@Directive({
|
|
selector: '[dirEvent]',
|
|
})
|
|
export class DirPublishingEvents {
|
|
@Output('dirEvent')
|
|
dirEvent: Observable<string> = new EventEmitter();
|
|
}
|
|
|
|
@NgModule({schemas: [CUSTOM_ELEMENTS_SCHEMA], declarations: wrapInArray(CompUsingCustomElements)})
|
|
export class ModuleUsingCustomElements {
|
|
}
|