Angular: 21.0.0 Release

common

| Commit | Description | | -- | -- | | | Add experimental support for the Navigation API (#63406) | | | Support of optional keys for the KeyValue pipe (#48814) | | | update to cldr 47 (#64032) | | | properly type ngComponentOutlet (#64561) | | | improve typing of ngComponentOutletContent (#63674) | | | removengModuleFactory input of NgComponentOutlet (#62838) |

compiler

| Commit | Description | | -- | -- | | | don't choke on unbalanced parens in declaration block | | | support arbitrary nesting in :host-context() | | | support commas in :host() argument | | | support complex selectors in :nth-child() | | | support one additional level of nesting in :host() |

compiler-cli

| Commit | Description | | -- | -- | | | Adds diagnostic for misconfigured @defer triggers (#64069) | | | enable type checking of host bindings by default (#63654) | | | allow value to be set on radio fields | | | capture metadata for undecorated fields (#63957) | | | disallow compiling with the emitDeclarationOnly TS compiler option enabled (#61609) | | | do not flag custom control required inputs as missing when field is present | | | infer type of custom field controls | | | infer types of signal forms set on native inputs | | | make field detection logic more robust | | | missingStructuralDirective diagnostic produces false negatives (#64579) | | | remove internal syntax-related flags (#63787) | | | report invalid bindings on form controls | | | use any when checking field interface conformance |

core

| Commit | Description | | -- | -- | | | Add migration for zoneless by default. (#63042) | | | Allow passing application providers in bootstrapModule options (#64354) | | | introduce BootstrapContext for improved server bootstrapping (#63562) | | | make SimpleChanges generic (#64535) | | | support IntersectionObserver options in viewport triggers (#64130) | | | support regular expressions in templates (#63887) | | | control not recognized when input has directive injecting ViewContainerRef (#64368) | | | do not rename ARIA property bindings to attributes (#63925) | | | Drop special-case disables automatic change detection scheduling (#63846) | | | drop support for TypeScript 5.8 (#63589) | | | ensure @for iteration over field is reactive (#64113) | | | Error on invalid APP_ID (#63252) | | | Explicit Zone CD in TestBed providers should not override TestBed error handler (#63404) | | | Remove ignoreChangesOutsideZone option (#62700) | | | Remove Zone-based change provider from internals by default (#63382) | | | skip Angular formatting when formatting signals recursively | | | SSR error in signal forms | | | update symbols (#64481) | | | remove moduleId from Component metadata (#63482) | | | remove deprecated interpolation option on Components. (#63474) |

elements

| Commit | Description | | -- | -- | | | return value on signal input getter (#62113) |

forms

| Commit | Description | | -- | -- | | | add debounce() rule for signal forms | | | add experimental signal-based forms (#63408) | | | Add FormArrayDirective (#55880) | | | Prevents marking fields as touched/dirty when state is hidden/readonly/disabled (#63633) | | | bind invalid input in custom controls (#64526) | | | consistent treatment of empty (#63456) | | | debounce updates from interop controls | | | Emit FormResetEvent when resetting control (#64024) | | | implement interoperability between signal forms and reactive forms (#64471) | | | interop supports CVAs with signals (#64618) | | | mark field as dirty when value is changed by ControlValueAccessor (#64471) | | | mark field as dirty when value is changed by a bound control (#64483) | | | only propagate schema defined properties from field to control (#64446) | | | Set error message of a schema error. | | | test that common field states are propagated to controls (#63884) | | | test that min/max properties are propagated to controls (#63884) | | | test that minLength/maxLength properties are propagated to controls (#63884) | | | implement change detection for field control bindings | | | only update interop controls when bound field changes | | | optimize [field] binding instructions (#64351) |

http

| Commit | Description | | -- | -- | | | add referrerPolicy option to HttpResource (#64283) | | | Add reponseType property to HttpResponse and HttpErrorResponse (#63043) | | | add support for fetch referrerPolicy option in HttpClient (#64116) | | | Provide http services in root (#56212) | | | HttpResponseBase.statusText (#64176) |

language-server

| Commit | Description | | -- | -- | | | fix directory renaming on Windows |

language-service

| Commit | Description | | -- | -- | | | address potential memory leak during project creation | | | prevent interpolation from superseding block braces (#64392) |

migrations

| Commit | Description | | -- | -- | | | add migration to convert ngClass to use class (#62983) | | | add migration to convert ngStyle to use style (#63517) | | | Adds migration for deprecated router testing module (#64217) | | | Adds support for CommonModule to standalone migration (#64138) | | | fix bug in ngclass-to-class migration (#63617) | | | remove error for no matching files in control flow migration (#64253) |

platform-browser

| Commit | Description | | -- | -- | | | remove deprecated ApplicationConfig export (#63529) |

router

| Commit | Description | | -- | -- | | | convert lastSuccessfulNavigation to signal (#63057) | | | Fix memory leak through Navigation.abort and canDeactivate guards (#64141) | | | Respect custom UrlSerializer handling of query parameters (#64449) | | | Update recognize stage to use internally async/await (#62994) |

upgrade

| Commit | Description | | -- | -- | | | Remove deprecated UpgradeAdapter (#61659) |

Breaking Changes

common

• (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}
• ngComponentOutletContent is now of type Node[][] | undefined instead of any[][] | undefined.
• NgModuleFactory has been removed, use NgModule instead. ### compiler-cli
• * 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.
• The Angular compiler now produces an error when the the emitDeclarationOnly TS compiler option is enabled as this mode is not supported. ### core
• The server-side bootstrapping process has been changed to eliminate the reliance on a global platform injector.

Before: ts const bootstrap = () => bootstrapApplication(AppComponent, config);

After: ts 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. - 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. - * TypeScript versions less than 5.9 are no longer supported. - (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. - ignoreChangesOutsideZone is no longer available as an option for configuring ZoneJS change detection behavior. - 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. - moduleId was removed from Component metadata. - The interpolation option on Components has been removed. Only the default {{ ... }} is now supported.

elements

• 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

• This new directive will conflict with existing FormArray directives or formArray inputs on the same element. ### platform-browser
• The deprecated ApplicationConfig export from @angular/platform-browser has been removed. Please import ApplicationConfig from @angular/core instead. ### router
• lastSuccessfulNavigation is now a signal and needs to be invoked
• 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
• UpgradeAdapter is no longer available. Use upgrade/static instead ### zone.js
• IE/Non-Chromium Edge are not supported anymore. ## Deprecations ### http
• HttpResponseBase.statusText is deprecated