<a name="13.0.0"></a>

13.0.0 (2021-11-03)

Breaking Changes

common

• The behavior of the SpyLocation used by the RouterTestingModule has changed to match the behavior of browsers. It no longer emits a 'popstate' event when Location.go is called. In addition, simulateHashChange now triggers both a hashchange and a popstate event. Tests which use location.go and expect the changes to be picked up by the Router should likely change to simulateHashChange instead. Each test is different in what it attempts to assert so there is no single change that works for all tests. Each test using the SpyLocation to simulate browser URL changes should be evaluated on a case-by-case basis. ### core

• TypeScript versions older than 4.4.2 are no longer supported.

• NodeJS versions older than v12.20.0 are no longer supported due to the Angular packages using the NodeJS package exports feature with subpath patterns.

• The WrappedValue class can no longer be imported from @angular/core, which may result in compile errors or failures at runtime if outdated libraries are used that are still using WrappedValue. The usage of WrappedValue should be removed as no replacement is available.

  forms

• A new type called FormControlStatus has been introduced, which is a union of all possible status strings for form controls. AbstractControl.status has been narrowed from string to FormControlStatus, and statusChanges has been narrowed from Observable<any> to Observable<FormControlStatus>. Most applications should consume the new types seamlessly. Any breakage caused by this change is likely due to one of the following two problems: (1) the app is comparing AbstractControl.status against a string which is not a valid status; or, (2) the app is using statusChanges events as if they were something other than strings.

  router

• The default url serializer would previously drop everything after and including a question mark in query parameters. That is, for a navigation to /path?q=hello?&other=123, the query params would be parsed to just {q: 'hello'}. This is incorrect because the URI spec allows for question mark characers in query data. This change will now correctly parse the params for the above example to be {v: 'hello?', other: '123'}.

• Previously null and undefined inputs for routerLink were equaivalent to empty string and there was no way to disable the link's navigation. In addition, the href is changed from a property HostBinding() to an attribute binding (HostBinding('attr.href')). The effect of this change is that DebugElement.properties['href'] will now return the href value returned by the native element which will be the full URL rather than the internal value of the RouterLink href property.

• The router will no longer replace the browser URL when a new navigation cancels an ongoing navigation. This often causes URL flicker and was only in place to support some AngularJS hybrid applications. Hybrid applications which rely on the navigationId being present on initial navigations that were handled by the Angular router should instead subscribe to NavigationCancel events and perform the location.replaceState themselves to add navigationId to the Router state. In addition, tests which assert urlChanges on the SpyLocation may need to be adjusted to account for the replaceState which is no longer triggered.

• It is no longer possible to use Route.loadChildren using a string value. The following supporting classes were removed from @angular/core:

• NgModuleFactoryLoader

• SystemJsNgModuleFactoryLoader

The @angular/router package no longer exports these symbols:

• SpyNgModuleFactoryLoader
• DeprecatedLoadChildren

The signature of the setupTestingRouter function from @angular/core/testing has been changed to drop its NgModuleFactoryLoader parameter, as an argument for that parameter can no longer be created.

service-worker

• The return type of SwUpdate#activateUpdate and SwUpdate#checkForUpdate changed to Promise<boolean>.

Although unlikely, it is possible that this change will cause TypeScript type-checking to fail in some cases. If necessary, update your types to account for the new return type.

Deprecations

• The renderModuleFactory symbol in @angular/platform-server is no longer necessary as of Angular v13.

The renderModuleFactory calls can be replaced with renderModule.

service-worker

• The SwUpdate#activated observable is deprecated.

The SwUpdate#activated observable only emits values as a direct response to calling SwUpdate#activateUpdate() and was only useful for determining whether the call resulted in an update or not. Now, the return value of SwUpdate#activateUpdate() can be used to determine the outcome of the operation and therefore using SwUpdate#activated does not offer any benefit.

• The SwUpdate#availalbe observable is deprecated.

The new SwUpdate#versionUpdates observable provides the same information and more. Therefore, it is possible to rebuild the same behavior as SwUpdate#availalbe using the events emitted by SwUpdate#versionUpdates and filtering for VersionReadyEvent events. As a result, the SwUpdate#availalbe observable is now redundant.

| Commit | Description | | -- | -- | | | deprecate ViewEngine-based renderModuleFactory (#43757) |

bazel

| Commit | Description | | -- | -- | | | add strict_templates and experimental_extended_template_diagnostics to ng_module() rule (#43582) | | | allow for custom conditions to be set in ng_package targets (#43764) | | | create transition for enabling partial compilation (#43431) | | | expose esm2020 and es2020 conditions in APF package exports (#43740) | | | implement partial compilation APF v13 for ng_package rule (#43431) | | | switch prodmode output to ES2020 (#43431) | | | wire up partial compilation build setting in ng_module (#43431) | | | construct a manifest file even when warnings are emitted (#43582) | | | ngc-wrapped should not rely on linker for external workspaces (#43690) |

common

| Commit | Description | | -- | -- | | | add injection token for default date pipe timezone (#43611) | | | synchronise location mock behavior with the navigators (#41730) |

compiler

| Commit | Description | | -- | -- | | | do not error if $any is used inside a listener (#43866) |

compiler-cli

| Commit | Description | | -- | -- | | | inline resources when generating class metadata calls (#43178) | | | handle nullable expressions correctly in the nullish coalescing extended template diagnostic (#43572) | | | not evaluating new signature for __spreadArray (#43618) | | | updates ngc to pass the build when only warnings are emitted (#43673) |

core

| Commit | Description | | -- | -- | | | add createNgModuleRef function to create NgModuleRef based on NgModule class (#43580) | | | add getNgModuleById function to retrieve loaded NgModules by id (#43580) | | | add migration to opt out existing apps from new test module teardown behavior (#43353) | | | Add migration to update empty routerLinks in templates (#43176) | | | add support for Types in ViewContainerRef.createComponent (#43022) | | | drop support for TypeScript 4.2 and 4.3 (#43642) | | | enable test module teardown by default (#43353) | | | support TypeScript 4.4 (#43281) | | | update node version support range to support v16 (#43740) | | | avoid duplicating comments in TestBed teardown migration (#43776) | | | don't rethrow errors if test teardown has been disabled (#43635) | | | incorrect signature for initTestEnvironment (#43615) | | | support InjectFlags argument in NodeInjector.get() (#41592) | | | remove support for the deprecated WrappedValue (#43507) |

elements

| Commit | Description | | -- | -- | | | remove ng-add schematic (#43975) | | | remove incorrect @angular/platform-browser peer dependency (#43975) |

forms

| Commit | Description | | -- | -- | | | allow disabling min/max validators dynamically (by setting the value to null) (#42978) | | | Make Form Statuses use stricter types. (#42952) |

language-service

| Commit | Description | | -- | -- | | | Add method for retrieving the component template at the cursor location (#43208) | | | auto-apply optional chaining on nullable symbol (#42995) | | | provide snippets for attribute (#43590) | | | exclude the SafePropertyRead when applying the optional chaining (#43321) |

migrations

| Commit | Description | | -- | -- | | | account for CRLF characters in template migrations (#44013) | | | apply individual expression edits to preserve newline characters (#43519) | | | Ensure routerLink migration doesn't update unrelated files (#43519) | | | migration failed finding tsconfig file (#43343) | | | prevent migrations from updating external templates multiple times (#44013) |

router

| Commit | Description | | -- | -- | | | emit activate/deactivate events when an outlet gets attached/detached (#43333) | | | new output that would notify when link is activated (#43280) | | | Option to correctly restore history on failed navigation (#43289) | | | Allow question marks in query param values (#31187) | | | Do not modify parts of URL excluded from with 'eager' updates (#43421) | | | fix Router's public API for canceledNavigationResolution (#43842) | | | null/undefined routerLink should disable navigation (#43087) | | | Only trigger router navigation on popstate events from Location subscription (#43328) | | | Prevent URL flicker when new navigations cancel ongoing ones (#43496) | | | reuse route strategy fix (#43791) | | | remove support for loadChildren string syntax (#43591) |

service-worker

| Commit | Description | | -- | -- | | | SwUpdate#activeUpdate and SwUpdate#checkForUpdate should have a meaningful outcome (#43668) | | | expose more version update events (#43668) |

Special Thanks

Ahmed Ayed, Alan Agius, Alex Rickabaugh, Andrew Kushnir, Andrew Scott, Bjarki, Charles Lyding, Dmitrij Kuba, Doug Parker, Dylan Hunn, George Kalpakas, Jessica Janiuk, Jochen Kraushaar, Joe Martin (Crowdstaffing), Joey Perrott, Jon Rimmer, JoostK, Kristiyan Kostadinov, Maximilian Köller, Paul Gschwendtner, Pei Wang, Pete Bacon Darwin, Tomasz Domański, Willy Schott, anandtiwary, dario-piotrowicz, iRealNirmal, ivanwonder, krzysztof-grzybek, mgechev and vthinkxie