v18.0.0

18.0.0 (2024-05-22)

animations

Commit	Description
	remove deprecated matchesElement from AnimationDriver (#55479)

common

Commit	Description
	Deprecate Local Data API functions (#54483)
	remove deprecated isPlatformWorkerApp and isPlatformWorkerUi API (#55302)

compiler

Commit	Description
	add math elements to schema (#55631)
	allow comments between connected blocks (#55966)
	capture all control flow branches for content projection in if blocks (#54921)
	capture switch block cases for content projection (#54921)
	declare for loop aliases in addition to new name (#54942)
	For FatalDiagnosticError, hide the message field without affecting the emit (#55160)
	maintain multiline CSS selectors during CSS scoping (#55509)
	output input flags as a literal (#55215)
	prevent usage of reserved control flow symbol in custom interpolation context. (#55809)
	remove container index from conditional instruction (#55190)
	remove support for unassignable expressions in two-way bindings (#55342)
	throw error if item name and context variables conflict (#55045)

compiler-cli

Commit	Description
	add partial compilation support for deferred blocks (#54908)
	drop support for TypeScript older than 5.4 (#54961)
	add diagnostic if initializer API is used outside of an initializer (#54993)
	do not throw when retrieving TCB symbol for signal input with restricted access (#55774)
	dom property binding check in signal extended diagnostic (#54324)
	don't type check the bodies of control flow nodes in basic mode (#55360)
	fix type narrowing of @if with aliases (#55835)
	preserve original reference to non-deferrable dependency (#54759)
	report cases where initializer APIs are used in a non-directive class (#54993)
	report errors when initializer APIs are used on private fields (#54981)
	use switch statements to narrow Angular switch blocks (#55168)

core

Commit	Description
	Add a public API to establish events to be replayed and an attribute to mark an element with an event handler. (#55356)
	Add ability to configure zone change detection to use zoneless scheduler (#55252)
	Add build target for jsaction contract binary. (#55319)
	Add event delegation library to queue up events and replay them when the application is ready (#55121)
	add HOST_TAG_NAME token (#54751)
	add support for fallback content in ng-content (#54854)
	add support for i18n hydration (#54823)
	Add zoneless change detection provider as experimental (#55329)
	Modify EventType from an enum to an object. (#55323)
	provide ExperimentalPendingTasks API (#55487)
	Synchronize changes from internal JSAction codebase. (#55182)
	ApplicationRef.tick should respect OnPush for host bindings (#53718)
	ApplicationRef.tick should respect OnPush for host bindings (#53718) (#53718)
	ComponentFixture autoDetect respects OnPush flag of host view (#54824)
	ComponentFixture stability should match ApplicationRef (#54949)
	account for re-projected ng-content elements with fallback content (#54854)
	add warning when using zoneless but zone.js is still loaded (#55769)
	afterRender hooks registered outside change detection can mark views dirty (#55623)
	Angular should not ignore changes that happen outside the zone (#55102)
	Change Detection will continue to refresh views while marked for check (#54734)
	complete the removal of deprecation async function (#55491)
	ComponentFixture autodetect should detect changes within ApplicationRef.tick (#54733)
	correctly project single-root content inside control flow (#54921)
	do not save point-in-time setTimeout and rAF references (#55124)
	ensure change detection runs in a reasonable timeframe with zone coalescing (#54578)
	Ensure views marked for check are refreshed during change detection (#54735)
	error about provideExperimentalCheckNoChangesForDebug uses wrong name (#55824)
	exhaustive checkNoChanges should only do a single pass (#55839)
	Fix clearing of pending task in zoneless cleanup implementation (#55074)
	Fix null dereference error addEvent (#55353)
	hide implementation details of ExperimentalPendingTasks (#55516)
	Prevent markForCheck during change detection from causing infinite loops (#54900)
	prevent i18n hydration from cleaning projected nodes (#54823)
	Remove deprecated Testability methods (#53768)
	resolve error for multiple component instances that use fallback content (#55478)
	support content projection and VCRs in i18n (#54823)
	TestBed should not override NgZone from initTestEnvironment (#55226)
	TestBed should not override NgZone from initTestEnvironment (#55226)
	Update ApplicationRef.tick loop to only throw in dev mode (#54848)
	zoneless scheduler should check if Zone is defined before accessing it (#55118)
	deprecate @Component.interpolation (#55778)

forms

Commit	Description
	Unified Control State Change Events (#54579)
	Add event for forms submitted & reset (#55667)
	Allow canceled async validators to emit. (#55134)

http

Commit	Description
	allow caching requests with different origins between server and client (#55274)
	exclude caching for authenticated HTTP requests (#55034)
	resolve withRequestsMadeViaParent behavior with withFetch (#55652)
	Deprecate HttpClientModule & related modules (#54020)

language-service

Commit	Description
	allow external projects to use provided compiler options (#55035)
	avoid generating TS syntactic diagnostics for templates (#55091)
	implement getDefinitionAtPosition for Angular templates (#55269)
	prevent underlying TS Service from handling template files (#55003)
	use type-only import in plugin factory (#55996)

migrations

Commit	Description
	Migration schematics for HttpClientModule (#54020)
	handle more cases in HttpClientModule migration (#55640)
	migrate HttpClientTestingModule in test modules (#55803)
	preserve existing properties in HttpClientModule migration (#55777)
	resolve multiple structural issues with HttpClient migration (#55557)

platform-browser

Commit	Description
	add withI18nSupport() in developer preview (#55130)
	Use the right namespace for mathML. (#55622)
	remove deprecated transfer state APIs (#55474)

platform-browser-dynamic

Commit	Description
	unused RESOURCE_CACHE_PROVIDER API has been removed (#54875)

platform-server

Commit	Description
	add nonce attribute to event record script (#55495)
	remove event dispatch script from HTML when hydration is disabled (#55681)
	remove deprecated platformDynamicServer API (#54874)
	remove deprecated ServerTransferStateModule API (#54874)
	remove deprecated useAbsoluteUrl and baseUrl from PlatformConfig (#54874)
	remove legacy URL handling logic (#54874)

router

Commit	Description
	withNavigationErrorHandler can convert errors to redirects (#55370)
	Add ability to return UrlTree with NavigationBehaviorOptions from guards (#45023)
	Allow resolvers to return RedirectCommand (#54556)
	Allow Route.redirectTo to be a function which returns a string or UrlTree (#52606)
	preserve replaceUrl when returning a urlTree from CanActivate (#54042)
	Routed components never inherit RouterOutlet EnvironmentInjector (#54265)
	Routed components never inherit RouterOutlet EnvironmentInjector (#54265)

service-worker

Commit	Description
	avoid running CDs on controllerchange (#54222)
	remove controllerchange listener when app is destroyed (#55365)

Breaking Changes

animations

• Deprecated matchesElement method has been removed from AnimationDriver as it is unused.

common

• The deprecated isPlatformWorkerUi and isPlatformWorkerApp have been removed without replacement, as they serve no purpose since the removal of the WebWorker platform.

compiler

• Angular only supports writable expressions inside of two-way bindings.

compiler-cli

• • Angular no longer supports TypeScript versions older than 5.4.

core

• OnPush views at the root of the application need to
  be marked dirty for their host bindings to refresh. Previously, the host
  bindings were refreshed for all root views without respecting the
  OnPush change detection strategy.

• OnPush views at the root of the application need to
  be marked dirty for their host bindings to refresh. Previously, the host
  bindings were refreshed for all root views without respecting the
  OnPush change detection strategy.

• The ComponentFixture autoDetect feature will no
  longer refresh the component's host view when the component is OnPush
  and not marked dirty. This exposes existing issues in components which
  claim to be OnPush but do not correctly call markForCheck when they
  need to be refreshed. If this change causes test failures, the easiest
  fix is to change the component to ChangeDetectionStrategy.Default.

• ComponentFixture.whenStable now matches the
  ApplicationRef.isStable observable. Prior to this change, stability
  of the fixture did not include everything that was considered in
  ApplicationRef. whenStable of the fixture will now include unfinished
  router navigations and unfinished HttpClient requests. This will cause
  tests that await the whenStable promise to time out when there are
  incomplete requests. To fix this, remove the whenStable,
  instead wait for another condition, or ensure HttpTestingController
  mocks responses for all requests. Try adding HttpTestingController.verify()
  before your await fixture.whenStable to identify the open requests.
  Also, make sure your tests wait for the stability promise. We found many
  examples of tests that did not, meaning the expectations did not execute
  within the test body.

  In addition, ComponentFixture.isStable would synchronously switch to
  true in some scenarios but will now always be asynchronous.

• Angular will ensure change detection runs, even when the state update originates from
  outside the zone, tests may observe additional rounds of change
  detection compared to the previous behavior.

  This change will be more likely to impact existing unit tests.
  This should usually be seen as more correct and the test should be updated,
  but in cases where it is too much effort to debug, the test can revert to the old behavior by adding
  provideZoneChangeDetection({schedulingMode: NgZoneSchedulingMode.NgZoneOnly})
  to the TestBed providers.

  Similarly, applications which may want to update state outside the zone
  and not trigger change detection can add
  provideZoneChangeDetection({schedulingMode: NgZoneSchedulingMode.NgZoneOnly})
  to the providers in bootstrapApplication or add
  schedulingMode: NgZoneSchedulingMode.NgZoneOnly to the
  BootstrapOptions of bootstrapModule.

• When Angular runs change detection, it will continue to
  refresh any views attached to ApplicationRef that are still marked for
  check after one round completes. In rare cases, this can result in infinite
  loops when certain patterns continue to mark views for check using
  ChangeDetectorRef.detectChanges. This will be surfaced as a runtime
  error with the NG0103 code.

• async has been removed, use waitForAsync instead.

• The ComponentFixture.autoDetect feature now executes
  change detection for the fixture within ApplicationRef.tick. This more
  closely matches the behavior of how a component would refresh in
  production. The order of component refresh in tests may be slightly
  affected as a result, especially when dealing with additional components
  attached to the application, such as dialogs. Tests sensitive to this
  type of change (such as screenshot tests) may need to be updated.
  Concretely, this change means that the component will refresh before
  additional views attached to ApplicationRef (i.e. dialog components).
  Prior to this change, the fixture component would refresh after other
  views attached to the application.

• The exact timing of change detection execution when
  using event or run coalescing with NgZone is now the first of either
  setTimeout or requestAnimationFrame. Code which relies on this
  timing (usually by accident) will need to be adjusted. If a callback
  needs to execute after change detection, we recommend afterNextRender
  instead of something like setTimeout.

• Newly created and views marked for check and reattached
  during change detection are now guaranteed to be refreshed in that same
  change detection cycle. Previously, if they were attached at a location
  in the view tree that was already checked, they would either throw
  ExpressionChangedAfterItHasBeenCheckedError or not be refreshed until
  some future round of change detection. In rare circumstances, this
  correction can cause issues. We identified one instance that relied on
  the previous behavior by reading a value on initialization which was
  queued to be updated in a microtask instead of being available in the
  current change detection round. The component only read this value during
  initialization and did not read it again after the microtask updated it.

• Testability methods increasePendingRequestCount,
  decreasePendingRequestCount and getPendingRequestCount have been
  removed. This information is tracked with zones.

http

• By default we now prevent caching of HTTP requests that require authorization . To opt-out from this behaviour use the includeRequestsWithAuthHeaders option in withHttpTransferCache.

  Example:

  withHttpTransferCache({
    includeRequestsWithAuthHeaders: true,
  })

platform-browser

• Deprecated StateKey, TransferState and makeStateKey have been removed from @angular/platform-browser, use the same APIs from @angular/core.

platform-browser-dynamic

• No longer used RESOURCE_CACHE_PROVIDER APIs have been removed.

platform-server

• deprecated platformDynamicServer has been removed. Add an import @angular/compiler and replace the usage with platformServer

• deprecated ServerTransferStateModule has been removed. TransferState can be use without providing this module.

• deprecated useAbsoluteUrl and baseUrl been removed from PlatformConfig. Provide and absolute url instead.

• Legacy handling or Node.js URL parsing has been removed from ServerPlatformLocation.

  The main differences are;

  • pathname is always suffixed with a /.
  • port is empty when http: protocol and port in url is 80
  • port is empty when https: protocol and port in url is 443

router

• Guards can now return RedirectCommand for redirects
  in addition to UrlTree. Code which expects only boolean or UrlTree
  values in Route types will need to be adjusted.
• This change allows Route.redirectTo to be a function
  in addition to the previous string. Code which expects redirectTo to
  only be a string on Route objects will need to be adjusted.
• When a a guard returns a UrlTree as a redirect, the
  redirecting navigation will now use replaceUrl if the initial
  navigation was also using the replaceUrl option. If this is not
  desirable, the redirect can configure new NavigationBehaviorOptions by
  returning a RedirectCommand with the desired options instead of UrlTree.
• Providers available to the routed components always
  come from the injector heirarchy of the routes and never inherit from
  the RouterOutlet. This means that providers available only to the
  component that defines the RouterOutlet will no longer be available to
  route components in any circumstances. This was already the case
  whenever routes defined providers, either through lazy loading an
  NgModule or through explicit providers on the route config.
• Providers available to the routed components always
  come from the injector heirarchy of the routes and never inherit from
  the RouterOutlet. This means that providers available only to the
  component that defines the RouterOutlet will no longer be available to
  route components in any circumstances. This was already the case
  whenever routes defined providers, either through lazy loading an
  NgModule or through explicit providers on the route config.

Deprecations

common

• getCurrencySymbol, getLocaleCurrencyCode, getLocaleCurrencyName, getLocaleCurrencySymbol, getLocaleDateFormat, getLocaleDateTimeFormat, getLocaleDayNames, getLocaleDayPeriods, getLocaleDirection, getLocaleEraNames, getLocaleExtraDayPeriodRules, getLocaleExtraDayPeriods, getLocaleFirstDayOfWeek, getLocaleId, getLocaleMonthNames, getLocaleNumberFormat, getLocaleNumberSymbol, getLocalePluralCase, getLocaleTimeFormat, getLocaleWeekEndRange, getNumberOfCurrencyDigits

core

• @Component.interpolation is deprecated. Use Angular's
  delimiters instead.

http

• HttpClientModule, HttpClientXsrfModule and HttpClientJsonpModule

  As mentionned, those modules can be replaced by provider function only.