@angular/platform-browser-dynamic

common

compiler

compiler-cli

core

elements

forms

http

language-server

language-service

migrations

platform-browser

router

upgrade

Breaking Changes

common

• breaking

  (test only) - TestBed now provides a fake PlatformLocation
  implementation that supports the Navigation API. This may break some
  tests, though we have not observed any failures internally. You can revert to the
  old default for TestBed by providing the MockPlatformLocation from
  @angular/common/testing in your providers:
  {provide: PlatformLocation, useClass: MockPlatformLocation}

• breaking

  ngComponentOutletContent is now of type Node | undefined instead of any | undefined.

• breaking

  NgModuleFactory has been removed, use NgModule instead.

compiler-cli

• breaking

  • Previously hidden type issues in host bindings may show up in your builds. Either resolve the type issues or set "typeCheckHostBindings": false in the angularCompilerOptions section of your tsconfig.

• breaking

  The Angular compiler now produces an error when the
  the emitDeclarationOnly TS compiler option is enabled as this mode is
  not supported.

core

• breaking

  The server-side bootstrapping process has been changed to eliminate the reliance on a global platform injector.

  Before:

  const bootstrap = () => bootstrapApplication(AppComponent, config);

  After:

  const bootstrap = (context: BootstrapContext) =>
    bootstrapApplication(AppComponent, config, context);

  A schematic is provided to automatically update main.server.ts files to pass the BootstrapContext to the bootstrapApplication call.

  In addition, getPlatform() and destroyPlatform() will now return null and be a no-op respectively when running in a server environment.

• breaking

  Using a combination of provideZoneChangeDetection
  while also removing ZoneJS polyfills will no longer result in the
  internal scheduler being disabled. All Angular applications now
  consistenly use the same scheduler, and those with the Zone change detection
  provider include additional automatic scheduling behaviors based on
  NgZone stabilization.

• breaking

  • TypeScript versions less than 5.9 are no longer supported.

• breaking

  (test only) - Using provideZoneChangeDetection in the
  TestBed providers would previously prevent TestBed from rethrowing
  errors as it should. Errors in the test will now be rethrown, regardless
  of the usage of provideZoneChangeDetection. Tests should be adjusted to
  prevent or account for these errors. As in previous major versions,
  this behavior can be disabled with rethrowApplicationErrors: false in
  configureTestingModule as a last resort.

• breaking

  ignoreChangesOutsideZone is no longer available as an
  option for configuring ZoneJS change detection behavior.

• breaking

  Angular no longer provides a change detection scheduler
  for ZoneJS-based change detection by default. Add
  provideZoneChangeDetection to the providers of your
  bootstrapApplication function or your AppModule (if using
  bootstrapModule). This provider addition will be covered by an
  automated migration.

• breaking

  moduleId was removed from Component metadata.

• breaking

  The interpolation option on Components has been removed. Only the default {{ ... }} is now supported.

elements

• breaking

  Fix signal input getter behavior in custom elements.

  Before this change, signal inputs in custom elements required function calls to access their values (elementRef.newInput()), while decorator inputs were accessed directly (elementRef.oldInput). This inconsistency caused confusion and typing difficulties.

  The getter behavior has been standardized so signal inputs can now be accessed directly, matching the behavior of decorator inputs:

  Before:

  • Decorator Input: elementRef.oldInput

  • Signal Input: elementRef.newInput()

  After:

  • Decorator Input: elementRef.oldInput

  • Signal Input: elementRef.newInput

forms

• breaking

  This new directive will conflict with existing FormArray directives or formArray inputs on the same element.

platform-browser

• breaking

  The deprecated ApplicationConfig export from @angular/platform-browser has been removed.
  Please import ApplicationConfig from @angular/core instead.

router

• breaking

  lastSuccessfulNavigation is now a signal and needs to be invoked

• breaking

  Router navigations may take several additional
  microtasks to complete. Tests have been found to often be highly
  dependent on the exact timing of navigation completions with respect to
  the microtask queue. The most common fix for tests is to ensure all
  navigations have been completed before making assertions. On rare
  occasions, this can also affect production applications. This can be
  caused by multiple subscriptions to router state throughout the application,
  both of which trigger navigations that happened to not conflict with the
  previous timing.

upgrade

• breaking

  UpgradeAdapter is no longer available. Use
  upgrade/static instead

zone.js

• breaking

  IE/Non-Chromium Edge are not supported anymore.

Deprecations

http

• deprecated

  HttpResponseBase.statusText is deprecated