angular-docs-cn/modules/@angular/examples
Miško Hevery d169c2434e feat(core): Add type information to injector.get() (#13785)
- 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
2017-01-17 15:34:54 -06:00
..
_common docs(Location): updating Location docs and adding example 2016-12-12 11:19:21 -08:00
common chore(ngComponentOutlet): add missing semicolon 2017-01-09 11:54:25 -08:00
compiler/ts/url_resolver refactor(): use const and let instead of var 2016-11-12 16:40:17 -08:00
core feat(core): Add type information to injector.get() (#13785) 2017-01-17 15:34:54 -06:00
facade/ts/async refactor(lint): Don't allow console.log 2016-11-23 15:47:01 -08:00
forms/ts refactor(lint): Don't allow console.log 2016-11-23 15:47:01 -08:00
http/ts repackaging: all the file moves 2016-05-01 20:51:00 -07:00
platform-browser/dom/debug/ts refactor: format and lint code 2016-12-12 11:30:25 -08:00
testing/ts docs(Location): updating Location docs and adding example 2016-12-12 11:19:21 -08:00
upgrade/static/ts chore(examples): add upgrade/static example 2016-11-16 09:18:10 -08:00
web_workers/ts repackaging: all the file moves 2016-05-01 20:51:00 -07:00
README.md style: clang-format the code 2016-12-09 11:19:55 -08:00
build.sh chore(examples): support upgrade/static examples 2016-11-16 09:18:10 -08:00
test.sh fix(build): test example directories with unit and e2e tests (#11296) 2016-09-07 16:04:33 -07:00
tsconfig-build.json docs(Location): updating Location docs and adding example 2016-12-12 11:19:21 -08:00

README.md

API Examples

This folder contains small example apps that get in-lined into our API docs. Each example contains tests for application behavior (as opposed to testing Angular's behavior) just like an Angular application developer would write.

Running the examples

# # execute the following command only when framework code changes
./build.sh

# run when test change
./modules/@angular/examples/build.sh  

# start server
$(npm bin)/gulp serve-examples

navigate to http://localhost:8001

Running the tests

 # run only when framework code changes
./build.sh

# run to compile tests and run them
./modules/@angular/examples/test.sh

NOTE: sometimes the http server does not exit properly and it retains the 8001 port. in such a case you can use lsof -i:8001 to see which process it is and then use kill to remove it. (Or in single command: lsof -i:8001 -t | xargs kill)