20.3.6 (2025-10-16)

core

21.0.0-next.8 (2025-10-15)

compiler-cli

20.3.5 (2025-10-15)

compiler-cli

21.0.0-next.7 (2025-10-08)

Deprecations

http

• HttpResponseBase.statusText is deprecated

  common

  | Commit | Type | Description | | -- | -- | -- | | 9eac43cf46 | feat | Support of optional keys for the KeyValue pipe (#48814) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 548ea027f6 | fix | ensure missing leave animations don't queue leave animations (#64226) | | dd7c4cd9d1 | fix | Fixes animations in conjunction with content projection (#63776) | | cb56fbfddb | fix | handle undefined CSS time values in parseCssTimeUnitsToMs function (#64181) | | e279f30199 | fix | prevent early exit from leave animations when multiple transitions are present (#64225) |

  http

  | Commit | Type | Description | | -- | -- | -- | | 5cbdefcf11 | feat | add support for fetch referrerPolicy option in HttpClient (#64116) | | 0e4e17cd97 | refactor | HttpResponseBase.statusText (#64176) |

  migrations

  | Commit | Type | Description | | -- | -- | -- | | d3e76b1956 | fix | preserve component imports when pruning NgModules in standalone migration (#64186) | | 62bbce63b7 | fix | remove error for no matching files in control flow migration (#64253) |

  router

  | Commit | Type | Description | | -- | -- | -- | | 5e61e8d3c3 | fix | Fix memory leak through Navigation.abort and canDeactivate guards (#64141) |

20.3.4 (2025-10-08)

core

21.0.0-next.6 (2025-10-02)

Breaking Changes

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

    common

    | Commit | Type | Description | | -- | -- | -- | | 99c5269ee8 | feat | Support of optional keys for the KeyValue pipe (#48814) |

    compiler

    | Commit | Type | Description | | -- | -- | -- | | 159be56709 | fix | recover template literals with broken expressions (#64150) |

    core

    | Commit | Type | Description | | -- | -- | -- | | 1cb16fddb5 | fix | Fixes animations in conjunction with content projection (#63776) | | 8a0c9ca8be | fix | prevents unintended early termination of leave animations and hoisting (#64088) |

    elements

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

    migrations

    | Commit | Type | Description | | -- | -- | -- | | 51a0b59389 | fix | handle shorthand property declarations in NgModule (#64160) | | 31bc9e4111 | fix | skip migration for inputs with 'this' references (#64142) |

20.3.3 (2025-10-02)

compiler

21.0.0-next.5 (2025-09-24)

common

20.3.2 (2025-09-24)

compiler-cli

21.0.0-next.4 (2025-09-17)

Breaking Changes

common

• ngComponentOutletContent is now of type Node[][] | undefined instead of any[][] | undefined.

  core

• 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.
• 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.

  common

  | Commit | Type | Description | | -- | -- | -- | | 7a4b225c57 | refactor | improve typing of ngComponentOutletContent (#63674) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | 803dc8e44c | fix | Add support for aria-invalid (#63748) |

  compiler-cli

  | Commit | Type | Description | | -- | -- | -- | | 89cf62f907 | fix | only bind inputs that are part of microsyntax to a structural directive (#52453) | | 7fd3db0423 | fix | remove internal syntax-related flags (#63787) | | 0a60e355e1 | fix | signal not invoked diagnostic not raised when input has same name in template (#63754) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 809a4ed8c1 | feat | Add migration for zoneless by default. (#63042) | | 1352fbdbf2 | fix | Drop special-case disables automatic change detection scheduling (#63846) | | 3d6eeab2e0 | fix | prevent animation events from being cleaned up on destroy (#63414) | | a4001c440f | fix | Prevent leave animations on a move operation (#63745) | | 45fed3d201 | fix | Remove Zone-based change provider from internals by default (#63382) | | a5e5dbbc16 | refactor | remove moduleId from Component metadata (#63482) | | 9a16718b13 | refactor | remove deprecated interpolation option on Components. (#63474) |

  forms

  | Commit | Type | Description | | -- | -- | -- | | d201cd2c2b | feat | Prevents marking fields as touched/dirty when state is hidden/readonly/disabled (#63633) |

  migrations

  | Commit | Type | Description | | -- | -- | -- | | 8dc8914c8a | feat | add migration to convert ngStyle to use style (#63517) | | 4133b08d93 | fix | fix route-lazy-loading migration (#63818) |

20.3.1 (2025-09-17)

compiler

18.2.14 (2025-09-10)

Breaking Changes

core

• 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.

  (cherry picked from commit 8bf80c9d2314b4f2bcf3df83ae01552a6fc49834)

  core

  | Commit | Type | Description | | -- | -- | -- | | 9d1fb33f5e | fix | introduce BootstrapContext for improved server bootstrapping (#63640) |

19.2.15 (2025-09-10)

Breaking Changes

core

• 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.

  core

  | Commit | Type | Description | | -- | -- | -- | | 70d0639bc1 | fix | introduce BootstrapContext for improved server bootstrapping (#63639) |

21.0.0-next.3 (2025-09-10)

Breaking Changes

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.

    core

• 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.

• • TypeScript versions less than 5.9 are no longer supported.
    | Commit | Type | Description | | -- | -- | -- | | ef025880cc | fix | remove refresh button from transfer state tab (#63592) |

    compiler-cli

    | Commit | Type | Description | | -- | -- | -- | | 0571b335b9 | feat | enable type checking of host bindings by default (#63654) |

    core

    | Commit | Type | Description | | -- | -- | -- | | 28926ba92c | feat | introduce BootstrapContext for improved server bootstrapping (#63562) | | c0791e1887 | fix | drop support for TypeScript 5.8 (#63589) |

    migrations

    | Commit | Type | Description | | -- | -- | -- | | 655a99d0c6 | fix | fix bug in ngclass-to-class migration (#63617) |

20.3.0 (2025-09-10)

Breaking Changes

core

• 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.

  (cherry picked from commit 8bf80c9d2314b4f2bcf3df83ae01552a6fc49834)

  | Commit | Type | Description | | -- | -- | -- | | a3f808d7c8 | fix | remove refresh button from transfer state tab (#63592) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 6117ccee2e | feat | introduce BootstrapContext for improved server bootstrapping (#63636) |

21.0.0-next.2 (2025-09-03)

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}

  core

• (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.

  platform-browser

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

  router

• 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

  common

  | Commit | Type | Description | | -- | -- | -- | | c795960ada | feat | Add experimental support for the Navigation API (#63406) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | 0a82138d4b | fix | fixes regression with event parsing and animate prefix (#63470) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 538de86a72 | fix | avoid injecting internal error handler from a destroyed injector (#62275) | | d399d7d02b | fix | Explicit Zone CD in TestBed providers should not override TestBed error handler (#63404) | | ed3d1f246b | fix | Fix cancellation of animation enter classes (#63442) | | 06f4fd4456 | fix | Fixed inject migration schematics for migrate destructured properties (#62832) | | 9ae9875384 | fix | Prevent an error on cleanup when an rxResource stream threw before returning an Observable (#63342) | | 92e09adc0a | fix | Remove ignoreChangesOutsideZone option (#62700) |

  forms

  | Commit | Type | Description | | -- | -- | -- | | b8314bd340 | feat | add experimental signal-based forms (#63408) | | 10ef96adb3 | fix | consistent treatment of empty (#63456) |

  http

  | Commit | Type | Description | | -- | -- | -- | | 07e678872f | feat | Add reponseType property to HttpResponse and HttpErrorResponse (#63043) |

  platform-browser

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

  platform-server

  | Commit | Type | Description | | -- | -- | -- | | ee73dc9553 | fix | prevent false warning for duplicate state serialization (#63525) |

  router

  | Commit | Type | Description | | -- | -- | -- | | 5b53535dd1 | fix | Update recognize stage to use internally async/await (#62994) |

  upgrade

  | Commit | Type | Description | | -- | -- | -- | | f86846555b | fix | Remove deprecated UpgradeAdapter (#61659) |

20.2.4 (2025-09-03)

core

20.2.3 (2025-08-29)

compiler

21.0.0-next.1 (2025-08-27)

Breaking Changes

common

• NgModuleFactory has been removed, use NgModule instead.

  forms

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

  common

  | Commit | Type | Description | | -- | -- | -- | | 25f593ce2a | refactor | removengModuleFactory input of NgComponentOutlet (#62838) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | a0388409e3 | fix | fixes animations on elements with structural directives (#63390) | | 827c3c15f4 | fix | Keep paraenthesis in Nullish + Boolean expression. (#63292) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 37ead5ffb5 | fix | Ensures @for loop animations never get cancelled (#63328) | | 18c9352d21 | fix | fix memory leak with leaving nodes tracking (#63328) | | 9139fe0d95 | fix | Fixes animate.leave binding to a string with spaces (#63366) |

  forms

  | Commit | Type | Description | | -- | -- | -- | | 0dd95c503f | feat | Add FormArrayDirective (#55880) |

  migrations

  | Commit | Type | Description | | -- | -- | -- | | 6ddb250391 | feat | add migration to convert ngClass to use class (#62983) |

20.2.2 (2025-08-27)

compiler

20.2.1 (2025-08-21)

compiler

21.0.0-next.0 (2025-08-20)

Breaking Changes

compiler-cli

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

  router

• lastSuccessfulNavigation is now a signal and needs to be invoked

  compiler-cli

  | Commit | Type | Description | | -- | -- | -- | | be7110342b | fix | disallow compiling with the emitDeclarationOnly TS compiler option enabled (#61609) |

  http

  | Commit | Type | Description | | -- | -- | -- | | 4bed062bc9 | feat | Provide http services in root (#56212) |

  router

  | Commit | Type | Description | | -- | -- | -- | | 4e0fc81491 | feat | convert lastSuccessfulNavigation to signal (#63057) |

20.2.0 (2025-08-20)

Deprecations

animations

• @angular/animations

  core

• @angular/animations

  router

• The Router.getCurrentNavigation method is deprecated. Use the Router.currentNavigation signal instead.
• The Router.getCurrentNavigation method is deprecated. Use the Router.currentNavigation signal instead.

  animations

  | Commit | Type | Description | | -- | -- | -- | | 9766116cea | refactor | deprecate the animations package (#62795) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | 7767aa640c | fix | allow more characters in square-bracketed attribute names (#62742) | | 7b51728813 | fix | fixes animation event host bindings not firing (#63217) |

  compiler-cli

  | Commit | Type | Description | | -- | -- | -- | | 5abfe4a899 | feat | add diagnostic for uninvoked functions in text interpolation (#59191) | | c4917074f1 | fix | display proper function in NG8117 message (#62842) | | 812463c563 | fix | Ignore diagnostics on ngTemplateContextGuard lines in TCB (#63054) | | 45b030b5ce | fix | prevent dom event assertion in TCB generation on older angular versions (#63053) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 6b1f4b9e8b | feat | add enter and leave animation instructions (#62682) | | cec91c0035 | feat | add option to infer the tag names of components in tests (#62283) | | 141bb75ff2 | feat | Promote zoneless to stable (#62699) | | 4138aca91f | feat | render ARIA property bindings as attributes (#62630) | | a409534d6c | feat | support as aliases on else if blocks (#63047) | | 745ea44394 | feat | support TypeScript 5.9 (#62541) | | 593cc8a368 | fix | checks if body exists before continuing (#62768) | | bdc31675b7 | fix | ensure animate events do not have duplicate elements (#63216) | | de3a0c5cf3 | fix | Fix animate.enter class removal when composing classes (#62981) | | 6597ac0af7 | fix | fix support for space separated strings in leave animations (#62979) | | ebd622b344 | fix | fixes empty animations when recalculating styles (#63007) | | 455b147488 | fix | fixes timing issues with enter animations (#62925) | | f9d73cc687 | fix | handle cases where classes added have no animations (#63242) | | 6a1184600c | fix | prevents duplicate nodes when @if toggles with leave animations (#63048) | | 063b5e166f | fix | switch check to documentElement with chaining (#62773) | | 320de4e96d | refactor | deprecate animations field on component interface (#62895) |

  forms

  | Commit | Type | Description | | -- | -- | -- | | c353497a01 | feat | add support for pushing an array of controls to formarray (#57102) |

  http

  | Commit | Type | Description | | -- | -- | -- | | 0984b30388 | feat | Add redirected property to HttpResponse and HttpErrorResponse (#62675) | | be811fee79 | feat | add referrer & integrity support for fetch requests in httpResource (#62461) | | 1cf9d9064c | feat | Add support for fetch referrer & integrity options in HttpClient (#62417) | | 1408baff45 | fix | Add missing timeout and transferCache options to HttpClient (#62586) |

  language-service

  | Commit | Type | Description | | -- | -- | -- | | c81e345e72 | feat | support auto-import for attribute completions (#62797) | | d64dd27a02 | feat | support to report the deprecated API in the template (#62054) | | 591c7e2ec8 | fix | Support to resolve the re-export component. (#62585) |

  platform-browser

  | Commit | Type | Description | | -- | -- | -- | | 52b8e07d6e | feat | Warns on conflicting hydration and blocking navigation (#62963) |

  router

  | Commit | Type | Description | | -- | -- | -- | | d00b3fed58 | feat | add a currentNavigation signal to the Router service. (#62971) | | 687c374826 | feat | add a currentNavigation signal to the Router service. (#63011) | | 9c45c322d1 | fix | ensure preloaded components are properly activated (#62502) |

  service-worker

  | Commit | Type | Description | | -- | -- | -- | | 8255e0cf15 | feat | add messageerror event handling and logging (#62834) | | 5220b51e75 | feat | Adds for type in provideServiceWorker (#62831) | | 4ac6171b09 | feat | Adds support for updateViaCache in provideServiceWorker (#62721) | | b65c3d5e19 | feat | Improves storage full detection in data caching (#62737) | | 3b214d2040 | feat | Logs unhandled promise rejections in service worker (#63059) | | 6d011687ec | feat | notify clients about version failures (#62718) |

20.1.8 (2025-08-20)

compiler

20.1.7 (2025-08-13)

compiler

20.1.6 (2025-08-06)

20.1.5 (2025-08-06)

compiler-cli

20.1.4 (2025-07-31)

compiler

20.1.3 (2025-07-23)

core

20.1.2 (2025-07-17)

compiler

20.1.1 (2025-07-16)

compiler

20.1.0 (2025-07-09)

common

20.0.6 (2025-07-01)

20.0.5 (2025-06-25)

compiler-cli

20.0.4 (2025-06-18)

core

20.0.3 (2025-06-11)

20.0.2 (2025-06-06)

core

20.0.1 (2025-06-04)

compiler

20.0.0 (2025-05-28)

Blog post: https://blog.angular.dev/announcing-angular-v20-b5c9c06cf301

Breaking Changes

common

• Using the Y formatter (week-numbering year) without also including w (week number) is now detected as suspicious date pattern, as y is typically intended.
• AsyncPipe now directly catches unhandled errors in subscriptions and promises and reports them to the application's ErrorHandler. For Zone-based applications, these errors would have been caught by ZoneJS and reported to ErrorHandler so the result is generally the same. The change to the exact mechanism for reporting can result in differences in test environments that will require test updates.

  compiler

• 'in' in an expression now refers to the operator

• void in an expression now refers to the operator

  Previously an expression in the template like {{void}} referred to a property on the component class. After this change it now refers to the void operator, which would make the above example invalid. If you have existing expressions that need to refer to a property named void, change the expression to use this.void instead: {{this.void}}.

• Parenthesis are always respected.

  This can lead to runtime breakages when a nullish coalescing operator is nested within parentheses. eg. {{ (foo?.bar).baz }} will throw if foo is nullish. This is the same behavior as native JavaScript.

core

• TypeScript versions less than 5.8 are no longer supported.
• the TestBed.flushEffects() was removed - use the TestBed.tick() instead.
• provideExperimentalCheckNoChangesForDebug has several breaking changes:
  • It is renamed to provideCheckNoChangesConfig
  • The behavior applies to all checkNoChanges runs
  • The useNgZoneOnStable option is removed. This wasn't found to be generally more useful than interval
• provideExperimentalZonelessChangeDetection is renamed to provideZonelessChangeDetection as it is now "Developer Preview" rather than "Experimental".
• • InjectFlags has been removed.
  • inject no longer accepts InjectFlags.
  • Injector.get no longer accepts InjectFlags.
  • EnvironmentInjector.get no longer accepts InjectFlags.
  • TestBed.get no longer accepts InjectFlags.
  • TestBed.inject no longer accepts InjectFlags.
• • TestBed.get has been removed. Use TestBed.inject instead.
• afterRender was renamed to afterEveryRender.
• • Angular no longer supports Node.js v18.
  • Node.js versions 22.0 to 22.10 are also no longer supported.

  Before upgrading to Angular v20, ensure the Node.js version is at least 20.11.1. For the full list of supported versions, visit: https://angular.dev/reference/versions

• PendingTasks.run no longer returns the result of the async function. If this behavior is desired, it can be re-implemented manually with the PendingTasks.add. Be aware, however, that promise rejections will need to be handled or they can cause the node process to shut down when using SSR.
• Uncaught errors in listeners which were previously only reported to ErrorHandler are now also reported to Angular's internal error handling machinery. For tests, this means that the error will be rethrown by default rather than only logging the error. Developers should fix these errors, catch them in the test if the test is intentionally covering an error case, or use rethrowApplicationErrors: false in configureTestingModule as a last resort.
• The any overload has been removed from injector.get. It now only supports ProviderToken<T> and (deprecated since v4) string.
• Animations are guaranteed to be flushed when Angular runs automatic change detection or manual calls to ApplicationRef.tick. Prior to this change, animations would not be flushed in some situations if change detection did not run on any views attached to the application. This change can affect tests which may rely on the old behavior, often by making assertions on DOM elements that should have been removed but weren't because DOM removal is delayed until animations are flushed.
• ApplicationRef.tick will no longer catch and report errors to the appplication ErrorHandler. Errors will instead be thrown out of the method and will allow callers to determine how to handle these errors, such as aborting follow-up work or reporting the error and continuing.

• This commit deprecates ng-reflect-* attributes and updates the runtime to stop producing them by default. Please refactor application and test code to avoid relying on ng-reflect-* attributes.

  To enable a more seamless upgrade to v20, we've added the provideNgReflectAttributes() function (can be imported from the @angular/core package), which enables the mode in which Angular would be producing those attribites (in dev mode only). You can add the provideNgReflectAttributes() function to the list of providers within the bootstrap call.

  router

• The RedirectFn can now return Observable or Promise. Any code that directly calls functions returning this type may need to be adjusted to account for this.
• Several methods in the public API of the Router which required writable arrays have now been updated to accept readonly arrays when no mutations are done.
• The guards arrays on Route no longer include any in the type union. The union includes functions for the functional guards as well as a type matching Injector.get: ProviderToken<T>|string. Note that string is still deprecated on both the route guards and Injector.get.

  Deprecations

  core

• ngIf/ngFor/ngSwitch are deprecated. Use the control flow blocks instead (@for/@if/@switch).

  platform-browser

• All entries of the @angular/platform-browser-dynamic
• HammerJS support is deprecated and will be removed in a future major version.

  platform-server

• @angular/platform-server/testing

  Use e2e tests to verify SSR behavior instead.

  common

  | Commit | Type | Description | | -- | -- | -- | | 2e5362a469 | feat | accept undefined inputs in NgTemplateOutlet (#61404) | | b7d3f3dbfc | feat | Allow passing ScrollOptions to ViewportScroller (#61002) | | 74cceba587 | feat | throw error for suspicious date patterns (#59798) | | 255c79e048 | fix | cleanup updateLatestValue if view is destroyed before promise resolves (#58041) | | 739cadae62 | fix | Handle errors in async pipe subscriptions (#60057) | | cbbea70fa3 | fix | issue a warning instead of an error when NgOptimizedImage exceeds the preload limit (#60879) | | fc4a56d5c5 | fix | rename httpResource function in factory (#60022) | | 785a1110e6 | fix | resolve host binding type issues (#60481) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | 7a971766dc | feat | add extended diagnostic for uninvoked track function on @for blocks (#60495) | | f2d5cf7edd | feat | support exponentiation operator in templates (#59894) | | 51b8ff23ce | feat | support tagged template literals in expressions (#59947) | | 1b8e7ab9fe | feat | support the in keyword in Binary expression (#58432) | | 0361c2d81f | feat | support void operator in templates (#59894) | | 8b990a31c3 | fix | error if rawText isn't estimated correctly (#60529) | | 4fe489f1b4 | fix | exponentiation should be right-to-left associative (#60101) | | ef1fd137a9 | fix | incorrect spans for template literals (#60323) | | e0d378d20e | fix | incorrectly handling let declarations inside i18n (#60512) | | b70ad3c4e6 | fix | proper handling of typeof, void in RecursiveAstVisitor (#60101) | | e25e6c95a2 | fix | remove TypeScript from linker (#61635) | | 768239a89c | perf | reduce allocations for let declarations only used in the same view (#60512) |

  compiler-cli

  | Commit | Type | Description | | -- | -- | -- | | bec1610da2 | feat | add extended diagnostic for invalid nullish coalescing (#60279) | | c889382a20 | feat | detect missing structural directive imports (#59443) | | 1971e57a45 | feat | support type checking of host bindings (#60267) | | 9ec9c7e1b8 | fix | avoid fatal diagnostics for invalid module schemas (#61220) | | a1cacc5b17 | fix | avoid fatal diagnostics for missing template files (#58673) | | 1e6faad479 | fix | correctly parse event name in HostListener (#60561) | | ffb19e64f1 | fix | preserve required parens for nullish coalescing (#60060) | | 7c9b4892e9 | fix | preserve required parens in exponentiation expressions (#60101) | | 7e03af898e | fix | set correct target when type checking events (#60561) | | 2d51a203dc | fix | wrong event name for host listener decorators (#60460) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 22d3f0562c | feat | add hook for producer creation side effects (#60333) | | fe57332fc5 | feat | add input binding support to dynamically-created components (#60137) | | 65adb3024d | feat | Add provider which reports unhandled errors on window to ErrorHandler (#60704) | | b154fb3911 | feat | add support for two-way bindings on dynamically-created components (#60342) | | 82aa2c1a52 | feat | add the ability to apply directives to dynamically-created components (#60137) | | 326d48afb4 | feat | drop support for TypeScript older than 5.8 (#60197) | | d260ca3091 | feat | emit template function for template related profiler hooks (#60174) | | a4bad8d361 | feat | export signalGetFn from signal primitives (#60497) | | 4812215a7b | feat | Expose Injector.destroy on Injector created with Injector.create (#60054) | | c1bcae91dd | feat | expose performance data in Chrome DevTools (#60789) | | 809b5b4596 | feat | introduce new DI profiling event (#60158) | | d5fd7349fb | feat | introduce TestBed.tick() (#60993) | | 4e88e18a8e | feat | mark toObservable as stable (#60449) | | 727cda3856 | feat | mark linkedSignal API as public (#60865) | | 644d9f3bbd | feat | mark the toSignal API as stable (#60442) | | e711f99d81 | feat | move provideExperimentalCheckNoChangesForDebug to provideCheckNoChangesConfig (#60906) | | 7ccec1494f | feat | move DOCUMENT token into core (#60663) | | 953c4b2580 | feat | Move zoneless change detection to dev preview (#60748) | | 611baaf069 | feat | remove InjectFlags from public API (#60318) | | 5e209cb560 | feat | remove TestBed.get (#60414) | | d8fbb909ce | feat | rename afterRender to afterEveryRender and stabilize (#60999) | | 567522398f | feat | stabilize incremental hydration api (#60888) | | 8d050b5bfc | feat | stabilize linkedSignal API (#60741) | | 866cea9a05 | feat | Stabilize PendingTasks Injectable (#60716) | | bf8492b871 | feat | stabilize withI18nSupport() api (#60889) | | be44cc8f40 | feat | support listening to outputs on dynamically-created components (#60137) | | fe9b79b615 | feat | update Node.js version support (#60545) | | e170d24240 | fix | add migration away from InjectFlags (#60318) | | 7eb59d3887 | fix | added @angular/compiler as a peer dependency (#55610) | | 7232ce5b17 | fix | Catch and report rejections in async function of PendingTasks.run (#60044) | | fd12220a35 | fix | defer block render failures should report to application error handler (#60149) | | 3459faadbf | fix | do not allow setInput to be used with inputBinding (#60137) | | 0ac949c266 | fix | do not run change detection on global error events (#60944) | | 4fe34f4cfe | fix | enable stashing only when withEventReplay() is invoked (#61077) | | 962b59b14e | fix | Ensure ComponentFixture does not duplicate error reporting from FakeAsync (#60104) | | 7b819be83f | fix | Ensure errors in listeners report to the application error handler (#60251) | | ff772d7800 | fix | fix typing on injector.get to omit 'any' (#60202) | | 13d1c8ab38 | fix | fixes timing of hydration cleanup on control flow (#60425) | | 0b69b61929 | fix | Flush animations when no component has been checked (#58089) | | 3ba39bc28f | fix | getting resource value throws an error instead of returning undefined (#61441) | | ca6295e90b | fix | handle different DI token types in Chrome DevTools integration (#61333) | | 0162ceb427 | fix | inject migration should treat @Attribute as optional (#60916) | | ea5eb28865 | fix | input targeting not checking if input exists on host (#60137) | | c8951159ac | fix | mark zone.js as an optional peer dependency (#61616) | | d62379bb13 | fix | move reload method from Resource to WritableResource (#61441) | | a89f1cff24 | fix | narrow error type for resources API (#61441) | | 624be2ef0c | fix | prevent stash listener conflicts (#59635) | | 017cc0a37c | fix | properly handle app stabilization with defer blocks (#61040) | | 6e79eaf739 | fix | reading resource value after reload in the error state (#61441) | | 3d85d9363c | fix | reduce total memory usage of various migration schematics (#60774) | | 1c7b356625 | fix | release hasPendingTasks observers (#59723) | | 43cbc58254 | fix | remove forceRoot flag for effects (#60535) | | 48974c3cf8 | fix | remove rejectErrors option encourages uncaught exceptions (#60397) | | 491b0a4ead | fix | Remove duplicate reporting of errors in CDR.detectChanges (#60056) | | 04d963c0a5 | fix | remove unused parameter from listener instruction (#60406) | | 0ae1889560 | fix | run ApplicationRef.prototype.bootstrap in NgZone (#60720) | | a611b234d7 | fix | run root effects in creation order (#60534) | | 338818ce89 | fix | Surface errors from ApplicationRef.tick to callsite (#60102) | | 350776b412 | fix | TestBed.tick should ensure test components are synchronized (#61382) | | 3d4ddd2247 | fix | Testing should not throw when Zone does not patch test FW APIs (#61628) | | 30e081287d | fix | update min Node.js support to 20.19, 22.12, and 24.0 (#61500) | | b407157ee8 | refactor | Deprecate the structural directives ngIf/ngFor/ngSwitch. (#60492) | | c2987d8402 | refactor | stop producing ng-reflect attributes by default (#60973) |

  forms

  | Commit | Type | Description | | -- | -- | -- | | a07ee60989 | feat | add markAllAsDirty to AbstractControl (#58663) | | bdfbd54932 | feat | Allow to reset a form without emitting events (#60354) | | 81fe0536fd | fix | Make sure statusChanges is emitted (#57098) | | bdd5e20423 | fix | resolve host binding type issues (#60481) |

  http

  | Commit | Type | Description | | -- | -- | -- | | ccc5cc068f | feat | add keepalive support for fetch requests (#60621) | | 5795e03cdf | fix | Delay stabilization until next app synchronization (#60656) |

  platform-browser

  | Commit | Type | Description | | -- | -- | -- | | bc2cab747f | refactor | Deprecate the platform-browser-dynamic package (#61043) | | a980ac9a6a | refactor | Deprecate the HammerJS integration (#60257) |

  platform-server

  | Commit | Type | Description | | -- | -- | -- | | 2240a21c97 | refactor | deprecate the testing entry point (#60915) |

  router

  | Commit | Type | Description | | -- | -- | -- | | 0bb4bd661e | feat | Add ability to directly abort a navigation (#60380) | | 62de7d930a | feat | add asynchronous redirects (#60863) | | 7c12cb1df9 | feat | Allow resolvers to read resolved data from ancestors (#59860) | | ff98ccb193 | feat | support custom elements for RouterLink (#60290) | | 219f41d049 | fix | Prevent dangling promise rejections from internal navigations (#60162) | | 2419060fef | fix | relax required types on router commands to readonly array (#60345) | | c57951d58f | fix | Remove 'any' type from route guards (#60378) | | db2f2d99c8 | fix | Scroller should scroll as soon as change detection completes (#60086) |

19.2.14 (2025-05-28)

compiler

19.2.13 (2025-05-23)

common

19.2.12 (2025-05-21)

common

19.2.11 (2025-05-15)

19.2.10 (2025-05-07)

common

19.2.9 (2025-04-30)

core

19.2.8 (2025-04-23)

forms

19.2.7 (2025-04-16)

common

19.2.6 (2025-04-09)

compiler

19.2.5 (2025-04-02)

19.2.4 (2025-03-26)

core

19.2.3 (2025-03-19)

compiler-cli

19.2.2 (2025-03-12)

common

19.2.1 (2025-03-05)

common

19.2.0 (2025-02-26)

common

19.1.8 (2025-02-26)

benchpress

19.1.7 (2025-02-19)

common

19.1.6 (2025-02-12)

compiler

19.1.5 (2025-02-06)

compiler-cli

19.1.4 (2025-01-29)

core

19.1.3 (2025-01-22)

compiler

19.1.2 (2025-01-20)

compiler

19.1.1 (2025-01-16)

core

19.1.0 (2025-01-15)

common

19.0.7 (2025-01-15)

compiler-cli

19.0.6 (2025-01-08)

compiler-cli

19.0.5 (2024-12-18)

core

19.0.4 (2024-12-12)

compiler-cli

19.0.3 (2024-12-04)

19.0.2 (2024-12-04)

compiler-cli

18.2.13 (2024-11-26)

migrations

19.0.1 (2024-11-26)

compiler-cli

19.0.0 (2024-11-19)

Blog post: https://blog.angular.dev/meet-angular-v19-7b29dfd05b84

Breaking Changes

compiler

• this.foo property reads no longer refer to template context variables. If you intended to read the template variable, do not use this..
• changes to CSS selectors parsing where introduced, mainly to: pseudo selectors :where() and :is(), parsing of :host and host-context, parsing selectors within pseudo selector arguments (for instance comma separated selectors). These changes could lead to a different specificity of the resulting selectors and/or previously broken selectors being applied now, for example :where(:host) used to transform to :where()[ng-host] and is being :where([ng-host]) now. Unlike the previous outcome, the new result can target elements and therefore could lead to breakages.

  core

• Angular directives, components and pipes are now standalone by default.
  • Specify standalone: false for declarations that are currently declared in @NgModules.
  • ng update for v19 will take care of this automatically.
• TypeScript versions less than 5.5 are no longer supported.

• Timing changes for effect API (in developer preview):

  • effects which are triggered outside of change detection run as part of the change detection process instead of as a microtask. Depending on the specifics of application/test setup, this can result in them executing earlier or later (or requiring additional test steps to trigger; see below examples).

  • effects which are triggered during change detection (e.g. by input signals) run earlier, before the component's template.

• ExperimentalPendingTasks has been renamed to PendingTasks.

• The autoDetect feature of ComponentFixture will now attach the fixture to the ApplicationRef. As a result, errors during automatic change detection of the fixture be reported to the ErrorHandler. This change may cause custom error handlers to observe new failures that were previously unreported.

• createComponent will now render default fallback with empty projectableNodes.

  • When passing an empty array to projectableNodes in the createComponent API, the default fallback content of the ng-content will be rendered if present. To prevent rendering the default content, pass document.createTextNode('') as a projectableNode.

  // The first ng-content will render the default fallback content if present
  createComponent(MyComponent. { projectableNodes: [[], [secondNode]] });
  
  // To prevent projecting the default fallback content:
  createComponent(MyComponent. { projectableNodes: [[document.createTextNode('')], [secondNode]] });
  

• Errors that are thrown during ApplicationRef.tick will now be rethrown when using TestBed. These errors should be resolved by ensuring the test environment is set up correctly to complete change detection successfully. There are two alternatives to catch the errors:

  • Instead of waiting for automatic change detection to happen, trigger it synchronously and expect the error. For example, a jasmine test could write expect(() => TestBed.inject(ApplicationRef).tick()).toThrow()
  • TestBed will reject any outstanding ComponentFixture.whenStable promises. A jasmine test, for example, could write expectAsync(fixture.whenStable()).toBeRejected().

  As a last resort, you can configure errors to not be rethrown by setting rethrowApplicationErrors to false in TestBed.configureTestingModule.

• The timers that are used for zone coalescing and hybrid mode scheduling (which schedules an application state synchronization when changes happen outside the Angular zone) will now run in the zone above Angular rather than the root zone. This will mostly affect tests which use fakeAsync: these timers will now be visible to fakeAsync and can be affected by tick or flush.
• The deprecated factories property in KeyValueDiffers has been removed.

  elements

• as part of switching away from custom CD behavior to the hybrid scheduler, timing of change detection around custom elements has changed subtly. These changes make elements more efficient, but can cause tests which encoded assumptions about how or when elements would be checked to require updating.

  localize

• The name option in the ng add@localize schematic has been removed in favor of the project option.

  platform-browser

• The deprecated BrowserModule.withServerTransition method has been removed. Please use the APP_ID DI token to set the application id instead.

  router

• The Router.errorHandler property has been removed. Adding an error handler should be configured in either withNavigationErrorHandler with provideRouter or the errorHandler property in the extra options of RouterModule.forRoot. In addition, the error handler cannot be used to change the return value of the router navigation promise or prevent it from rejecting. Instead, if you want to prevent the promise from rejecting, use resolveNavigationPromiseOnError.
• The return type of the Resolve interface now includes RedirectCommand.

  common

  | Commit | Type | Description | | -- | -- | -- | | 24c6373820 | feat | add optional rounded transform support in cloudinary image loader (#55364) | | 50f08e6c4b | feat | automatically use sizes auto in NgOptimizedImage (#57479) | | 13c13067bc | feat | disable keyvalue sorting using null compareFn (#57487) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | a2e4ee0cb3 | feat | add diagnostic for unused standalone imports (#57605) | | 0c9d721ac1 | feat | add support for the typeof keyword in template expressions. (#58183) | | 09f589f000 | fix | this.a should always refer to class property a (#55183) | | 98804fd4be | fix | add more specific matcher for hydrate never block (#58360) | | b25121ee4a | fix | avoid having to duplicate core environment (#58444) | | 560282aa9b | fix | control flow nodes with root at the end projected incorrectly (#58607) | | 2be161d015 | fix | fix :host parsing in pseudo-selectors (#58681) | | 806a61b5a6 | fix | fix multiline selectors (#58681) | | a3cb530d84 | fix | handle typeof expressions in serializer (#58217) | | ba4340875a | fix | ignore placeholder-only i18n messages (#58154) | | e5d3abb298 | fix | resolve :host:host-context(.foo) (#58681) | | 80f56954ce | fix | transform chained pseudo-selectors (#58681) |

  compiler-cli

  | Commit | Type | Description | | -- | -- | -- | | d9687f43dd | feat | 'strictStandalone' flag enforces standalone (#57935) | | 9e87593055 | feat | ensure template style elements are preprocessed as inline styles (#57429) | | 231e6ff6ca | feat | generate the HMR replacement module (#58205) | | dbe612f2cd | fix | disable standalone by default on older versions of Angular (#58405) | | d4d76ead80 | fix | do not fail fatal when references to non-existent module are discovered (#58515) | | 33fe252c58 | fix | do not report unused declarations coming from an imported array (#57940) | | fb44323c51 | fix | incorrectly generating relative file paths on case-insensitive platforms (#58150) | | 22cd6869ef | fix | make the unused imports diagnostic easier to read (#58468) | | 9bbb01c85e | fix | report individual diagnostics for unused imports (#58589) | | 4716c3b966 | perf | reduce duplicate component style resolution (#57502) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 6ea8e1e9aa | feat | Add a schematics to migrate to standalone: false. (#57643) | | 3ebe6b4ad4 | feat | Add async run method on ExperimentalPendingTasks (#56546) | | 69fc5ae922 | feat | Add incremental hydration public api (#58249) | | 8ebbae88ca | feat | Add rxjs operator prevent app stability until an event (#56533) | | 19edf2c057 | feat | add syntactic sugar for initializers (#53152) | | c93b510f9b | feat | allow passing undefined without needing to include it in the type argument of input (#57621) | | ab25a192ba | feat | allow running output migration on a subset of paths (#58299) | | fc59e2a7b7 | feat | change effect() execution timing & no-op allowSignalWrites (#57874) | | 8bcc663a53 | feat | drop support for TypeScript 5.4 (#57577) | | 18d8d44b1f | feat | experimental resource() API for async dependencies (#58255) | | 9762b24b5e | feat | experimental impl of rxResource() (#58255) | | 6b8c494d05 | feat | flipping the default value for standalone to true (#58169) | | e6e5d29e83 | feat | initial version of the output migration (#57604) | | be2e49639b | feat | introduce afterRenderEffect (#57549) | | ec386e7f12 | feat | introduce debugName optional arg to framework signal functions (#57073) | | 8311f00faa | feat | introduce the reactive linkedSignal (#58189) | | 1b1519224d | feat | mark input, output and model APIs as stable (#57804) | | a7eff3ffaa | feat | mark signal-based query APIs as stable (#57921) | | a1f229850a | feat | migrate ExperimentalPendingTasks to PendingTasks (#57533) | | 3f1e7ab6ae | feat | promote outputFromObservable & outputToObservable to stable. (#58214) | | 97c44a1d6c | feat | Promote takeUntilDestroyed to stable. (#58200) | | e5adf92965 | feat | stabilize @let syntax (#57813) | | b063468027 | feat | support TypeScript 5.6 (#57424) | | 819ff034ce | feat | treat directives, pipes, components as by default (#58229) | | ee426c62f0 | fix | allow signal write error (#57973) | | c095679f92 | fix | avoid breaking change with apps using rxjs 6.x (#58341) | | 71ee81af2c | fix | clean up event contract once hydration is done (#58174) | | f03d274e87 | fix | ComponentFixture autoDetect feature works like production (#55228) | | 950a5540f1 | fix | Ensure the ViewContext is retained after closure minification (#57903) | | 7b1e5be20b | fix | fallback to default ng-content with empty projectable nodes. (#57480) | | 0300dd2e18 | fix | Fix fixture.detectChanges with autoDetect disabled and zoneless (#57416) | | 5fe57d4fbb | fix | fixes issues with control flow and incremental hydration (#58644) | | 51933ef5a6 | fix | prevent errors on contract cleanup (#58614) | | fd7716440b | fix | Prevents trying to trigger incremental hydration on CSR (#58366) | | 656b5d3e78 | fix | Re-assign error codes to be within core bounds (<1000) (#53455) | | 6e0af6dbbb | fix | resolve forward-referenced host directives during directive matching (#58492) | | 468d3fb9b1 | fix | rethrow errors during ApplicationRef.tick in TestBed (#57200) | | 226a67dabb | fix | Schedulers run in zone above Angular rather than root (#57553) | | 97fb86d331 | perf | set encapsulation to None for empty component styles (#57130) | | c15ec36bd1 | refactor | remove deprecated factories Property in KeyValueDiffers (#58064) |

  elements

  | Commit | Type | Description | | -- | -- | -- | | fe5c4e086a | fix | support output()-shaped outputs (#57535) | | 0cebfd7462 | fix | switch to ComponentRef.setInput & remove custom scheduler (#56728) |

  forms

  | Commit | Type | Description | | -- | -- | -- | | 3e7d724037 | feat | add ability to clear a FormRecord (#50750) | | 18b6f3339f | fix | fix FormRecord type inference (#50750) |

  http

  | Commit | Type | Description | | -- | -- | -- | | 4b9accdf16 | feat | promote withRequestsMadeViaParent to stable. (#58221) | | 057cf7fb6b | fix | preserve all headers from Headers object (#57802) |

  language-service

  | Commit | Type | Description | | -- | -- | -- | | 8da9fb49b5 | feat | add code fix for unused standalone imports (#57605) | | 1f067f4507 | feat | add code reactoring action to migrate @Input to signal-input (#57214) | | 56ee47f2ec | feat | allow code refactorings to compute edits asynchronously (#57214) | | bc83fc1e2e | feat | support converting to signal queries in VSCode extension (#58106) | | 5c4305f024 | feat | support migrating full classes to signal inputs in VSCode (#57975) | | 6342befff8 | feat | support migrating full classes to signal queries (#58263) | | 7ecfd89592 | fix | The suppress diagnostics option should work for external templates (#57873) |

  localize

  | Commit | Type | Description | | -- | -- | -- | | 9c3bd1b5d1 | refactor | remove deprecated name option. (#58063) |

  migrations

  | Commit | Type | Description | | -- | -- | -- | | dff4de0f75 | feat | add a combined migration for all signals APIs (#58259) | | b6bc93803c | feat | add schematic to migrate to signal queries (#58032) | | 2bfc64daf1 | feat | expose output as function migration (#58299) | | 59fe9bc772 | feat | introduce signal input migration as ng generate schematic (#57805) | | 90c7ec39a0 | fix | inject migration always inserting generated variables before super call (#58393) | | 7a65cdd911 | fix | inject migration not inserting generated code after super call in some cases (#58393) | | c1aa411cf1 | fix | properly resolve tsconfig paths on windows (#58137) | | e26797b38e | fix | replace removed NgModules in tests with their exports (#58627) |

  platform-browser

  | Commit | Type | Description | | -- | -- | -- | | c36a1c023b | fix | correctly add external stylesheets to ShadowDOM components (#58482) | | 5c61f46409 | refactor | remove deprecated BrowserModule.withServerTransition method (#58062) |

  platform-server

  | Commit | Type | Description | | -- | -- | -- | | 9e82559de4 | fix | destroy PlatformRef when error happens during the bootstrap() phase (#58112) |

  router

  | Commit | Type | Description | | -- | -- | -- | | f271021e19 | feat | Add routerOutletData input to RouterOutlet directive (#57051) | | b2790813a6 | fix | Align RouterModule.forRoot errorHandler with provider error handler (#57050) | | a49c35ec76 | fix | remove setter for injector on OutletContext (#58343) | | 7436d3180e | fix | Update Resolve interface to include RedirectCommand like ResolveFn (#57309) |

  service-worker

  | Commit | Type | Description | | -- | -- | -- | | 8ddce80a0b | feat | allow specifying maxAge for entire application (#49601) | | 1479af978c | feat | finish implementation of refreshAhead feature (#53356) |

18.2.12 (2024-11-14)

compiler-cli

18.2.11 (2024-11-06)

core

18.2.10 (2024-10-30)

compiler

18.2.9 (2024-10-23)

compiler-cli

18.2.8 (2024-10-10)

compiler

18.2.7 (2024-10-02)

common

18.2.6 (2024-09-25)

18.2.5 (2024-09-18)

compiler-cli

18.2.4 (2024-09-11)

compiler

18.2.3 (2024-09-04)

http

18.2.2 (2024-08-28)

core

18.2.1 (2024-08-22)

core

18.2.0 (2024-08-14)

compiler

18.1.5 (2024-08-14)

compiler-cli

18.1.4 (2024-08-07)

compiler

18.1.3 (2024-07-31)

compiler

18.1.2 (2024-07-24)

compiler

18.1.1 (2024-07-17)

common

17.3.12 (2024-07-17)

compiler

18.1.0 (2024-07-10)

common

18.0.7 (2024-07-10)

compiler

18.0.6 (2024-07-03)

common

18.0.5 (2024-06-26)

core

18.0.4 (2024-06-20)

compiler-cli

18.0.3 (2024-06-12)

benchpress

18.0.2 (2024-06-05)

core

18.0.1 (2024-05-29)

compiler

17.3.10 (2024-05-22)

18.0.0 (2024-05-22)

Blog post "Angular v18 is now available".

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.
• 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.

  animations

  | Commit | Type | Description | | -- | -- | -- | | bcce85af72 | refactor | remove deprecated matchesElement from AnimationDriver (#55479) |

  common

  | Commit | Type | Description | | -- | -- | -- | | d34c033902 | refactor | Deprecate Local Data API functions (#54483) | | 3b0de30b37 | refactor | remove deprecated isPlatformWorkerApp and isPlatformWorkerUi API (#55302) |

  compiler

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

  compiler-cli

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

  core

  | Commit | Type | Description | | -- | -- | -- | | a730f09ae9 | feat | Add a public API to establish events to be replayed and an attribute to mark an element with an event handler. (#55356) | | fdd560ea14 | feat | Add ability to configure zone change detection to use zoneless scheduler (#55252) | | bce5e2344f | feat | Add build target for jsaction contract binary. (#55319) | | 666d646575 | feat | Add event delegation library to queue up events and replay them when the application is ready (#55121) | | 5f06ca8f55 | feat | add HOST_TAG_NAME token (#54751) | | a600a39d0c | feat | add support for fallback content in ng-content (#54854) | | 146306a141 | feat | add support for i18n hydration (#54823) | | f09c5a7bc4 | feat | Add zoneless change detection provider as experimental (#55329) | | d28614b90e | feat | Modify EventType from an enum to an object. (#55323) | | ac863ded48 | feat | provide ExperimentalPendingTasks API (#55487) | | 1ee9f32621 | feat | Synchronize changes from internal JSAction codebase. (#55182) | | d888da4606 | fix | ApplicationRef.tick should respect OnPush for host bindings (#53718) | | 64f870c12b | fix | ApplicationRef.tick should respect OnPush for host bindings (#53718) (#53718) | | 8cad4e8cbe | fix | ComponentFixture autoDetect respects OnPush flag of host view (#54824) | | 658cf8c384 | fix | ComponentFixture stability should match ApplicationRef (#54949) | | 2fc11eae9e | fix | account for re-projected ng-content elements with fallback content (#54854) | | 0cbd73c6e9 | fix | add warning when using zoneless but zone.js is still loaded (#55769) | | d5edfde6ee | fix | afterRender hooks registered outside change detection can mark views dirty (#55623) | | de7447d15e | fix | Angular should not ignore changes that happen outside the zone (#55102) | | ba8e465974 | fix | Change Detection will continue to refresh views while marked for check (#54734) | | 5a10f405d3 | fix | complete the removal of deprecation async function (#55491) | | 24bc0ed4f2 | fix | ComponentFixture autodetect should detect changes within ApplicationRef.tick (#54733) | | 1c0ec56c46 | fix | correctly project single-root content inside control flow (#54921) | | 840c375255 | fix | do not save point-in-time setTimeout and rAF references (#55124) | | 10c5cdb49c | fix | ensure change detection runs in a reasonable timeframe with zone coalescing (#54578) | | ad045efd4b | fix | Ensure views marked for check are refreshed during change detection (#54735) | | 69085ea26e | fix | error about provideExperimentalCheckNoChangesForDebug uses wrong name (#55824) | | 0147e0b85a | fix | exhaustive checkNoChanges should only do a single pass (#55839) | | e02bcf89cf | fix | Fix clearing of pending task in zoneless cleanup implementation (#55074) | | 0cec9e4f9a | fix | Fix null dereference error addEvent (#55353) | | 44c0ed83a6 | fix | hide implementation details of ExperimentalPendingTasks (#55516) | | 314112de99 | fix | Prevent markForCheck during change detection from causing infinite loops (#54900) | | a5fa279b6e | fix | prevent i18n hydration from cleaning projected nodes (#54823) | | 6534c035c0 | fix | Remove deprecated Testability methods (#53768) | | a5c57c7484 | fix | resolve error for multiple component instances that use fallback content (#55478) | | f44a5e4604 | fix | support content projection and VCRs in i18n (#54823) | | 0510930a25 | fix | TestBed should not override NgZone from initTestEnvironment (#55226) | | e9a0c86766 | fix | TestBed should not override NgZone from initTestEnvironment (#55226) | | 700c0520bb | fix | Update ApplicationRef.tick loop to only throw in dev mode (#54848) | | a99cb7ce5b | fix | zoneless scheduler should check if Zone is defined before accessing it (#55118) | | 1fd63e9cff | refactor | deprecate `@Component.interpolation` (#55778) |

  forms

  | Commit | Type | Description | | -- | -- | -- | | 1c736dc3b2 | feat | Unified Control State Change Events (#54579) | | 61007dced0 | fix | Add event for forms submitted & reset (#55667) | | 2e27ca9ddf | fix | Allow canceled async validators to emit. (#55134) |

  http

  | Commit | Type | Description | | -- | -- | -- | | 6f88d80758 | feat | allow caching requests with different origins between server and client (#55274) | | 8eacb6e4b9 | feat | exclude caching for authenticated HTTP requests (#55034) | | d9b339fdbc | fix | resolve withRequestsMadeViaParent behavior with withFetch (#55652) | | ef665a40a5 | refactor | Deprecate HttpClientModule & related modules (#54020) |

  language-service

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

  migrations

  | Commit | Type | Description | | -- | -- | -- | | f914f6a362 | feat | Migration schematics for HttpClientModule (#54020) | | 8459ee46cb | fix | handle more cases in HttpClientModule migration (#55640) | | c4b2f18709 | fix | migrate HttpClientTestingModule in test modules (#55803) | | bb4a4016a9 | fix | preserve existing properties in HttpClientModule migration (#55777) | | f93e5180be | fix | resolve multiple structural issues with HttpClient migration (#55557) |

  platform-browser

  | Commit | Type | Description | | -- | -- | -- | | 45ae7a6b60 | feat | add withI18nSupport() in developer preview (#55130) | | 23f914f101 | fix | Use the right namespace for mathML. (#55622) | | cba336d4f1 | refactor | remove deprecated transfer state APIs (#55474) |

  platform-browser-dynamic

  | Commit | Type | Description | | -- | -- | -- | | eb20c1a8b1 | refactor | unused RESOURCE_CACHE_PROVIDER API has been removed (#54875) |

  platform-server

  | Commit | Type | Description | | -- | -- | -- | | 5674c644ab | fix | add nonce attribute to event record script (#55495) | | e71e869112 | fix | remove event dispatch script from HTML when hydration is disabled (#55681) | | 07ac017731 | refactor | remove deprecated platformDynamicServer API (#54874) | | e8b588d8b7 | refactor | remove deprecated ServerTransferStateModule API (#54874) | | 3b1967ca64 | refactor | remove deprecated useAbsoluteUrl and baseUrl from PlatformConfig (#54874) | | 2357d3566c | refactor | remove legacy URL handling logic (#54874) |

  router

  | Commit | Type | Description | | -- | -- | -- | | 4a42961393 | feat | withNavigationErrorHandler can convert errors to redirects (#55370) | | 8735af08b9 | feat | Add ability to return UrlTree with NavigationBehaviorOptions from guards (#45023) | | 87f3f27f90 | feat | Allow resolvers to return RedirectCommand (#54556) | | 2b802587f2 | feat | Allow Route.redirectTo to be a function which returns a string or UrlTree (#52606) | | 60f1d681e0 | fix | preserve replaceUrl when returning a urlTree from CanActivate (#54042) | | 3839cfbb18 | fix | Routed components never inherit RouterOutlet EnvironmentInjector (#54265) | | da906fdafc | fix | Routed components never inherit RouterOutlet EnvironmentInjector (#54265) |

  service-worker

  | Commit | Type | Description | | -- | -- | -- | | 3bc63eaaf3 | fix | avoid running CDs on controllerchange (#54222) | | e598634c10 | fix | remove controllerchange listener when app is destroyed (#55365) |