@angular/platform-browser-dynamic

animations

benchpress

common

compiler

compiler-cli

core

http

language-service

localize

migrations

platform-browser

platform-server

router

Breaking Changes

• breaking

  Node.js v16 support has been removed and the minimum support version has been bumped to 18.13.0.

  Node.js v16 is planned to be End-of-Life on 2023-09-11. Angular will stop supporting Node.js v16 in Angular v17. For Node.js release schedule details, please see: github.com/nodejs/release

common

• breaking
• breaking

  The NgSwitch directive now defaults to the === equality operator,
  migrating from the previously used ==. NgSwitch expressions and / or
  individual condition values need adjusting to this stricter equality
  check. The added warning message should help pinpointing NgSwitch
  usages where adjustements are needed.

core

• breaking

  Angular now required zone.js version ~0.14.0

• breaking

  Versions of TypeScript older than 5.2 are no longer supported.

• breaking

  The mutate method was removed from the WritableSignal interface and completely
  dropped from the public API surface. As an alternative please use the update method and
  make immutable changes to the object.

  Example before:

  items.mutate(itemsArray => itemsArray.push(newItem));

  Example after:

  items.update(itemsArray => [itemsArray, …newItem]);

• breaking

  The mutate method was removed from the WritableSignal interface and completely
  dropped from the public API surface. As an alternative please use the update method and
  make immutable changes to the object.

  Example before:

  items.mutate(itemsArray => itemsArray.push(newItem));

  Example after:

  items.update(itemsArray => [itemsArray, …newItem]);

• breaking

  OnPush components that are created dynamically now
  only have their host bindings refreshed and ngDoCheck run during change
  detection if they are dirty.
  Previously, a bug in the change detection would result in the OnPush
  configuration of dynamically created components to be ignored when
  executing host bindings and the ngDoCheck function. This is
  rarely encountered but can happen if code has a handle on the
  ComponentRef instance and updates values read in the OnPush
  component template without then calling either markForCheck or
  detectChanges on that component's ChangeDetectorRef.

platform-browser

• breaking

  REMOVE_STYLES_ON_COMPONENT_DESTROY default value is now true. This causes CSS of components to be removed from the DOM when destroyed. You retain the previous behaviour by providing the REMOVE_STYLES_ON_COMPONENT_DESTROY injection token.

  import {REMOVE_STYLES_ON_COMPONENT_DESTROY} from '@angular/platform-browser';
  ...
  providers: [{
    provide: REMOVE_STYLES_ON_COMPONENT_DESTROY,
    useValue: false,
  }]

• breaking

  The withNoDomReuse() function was removed from the public API. If you need to disable hydration, you can exclude the provideClientHydration() call from provider list in your application (which would disable hydration features for the entire application) or use ngSkipHydration attribute to disable hydration for particular components. See this guide for additional information: angular.io/guide/hydration.

router

• breaking

  Absolute redirects no longer prevent further redirects.
  Route configurations may need to be adjusted to prevent infinite
  redirects where additional redirects were previously ignored after an
  absolute redirect occurred.

• breaking

  Routes with loadComponent would incorrectly cause
  child routes to inherit their data by default. The default
  paramsInheritanceStrategy is emptyOnly. If parent data should be
  inherited in child routes, this should be manually set to always.

• breaking

  urlHandlingStrategy has been removed from the Router public API.
  This should instead be configured through the provideRouter or RouterModule.forRoot APIs.

• breaking

  The following Router properties have been removed from
  the public API:

  • canceledNavigationResolution

  • paramsInheritanceStrategy

  • titleStrategy

  • urlUpdateStrategy

  • malformedUriErrorHandler

  These should instead be configured through the provideRouter or
  RouterModule.forRoot APIs.

• breaking

  The setupTestingRouter function has been removed. Use
  RouterModule.forRoot or provideRouter to setup the Router for
  tests instead.

• breaking

  malformedUriErrorHandler is no longer available in
  the RouterModule.forRoot options. URL parsing errors should instead be
  handled in the UrlSerializer.parse method.

zone.js

• breaking

  Deep and legacy dist/ imports like zone.js/bundles/zone-testing.js and zone.js/dist/zone are no longer allowed. zone-testing-bundle and zone-testing-node-bundle are also no longer part of the package.

  The proper way to import zone.js and zone.js/testing is:

  import 'zone.js';
  import 'zone.js/testing';

Deprecations

animations

• deprecated

  The AnimationDriver.NOOP symbol is deprecated, use NoopAnimationDriver instead.

core

• deprecated

  ChangeDetectorRef.checkNoChanges is deprecated.

  Test code should use ComponentFixture instead of ChangeDetectorRef.
  Application code should not call ChangeDetectorRef.checkNoChanges directly.

• deprecated

  Swapping out the context object for EmbeddedViewRef
  is no longer supported. Support for this was introduced with v12.0.0, but
  this pattern is rarely used. There is no replacement, but you can use
  simple assignments in most cases, or Object.assign , or alternatively still replace the full object by using a Proxy(seeNgTemplateOutlet`
  as an example).

  Also adds a warning if the deprecated

• deprecated

  NgProbeToken

  The NgProbeToken is not used internally since the transition from View Engine to Ivy. The token has no utility and can be removed from applications and libraries.