@angular/router - npm Package Versions

published 19.0.0 • last month

Changelog

19.0.0 (2024-11-19)

Blog post: https://blog.angular.dev/meet-angular-v19-7b29dfd05b84

Breaking Changes

compiler

this.foo property reads no longer refer to template context variables. If you intended to read the template variable, do not use this..
changes to CSS selectors parsing where introduced, mainly to: pseudo selectors :where() and :is(), parsing of :host and host-context, parsing selectors within pseudo selector arguments (for instance comma separated selectors). These changes could lead to a different specificity of the resulting selectors and/or previously broken selectors being applied now, for example :where(:host) used to transform to :where()[ng-host] and is being :where([ng-host]) now. Unlike the previous outcome, the new result can target elements and therefore could lead to breakages.

core

Angular directives, components and pipes are now standalone by default.
- Specify standalone: false for declarations that are currently declared in @NgModules.
- ng update for v19 will take care of this automatically.
TypeScript versions less than 5.5 are no longer supported.
Timing changes for effect API (in developer preview):
- effects which are triggered outside of change detection run as part of the change detection process instead of as a microtask. Depending on the specifics of application/test setup, this can result in them executing earlier or later (or requiring additional test steps to trigger; see below examples).
- effects which are triggered during change detection (e.g. by input signals) run earlier, before the component's template.
ExperimentalPendingTasks has been renamed to PendingTasks.
The autoDetect feature of ComponentFixture will now attach the fixture to the ApplicationRef. As a result, errors during automatic change detection of the fixture be reported to the ErrorHandler. This change may cause custom error handlers to observe new failures that were previously unreported.
createComponent will now render default fallback with empty projectableNodes.
- 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.
```
// The first ng-content will render the default fallback content if present
createComponent(MyComponent. { projectableNodes: [[], [secondNode]] });

// To prevent projecting the default fallback content:
createComponent(MyComponent. { projectableNodes: [[document.createTextNode('')], [secondNode]] });
```
Errors that are thrown during ApplicationRef.tick will now be rethrown when using TestBed. These errors should be resolved by ensuring the test environment is set up correctly to complete change detection successfully. There are two alternatives to catch the errors:
- Instead of waiting for automatic change detection to happen, trigger it synchronously and expect the error. For example, a jasmine test could write expect(() => TestBed.inject(ApplicationRef).tick()).toThrow()
- TestBed will reject any outstanding ComponentFixture.whenStable promises. A jasmine test, for example, could write expectAsync(fixture.whenStable()).toBeRejected().
As a last resort, you can configure errors to not be rethrown by setting rethrowApplicationErrors to false in TestBed.configureTestingModule.
The timers that are used for zone coalescing and hybrid mode scheduling (which schedules an application state synchronization when changes happen outside the Angular zone) will now run in the zone above Angular rather than the root zone. This will mostly affect tests which use fakeAsync: these timers will now be visible to fakeAsync and can be affected by tick or flush.
The deprecated factories property in KeyValueDiffers has been removed.

elements

as part of switching away from custom CD behavior to the hybrid scheduler, timing of change detection around custom elements has changed subtly. These changes make elements more efficient, but can cause tests which encoded assumptions about how or when elements would be checked to require updating.

localize

The name option in the ng add @localize`` schematic has been removed in favor of the project option.

platform-browser

The deprecated BrowserModule.withServerTransition method has been removed. Please use the APP_ID DI token to set the application id instead.

router

The Router.errorHandler property has been removed. Adding an error handler should be configured in either withNavigationErrorHandler with provideRouter or the errorHandler property in the extra options of RouterModule.forRoot. In addition, the error handler cannot be used to change the return value of the router navigation promise or prevent it from rejecting. Instead, if you want to prevent the promise from rejecting, use resolveNavigationPromiseOnError.
The return type of the Resolve interface now includes RedirectCommand.

common

compiler

| Commit | Type | Description | | -- | -- | -- | | a2e4ee0cb3 | feat | add diagnostic for unused standalone imports (#57605) | | 0c9d721ac1 | feat | add support for the typeof keyword in template expressions. (#58183) | | 09f589f000 | fix | this.a should always refer to class property a (#55183) | | 98804fd4be | fix | add more specific matcher for hydrate never block (#58360) | | b25121ee4a | fix | avoid having to duplicate core environment (#58444) | | 560282aa9b | fix | control flow nodes with root at the end projected incorrectly (#58607) | | 2be161d015 | fix | fix :host parsing in pseudo-selectors (#58681) | | 806a61b5a6 | fix | fix multiline selectors (#58681) | | a3cb530d84 | fix | handle typeof expressions in serializer (#58217) | | ba4340875a | fix | ignore placeholder-only i18n messages (#58154) | | e5d3abb298 | fix | resolve :host:host-context(.foo) (#58681) | | 80f56954ce | fix | transform chained pseudo-selectors (#58681) |

compiler-cli

core

elements

| Commit | Type | Description | | -- | -- | -- | | fe5c4e086a | fix | support output()-shaped outputs (#57535) | | 0cebfd7462 | fix | switch to ComponentRef.setInput & remove custom scheduler (#56728) |

forms

| Commit | Type | Description | | -- | -- | -- | | 3e7d724037 | feat | add ability to clear a FormRecord (#50750) | | 18b6f3339f | fix | fix FormRecord type inference (#50750) |

http

language-service

localize

migrations

platform-browser

| Commit | Type | Description | | -- | -- | -- | | c36a1c023b | fix | correctly add external stylesheets to ShadowDOM components (#58482) | | 5c61f46409 | refactor | remove deprecated BrowserModule.withServerTransition method (#58062) |

platform-server

| Commit | Type | Description | | -- | -- | -- | | 9e82559de4 | fix | destroy PlatformRef when error happens during the bootstrap() phase (#58112) |

router

| Commit | Type | Description | | -- | -- | -- | | f271021e19 | feat | Add routerOutletData input to RouterOutlet directive (#57051) | | b2790813a6 | fix | Align RouterModule.forRoot errorHandler with provider error handler (#57050) | | a49c35ec76 | fix | remove setter for injector on OutletContext (#58343) | | 7436d3180e | fix | Update Resolve interface to include RedirectCommand like ResolveFn (#57309) |

service-worker

19.0.0-rc.3

published 19.0.0-rc.3 • last month

19.0.0-rc.2

published 19.0.0-rc.2 • last month

18.2.12

published 18.2.12 • last month

Changelog

18.2.12 (2024-11-14)

compiler-cli

| Commit | Type | Description | | -- | -- | -- | | 4c38160853 | fix | correct extraction of generics from type aliases (#58548) |

19.0.0-rc.1

published 19.0.0-rc.1 • 2 months ago

18.2.11

published 18.2.11 • 2 months ago

Changelog

18.2.11 (2024-11-06)

core

| Commit | Type | Description | | -- | -- | -- | | 5f2d98a1b1 | fix | avoid slow stringification when checking for duplicates in dev mode (#58521) | | 3aa45a2fa1 | fix | resolve forward-referenced host directives during directive matching (#58492) (#58500) |

19.0.0-rc.0

published 19.0.0-rc.0 • 2 months ago

18.2.10

published 18.2.10 • 2 months ago

Changelog

18.2.10 (2024-10-30)

compiler

| Commit | Type | Description | | -- | -- | -- | | 69dce38e778 | fix | transform pseudo selectors correctly for the encapsulated view. (#58417) |

localize

| Commit | Type | Description | | -- | -- | -- | | 3b989ac5bd9 | fix | Adding arb format to the list of valid formats in the localization extractor cli (#58287) |

19.0.0-next.11