こんにちは、らこです。RC.3に引き続きアップデートからしばらく経ってしまいましたが、変更点についてまとめておきます。
今回は破壊的な変更もそこそこあるのでしっかり把握しておきましょう。
破壊的変更
テスト関連
テスト関連の変更が非常に多いのでざっくりまとめます。
なくなったもの
it,iit,xitdescribe,ddescribe,xdescribeexpecttoThrowErrorWithtoMatchPattern
Jasmineの関数をラップしていたものたち
Before:
import {beforeEachProviders, it, describe, inject} from '@angular/core/testing';
describe('my code', () => {
beforeEachProviders(() => [MyService]);
it('does stuff', inject([MyService], (service) => {
// actual test
});
});
After:
import {addProviders, inject} from '@angular/core/testing';
describe('my code', () => {
beforeEach(() => {
addProviders([MyService]);
});
it('does stuff', inject([MyService], (service) => {
// actual test
});
});
MockLocationStrategybrowserDetectiondispatchEventelnormalizeCSSstringifyElement
内部用APIに。LocationのテストはSpyLocationで。
injectAsyncclearPendingTimersLogMockAppliacationRefMockNgZoneclearPendingTimersgetTypeOfinstantiateType
不要になったものたち
変わったもの
beforeEachProviders=>addProviders
任意のタイミングで使う汎用のAPIとなった
TestComponentBuilder.createSync
与えられたコンポーネントのテンプレートが事前にインラインにコンパイルされていなければエラーを出すようになった
移動したもの
TestComponentBuilderTestComponentRendererComponentFixtureComponentFixtureAutoDetect
compiler/testing => core/testing に移動しました。
その他
- httpモジュールの
URLSearchParamsを使った時に、クエリパラメータが誤ってエンコードされていたのを修正したため、
RC.4の前後でリクエストのクエリパラメータが変化することがあります。
RC.4からのデフォルトでは、クエリパラメータ中に含まれる@ : $ , ; + ? /記号はそのまま使用されます。
この挙動をカスタマイズするには、 URLSearchParamsのコンストラクタの第2引数にQueryEncoderを継承したクラスのインスタンスを渡します。
import {URLSearchParams, QueryEncoder} from '@angular/http';
class MyQueryEncoder extends QueryEncoder {
encodeKey(k: string): string {
return myEncodingFunction(k);
}
encodeValue(v: string): string {
return myEncodingFunction(v);
}
}
let params = new URLSearchParams('', new MyQueryEncoder());
RC.3以前は同じ要素に対して
*ngForと*ngIfのように*プレフィックスのディレクティブ(テンプレートバインディング)を複数付与することができていましたが、
今後はこれは禁止されます。
これまでは使用可能ではありましたが大抵の場合は想定外の結果を招いていました。
*ngIfと*ngForが両方必要な場合には入れ子要素にするか、*プレフィックスを使わずに<template>タグを明示的に使う記法を選択してください。DomEventsPluginとKeyEventsPluginはこれまでパブリックなAPIとして公開されていましたが、非公開APIとなりました。
また、非推奨になっていたBROWSER_PROVIDERSは削除されました。
アニメーション関連
アニメーション周りのバグ修正がいくつか入っています。
- animations: ensure void => * animations are triggered when an expression is omitted (e0b0a59), closes #9327 #9381
void => *をトリガーとするアニメーションが条件により発火しないバグが修正されました
- animations: make sure the easing value is passed into the web-animations player (c43aec2), closes #9517 #9523
easingオプションがアニメーションプレイヤーに渡されていなかったバグが修正されました。
その他
*プレフィックスのディレクティブが<template>タグ上でも使えるようになりました。
コンポーネントやサービスのインスタンス化において、解決できないDIのがあったときのエラーがわかりやすくなりました。
One or more of providers for "MyBrokenComp3" were not defined: [?, SimpleService, ?]. のように、解決できなかった位置に?が表示されます。
- forms: add select multiple accessor as built-in accessor (9f00a1b)
multipleなselect要素の値へのアクセスをデフォルトでサポートするようになりました。
async validatorを使っているときに、バリデーション結果が変化したことをstatusChangeイベントで検知できるようになりました
これまでラジオボタンに対するremoveControlはtimeoutが必要でしたが、必要なくなりました。
- forms: ngModel should emit valueChanges and statusChanges asynchronously (97a2119)
ngModel がvalueChangesやstatusChangesイベントを発火するタイミングが非同期的になりました。
Features
機能の追加もいくつか行われています。
ComponentResolverに代わる新しいAPI、 Compilerが、compileComponentAsyncとcompileComponentSyncの2つのメソッドを持つようになりました。
compileComponentSyncはコンポーネントを同期的にコンパイルできますが、テンプレートがインライン、あるいはすでに読み込まれたものでなければなりません。
- core: add
[@Component](https://github.com/Component).precompileandComponentFactoryResolver(6c5b653), closes #9543
@Componentデコレータに新しいプロパティprecompileが追加されました。
このプロパティは、対象のコンポーネントがOffline Compileされる際に、一緒にコンパイルされて欲しいコンポーネントを指定できるものです。
今はまだドキュメントがないですが、RC.5が出てくる頃には用意されるでしょう。
- forms: add support for formArrayName (c03e1f2), closes #9251
- forms: add support for standalone ngModel dirs inside forms (6edf047), closes #9230
- forms: expose ValidatorFn and AsyncValidatorFn (17dcbf6), closes #8834
- forms: make valueChanges and statusChanges available on abstract control directives (de12710)
- forms: support updating of validators on exiting controls (#9516) (638fd74)
- forms: use formControlName on radio buttons when name is absent (#9681) (0961bd1)
Forms周りは引き続き作業中という感じです。
QueryList#.some()が実装されました。
- router: add pathMatch property to replace terminal (fcfddbf)
RouteConfigのterminalが廃止され、pathMatchフィールドが追加されました。
pathMatch: "full"の場合は、パスと完全一致した時にだけそのルートが使われます。
- router: implement data and resolve (f2f1ec0)
ActivatedRouteにdataが追加されました。また、resolveも追加されました。
dataは単純に固定の値をRouteConfig側で設定しておき、それがActivatedRouteからアクセスできるだけの機能です。
主に同じコンポーネントを複数のルートで使う時に、どのルートが使われているかの判別などに用います。
resolveはDIを使って、動的なデータをActivatedRouteから受け取るための機能です。
dataもresolveもまだ公式ドキュメントは追いついていないので、
このあたりのテストコードを読むと使い方がわかるでしょう。
いやはや、今回も長かったですね。RC.5ではAppModuleが導入され、bootstrap周りに大きな動きが出る予定です。
PLATFORM_DIRECTIVESやPLATFORM_PIPES、さらにはAPP_INITIALIZERあたりが非推奨APIとなります。
デザインドキュメントはこちらにあるので、先取りしたい方は読んでおくとよいでしょう。
トラッキングイシューはこちらです。
それではまた。