Skip to content

Commit cdaa909

Browse files
committed
docs: improve changelog for v19
Improves the changelog for v19, removing unnecessary information and shortening larger breaking change notes
1 parent e29bd14 commit cdaa909

File tree

1 file changed

+19
-51
lines changed

1 file changed

+19
-51
lines changed

CHANGELOG.md

Lines changed: 19 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -4,68 +4,51 @@
44
### compiler
55
- `this.foo` property reads no longer refer to template context variables. If you intended to read the template variable, do not use `this.`.
66
### core
7-
- Generally this PR has two implications:
8-
7+
- Angular directives, components and pipes are now standalone by default.
8+
* Specify `standalone: false` for declarations that are currently declared in `@NgModule`s.
9+
* `ng update` for v19 will take care of this automatically.
10+
- TypeScript versions less than 5.5 are no longer supported.
11+
- Timing changes for `effect` API (in developer preview):
12+
913
* effects which are triggered outside of change detection run as part of
1014
the change detection process instead of as a microtask. Depending on the
1115
specifics of application/test setup, this can result in them executing
1216
earlier or later (or requiring additional test steps to trigger; see below
1317
examples).
14-
18+
1519
* effects which are triggered during change detection (e.g. by input
1620
signals) run _earlier_, before the component's template.
17-
18-
We've seen a few common failure cases:
19-
20-
* Tests which used to rely on the `Promise` timing of effects now need to
21-
`await whenStable()` or call `.detectChanges()` in order for effects to
22-
run.
23-
24-
* Tests which use faked clocks may need to fast-forward/flush the clock to
25-
cause effects to run.
26-
27-
* `effect()`s triggered during CD could rely on the application being fully
28-
rendered (for example, they could easily read computed styles, etc). With
29-
the change, they run before the component's updates and can get incorrect
30-
answers. The recent `afterRenderEffect()` API is a natural replacement for
31-
this style of effect.
32-
33-
* `effect()`s which synchronize with the forms system are particularly
34-
timing-sensitive and might need to adjust their initialization timing.
35-
- * TypeScript versions less than 5.5 are no longer supported.
36-
- `ExperimentalPendingTasks` has been renamed to
37-
`PendingTasks`.
38-
- Angular directives, components and pipes are now standalone by default. Specify for declarations that are currently declared in s. for v19 will take care of this automatically.
21+
22+
- `ExperimentalPendingTasks` has been renamed to `PendingTasks`.
3923
- The `autoDetect` feature of `ComponentFixture` will now
4024
attach the fixture to the `ApplicationRef`. As a result, errors during
4125
automatic change detection of the fixture be reported to the `ErrorHandler`.
4226
This change may cause custom error handlers to observe new failures that were previously unreported.
43-
- Render default fallback with empty `projectableNodes`.
44-
45-
When passing an empty array to `projectableNodes` in the `createComponent` API, the default fallback content of the `ng-content` will be rendered if present. To prevent rendering the default content, pass `document.createTextNode('')` as a `projectableNode`.
46-
47-
For example:
48-
27+
- `createComponent` will now render default fallback with empty `projectableNodes`.
28+
29+
* When passing an empty array to `projectableNodes` in the `createComponent` API, the default fallback content
30+
of the `ng-content` will be rendered if present. To prevent rendering the default content, pass `document.createTextNode('')` as a `projectableNode`.
31+
4932
```ts
5033
// The first ng-content will render the default fallback content if present
5134
createComponent(MyComponent. { projectableNodes: [[], [secondNode]] });
52-
35+
5336
// To prevent projecting the default fallback content:
5437
createComponent(MyComponent. { projectableNodes: [[document.createTextNode('')], [secondNode]] });
55-
38+
5639
```
5740
- Errors that are thrown during `ApplicationRef.tick`
5841
will now be rethrown when using `TestBed`. These errors should be
5942
resolved by ensuring the test environment is set up correctly to
6043
complete change detection successfully. There are two alternatives to
6144
catch the errors:
62-
45+
6346
* Instead of waiting for automatic change detection to happen, trigger
6447
it synchronously and expect the error. For example, a jasmine test
6548
could write `expect(() => TestBed.inject(ApplicationRef).tick()).toThrow()`
6649
* `TestBed` will reject any outstanding `ComponentFixture.whenStable` promises. A jasmine test,
6750
for example, could write `expectAsync(fixture.whenStable()).toBeRejected()`.
68-
51+
6952
As a last resort, you can configure errors to _not_ be rethrown by
7053
setting `rethrowApplicationErrors` to `false` in `TestBed.configureTestingModule`.
7154
- The timers that are used for zone coalescing and hybrid
@@ -206,25 +189,10 @@
206189
| -- | -- | -- |
207190
| [dff4de0f75](https://github.com/angular/angular/commit/dff4de0f75741bc629462bb8da833b876c754453) | feat | add a combined migration for all signals APIs ([#58259](https://github.com/angular/angular/pull/58259)) |
208191
| [b6bc93803c](https://github.com/angular/angular/commit/b6bc93803c246d47aac0d2d8619271d42b249a4a) | feat | add schematic to migrate to signal queries ([#58032](https://github.com/angular/angular/pull/58032)) |
209-
| [bb286f65e7](https://github.com/angular/angular/commit/bb286f65e7a38c21ae61807b9a7811908a9030ed) | feat | capture output migration stats ([#58321](https://github.com/angular/angular/pull/58321)) |
210192
| [2bfc64daf1](https://github.com/angular/angular/commit/2bfc64daf1cad9be8099759e8de7a361555ad5d1) | feat | expose output as function migration ([#58299](https://github.com/angular/angular/pull/58299)) |
211193
| [59fe9bc772](https://github.com/angular/angular/commit/59fe9bc77236f1374427a851e55b0fa5216d9cf9) | feat | introduce signal input migration as `ng generate` schematic ([#57805](https://github.com/angular/angular/pull/57805)) |
212-
| [cbec46a51d](https://github.com/angular/angular/commit/cbec46a51d22a1238cc8bf1ebdf343d031b8f0ba) | feat | migrate .pipe calls in outputs used in tests ([#57691](https://github.com/angular/angular/pull/57691)) |
213-
| [cf70d626cd](https://github.com/angular/angular/commit/cf70d626cdedfd978d058b973420d8f31980555d) | feat | print output migration stats in ng generate ([#58321](https://github.com/angular/angular/pull/58321)) |
214-
| [68e5370a66](https://github.com/angular/angular/commit/68e5370a66633f4b069d6adffa95c2ea94291820) | feat | remove complete calls for migrated outputs ([#57671](https://github.com/angular/angular/pull/57671)) |
215-
| [9da21f798d](https://github.com/angular/angular/commit/9da21f798de2033af9d39a8a9b255ef2fe74f948) | feat | replace .next usage on outputs ([#57654](https://github.com/angular/angular/pull/57654)) |
216-
| [42607bf0f2](https://github.com/angular/angular/commit/42607bf0f28a2421a0d41809485c09dca26ea599) | fix | add outputs migration to combined shorthand ([#58318](https://github.com/angular/angular/pull/58318)) |
217-
| [71f5ef2aa5](https://github.com/angular/angular/commit/71f5ef2aa53a74bab7d0543f98870d81c44c4978) | fix | change imports to be G3 compatible ([#57654](https://github.com/angular/angular/pull/57654)) |
218-
| [e6514b9f3d](https://github.com/angular/angular/commit/e6514b9f3dc1e2bdaa12d7096251769dc6c3e262) | fix | do not migrate next calls in template if not an EventEmitter ([#58631](https://github.com/angular/angular/pull/58631)) |
219-
| [c5e676bb87](https://github.com/angular/angular/commit/c5e676bb8715bcde42e56eb08a41cc1ba5c95f91) | fix | flip the default standalone flag in route-lazy-loading migration ([#58474](https://github.com/angular/angular/pull/58474)) |
220-
| [b84ed2b628](https://github.com/angular/angular/commit/b84ed2b6288d101661abdc880c45b52398bc1022) | fix | include the output migration in the defaults of the signal migration ([#58635](https://github.com/angular/angular/pull/58635)) |
221194
| [90c7ec39a0](https://github.com/angular/angular/commit/90c7ec39a06e5c14711e0a42e2d6a478cde2b9cc) | fix | inject migration always inserting generated variables before super call ([#58393](https://github.com/angular/angular/pull/58393)) |
222195
| [7a65cdd911](https://github.com/angular/angular/commit/7a65cdd911cbbf22445c916fc754d3a3304bc5fe) | fix | inject migration not inserting generated code after super call in some cases ([#58393](https://github.com/angular/angular/pull/58393)) |
223-
| [00e2001351](https://github.com/angular/angular/commit/00e20013512f75327e5644ad5ac7829fc0e866d4) | fix | migrate more .next output usages ([#58282](https://github.com/angular/angular/pull/58282)) |
224-
| [e85ac5c7cb](https://github.com/angular/angular/commit/e85ac5c7cb06dc0fba757a9b931e79e07978f2a9) | fix | properly bundle shared compiler code into migrations ([#58515](https://github.com/angular/angular/pull/58515)) |
225-
| [3a264db866](https://github.com/angular/angular/commit/3a264db86611cba9b69780d7f01ee25787278320) | fix | properly handle comments in output migration ([#57691](https://github.com/angular/angular/pull/57691)) |
226-
| [616b411a6d](https://github.com/angular/angular/commit/616b411a6d94d3dbc3e072b91c1194466c0a1add) | fix | properly migrate output aliases ([#58411](https://github.com/angular/angular/pull/58411)) |
227-
| [d504452e2f](https://github.com/angular/angular/commit/d504452e2f193d3b494a0b2944cddb028c0a2231) | fix | properly replace imports across files ([#58414](https://github.com/angular/angular/pull/58414)) |
228196
| [c1aa411cf1](https://github.com/angular/angular/commit/c1aa411cf13259d991c8f224a2bafc3e9763fe8d) | fix | properly resolve tsconfig paths on windows ([#58137](https://github.com/angular/angular/pull/58137)) |
229197
| [e26797b38e](https://github.com/angular/angular/commit/e26797b38efe0ac813601c10581f34b7591954c1) | fix | replace removed NgModules in tests with their exports ([#58627](https://github.com/angular/angular/pull/58627)) |
230198
### platform-browser
@@ -4279,4 +4247,4 @@ Adrian Kunz, Alan Agius, AleksanderBodurri, Alex Rickabaugh, AlirezaEbrahimkhani
42794247

42804248

42814249

4282-
Earlier changelog entries can be found in CHANGELOG_ARCHIVE.md file.
4250+
Earlier changelog entries can be found in CHANGELOG_ARCHIVE.md file.

0 commit comments

Comments
 (0)