Angular - The modern web developer's platform

Angular is a development platform for building mobile and desktop web applications
using TypeScript/JavaScript and other languages.

angular.dev

Contributing Guidelines · Submit an Issue · Blog

Documentation

Get started with Angular, learn the fundamentals and explore advanced topics on our documentation website.

• Getting Started
• Architecture
• Components and Templates
• Forms
• API

Advanced

• Angular Elements
• Server Side Rendering
• Schematics
• Lazy Loading
• Animations

Local Development

To contribute to the Angular Docs, check out the Angular.dev README

Development Setup

Prerequisites

• Install Node.js which includes Node Package Manager

Setting Up a Project

Install the Angular CLI globally:

npm install -g @angular/cli

Create workspace:

ng new [PROJECT NAME]

Run the application:

cd [PROJECT NAME]
ng serve

Angular is cross-platform, fast, scalable, has incredible tooling, and is loved by millions.

Quickstart

Get started in 5 minutes.

Ecosystem

• Angular Command Line (CLI)
• Angular Material

Changelog

Learn about the latest improvements.

Upgrading

Check out our upgrade guide to find out the best way to upgrade your project.

Contributing

Contributing Guidelines

Read through our contributing guidelines to learn about our submission process, coding rules, and more.

Want to Help?

Want to report a bug, contribute some code, or improve the documentation? Excellent! Read up on our guidelines for contributing and then check out one of our issues labeled as <kbd>help wanted</kbd> or <kbd>good first issue</kbd>.

Code of Conduct

Help us keep Angular open and inclusive. Please read and follow our Code of Conduct.

Community

Join the conversation and help the community.

• X (formerly Twitter)
• Discord
• Gitter
• YouTube
• StackOverflow
• Find a Local Meetup

Love Angular? Give our repo a star :star: :arrow_up:.

19.1.2 (2025-01-20)

compiler

19.1.1 (2025-01-16)

core

19.1.0 (2025-01-15)

common

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) |

17.3.9 (2024-05-15)

17.3.8 (2024-05-08)

compiler

17.3.7 (2024-05-01)

compiler-cli

17.3.6 (2024-04-25)

core

17.3.5 (2024-04-17)

17.3.4 (2024-04-10)

common

17.3.2 (2024-03-28)

compiler

17.3.1 (2024-03-20)

compiler

17.3.0 (2024-03-13)

compiler

17.2.4 (2024-03-06)

compiler-cli

17.2.3 (2024-02-27)

common

17.2.2 (2024-02-21)

common

17.2.1 (2024-02-14)

compiler-cli

17.2.0 (2024-02-14)

common

17.1.3 (2024-02-08)

compiler-cli

17.1.2 (2024-01-31)

#

17.1.1 (2024-01-24)

router

17.1.0 (2024-01-17)

compiler

17.0.9 (2024-01-10)

common

17.0.8 (2023-12-21)

compiler

17.0.7 (2023-12-13)

compiler

17.0.6 (2023-12-06)

compiler

17.0.5 (2023-11-29)

core

17.0.4 (2023-11-20)

common

17.0.3 (2023-11-15)

animations

17.0.2 (2023-11-09)

compiler-cli

17.0.1 (2023-11-08)

http

Web Frameworks: the internet frontier.
These are the voyages of the framework Angular.
Its continuing mission:
To explore strange, new technologies.
To seek out new users and new applications.
To boldly go where no web framework has gone before.

In honor of v17.0.1

                                                  ______
                                     ___.--------'------`---------.____
                               _.---'----------------------------------`---.__
                             .'___=]===========================================
,-----------------------..__/.'         >--.______        _______.---'
]====================<==||(__)        .'          `------'
`-----------------------`' ----.___--/
     /       /---'                 `/
    /_______(______________________/
    `-------------.--------------.'
                   \________|_.-'

Live long and prosper 🖖🏻

17.0.0 (2023-11-08)

Blog post "Angular v17 is now available".

Breaking Changes

#

• 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: https://github.com/nodejs/release#release-schedule

  common

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

  core

• Angular now requires zone.js version ~0.14.0
• Versions of TypeScript older than 5.2 are no longer supported.

• 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]);

• 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

• 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,
  }]

• 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: https://angular.io/guide/hydration#how-to-skip-hydration-for-particular-components.

  router

• 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.
• 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.
• urlHandlingStrategy has been removed from the Router public API. This should instead be configured through the provideRouter or RouterModule.forRoot APIs.

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

• The setupTestingRouter function has been removed. Use RouterModule.forRoot or provideRouter to setup the Router for tests instead.
• malformedUriErrorHandler is no longer available in the RouterModule.forRoot options. URL parsing errors should instead be handled in the UrlSerializer.parse method.

  zone.js

• 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

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

  core

• ChangeDetectorRef.checkNoChanges is deprecated.

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

• 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 (see NgTemplateOutlet as an example).

  Also adds a warning if the 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.

  #

  | Commit | Type | Description | | -- | -- | -- | | 59aa0634f4 | build | remove support for Node.js v16 (#51755) |

  animations

  | Commit | Type | Description | | -- | -- | -- | | e753278faa | feat | Add the possibility of lazy loading animations code. (#50738) | | 698c058e1c | fix | remove code duplication between entry-points (#51500) | | 0598613950 | refactor | deprecation of AnimationDriver.NOOP (#51843) |

  benchpress

  | Commit | Type | Description | | -- | -- | -- | | 2da3551a70 | feat | report gc and render time spent in script (#50771) |

  common

  | Commit | Type | Description | | -- | -- | -- | | fe2fd7e1a8 | feat | make the warning for lazy-loaded lcp image an error (#51748) | | dde3fdabbd | feat | upgrade warning to logged error for lazy-loaded LCP images using NgOptimizedImage (#52004) | | da056a1fe2 | fix | add missing types field for @angular/common/locales of exports in package.json (#52080) | | 85843e8212 | fix | allow to specify only some properties of DatePipeConfig (#51287) | | 3bd85fb7b0 | fix | apply fixed_srcset_width value only to fixed srcsets (#52459) | | 65b460448e | fix | missing space in ngSwitch equality warning (#52180) | | 86c5e34601 | fix | remove code duplication between entry-points (#51500) | | 28a5925f53 | fix | use === operator to match NgSwitch cases (#51504) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | 1934524a0c | feat | add docs extraction for type aliases (#52118) | | 7f6d9a73ab | feat | expand class api doc extraction (#51733) | | a7fa25306f | feat | extract api docs for interfaces (#52006) | | 7bfe20707f | feat | extract api for fn overloads and abtract classes (#52040) | | c7daf7ea16 | feat | extract directive docs info (#51733) | | e0b1bb33d7 | feat | extract doc info for JsDoc (#51733) | | b9c70158ab | feat | extract docs for accessors, rest params, and types (#51733) | | a24ae994a0 | feat | extract docs for top level functions and consts (#51733) | | 2e41488296 | feat | extract docs info for enums, pipes, and NgModules (#51733) | | 34495b3533 | feat | extract docs via exports (#51828) | | 7e82df45c5 | feat | initial skeleton for API doc extraction (#51733) | | 6795cccbbb | fix | account for type-only imports in defer blocks (#52343) | | 23bfa10ac8 | fix | add diagnostic for inaccessible deferred trigger (#51922) | | 31295a3cf9 | fix | allocating unnecessary slots in conditional instruction (#51913) | | 2aaddd3f64 | fix | allow comments between switch cases (#52449) | | ddd9df68bb | fix | allow decimals in defer block time values (#52433) | | 7dbd47fb30 | fix | allow newlines in track and let expressions (#52137) | | 0eae992c4e | fix | allow nullable values in for loop block (#51997) | | 073ebfe09e | fix | apply style on :host attributes in prod builds. (#49118) | | 81a287a79a | fix | avoid error in template parser for tag names that can occur in object prototype (#52225) | | 6c58252521 | fix | compilation error when for loop block expression contains new line (#52447) | | 9d19c8e317 | fix | don't allocate variable to for loop expression (#52158) | | 9acd2ac98b | fix | enable block syntax in the linker (#51979) | | 1d871c03a5 | fix | forward referenced dependencies not identified as deferrable (#52017) | | 16ff08ec70 | fix | narrow the type of expressions in event listeners inside if blocks (#52069) | | ac0d5dcfd6 | fix | narrow the type of expressions in event listeners inside switch blocks (#52069) | | 02edb43067 | fix | narrow the type of the aliased if block expression (#51952) | | 83067b3ef2 | fix | ng-template directive invoke twice at the root of control flow (#52515) | | 17078a3fe1 | fix | pipes used inside defer triggers not being picked up (#52071) | | 861ce3a7c5 | fix | pipes using DI not working in blocks (#52112) | | 1f5039bbd6 | fix | project control flow root elements into correct slot (#52414) | | 81c315ec6e | fix | template type checking not reporting diagnostics for incompatible type comparisons (#52322) | | 1beef49d80 | fix | update the minVersion if component uses block syntax (#51979) | | 386e1e9500 | fix | work around TypeScript bug when narrowing switch statements (#52110) | | e5bca43224 | perf | further reduce bundle size using arrow functions (#52010) |

  compiler-cli

  | Commit | Type | Description | | -- | -- | -- | | 5b66330329 | fix | allow non-array imports for standalone component in local compilation mode (#51819) | | 377a7abfda | fix | bypass static resolving of the component's changeDetection field in local compilation mode (#51848) | | 19c3dc18d3 | fix | fix NgModule injector def in local compilation mode when imports/exports are non-array expressions (#51819) | | 11bb19cafc | fix | handle nested qualified names in ctor injection in local compilation mode (#51947) | | f91f222b55 | fix | resolve component encapsulation enum in local compilation mode (#51848) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 59b6ec6be8 | docs | Deprecate ChangeDetectorRef.checkNoChanges (#52431) | | 4f04d1cdab | feat | add new list reconcilation algorithm (#51980) | | c7127b98b5 | feat | add schematic to escape block syntax characters (#51905) | | 50275e58b8 | feat | Add schematic to migrate control flow syntax (#52035) | | 81b67aa987 | feat | add support for zone.js 0.14.0 (#51774) | | 048f400efc | feat | add warnings for oversized images and lazy-lcp (#51846) | | 93675dc797 | feat | conditional built-in control flow (#51346) | | 4427e1ebc2 | feat | create function to assert not running inside reactive context (#52049) | | e23aaa7d75 | feat | drop support for older TypeScript versions (#51792) | | 43e6fb0606 | feat | enable block syntax (#51994) | | 3cbb2a8ecf | feat | implement deferred block interaction triggers (#51830) | | 8be2c48b7c | feat | implement new block syntax (#51891) | | a54713c831 | feat | implement ɵgetInjectorMetadata debug API (#51900) | | 5b88d136af | feat | mark core signal APIs as stable (#51821) | | 8eef694def | feat | Provide a diagnostic for missing Signal invocation in template interpolation. (#49660) | | 40113f653c | feat | Remove deprecated CompilerOptions.useJit andCompilerOptions.missingTranslation. (#49672) | | 68ba798ae3 | feat | revamp the runtime error message for orphan components to include full component info (#51919) | | 1a4aee7e49 | feat | show runtime error for orphan component rendering (#52061) | | 687b96186c | feat | support deferred hover triggers (#51874) | | e2e3d69a27 | feat | support deferred triggers with implicit triggers (#51922) | | 16f5fc40a4 | feat | support deferred viewport triggers (#51874) | | 59387ee476 | feat | support styles and styleUrl as strings (#51715) | | 9cc52b9b85 | feat | support TypeScript 5.2 (#51334) | | 7d42dc3c02 | feat | the new list reconciliation algorithm for built-in for (#51980) | | 935c1816fd | fix | add rejectErrors option to toSignal (#52474) | | 5411864c2e | fix | adjust toSignal types to handle more common cases (#51991) | | dcf18dc74c | fix | allow toSignal calls in reactive context (#51831) | | dbffdc09c2 | fix | avoid duplicated code between entry-points (primary, testing, rxjs-interop) (#51500) | | 4f69d620d9 | fix | deferred blocks not removing content immediately when animations are enabled (#51971) | | df58c0b714 | fix | disallow afterRender in reactive contexts (#52138) | | 5d61221ed7 | fix | disallow using effect inside reactive contexts (#52138) | | 99e7629159 | fix | do not remove used ng-template nodes in control flow migration (#52186) | | c7ff9dff2c | fix | drop mutate function from the signals public API (#51821) | | 00128e3853 | fix | drop mutate function from the signals public API (#51821) (#51986) | | ddef3ac9a4 | fix | effects wait for ngOnInit for their first run (#52473) | | 5ead7d412d | fix | ensure a consumer drops all its stale producers (#51722) | | 1dd8558f82 | fix | Ensure backwards-referenced transplanted views are refreshed (#51854) | | 50ad074505 | fix | framework debug APIs getDependenciesForTokenInInjector and getInjectorMetadata (#51719) | | 80e7a0f8fa | fix | guard usages of performance.mark (#52505) | | b9ea2d6900 | fix | handle aliased index with no space in control flow migration (#52444) | | ffe9b1fcc2 | fix | handle for alias with as in control flow migration (#52183) | | e5720edb46 | fix | handle if alias in control flow migration (#52181) | | 4461cefa4f | fix | handle trackBy and aliased index in control flow migration (#52423) | | 7368b8aaeb | fix | host directive validation not picking up duplicate directives on component node (#52073) | | 696f003553 | fix | mutation bug in getDependenciesFromInjectable (#52450) | | d487014785 | fix | Remove no longer needed build rule related to removed migration (#52143) | | 4da08dc2ef | fix | remove unnecessary migration (#52141) | | 384d7aacd0 | fix | replace assertion with more intentional error (#52427) | | 40bb45f329 | fix | Respect OnPush change detection strategy for dynamically created components (#51356) | | 3a19d6b743 | fix | run afterRender callbacks outside of the Angular zone (#51385) | | a2ba5482c3 | fix | use TNode instead of LView for mapping injector providers (#52436) | | d5dad3eb4c | fix | viewport trigger deregistering callbacks multiple times (#52115) | | 8e4a7ab52b | perf | avoid repeated access to LContainer and trackBy calculation (#52227) | | 1dc14d9853 | perf | avoid unnecessary callbacks in after render hooks (#52292) | | e90694259e | perf | build-in for should update indexes only when views were added / removed (#52051) | | 1032c1e1a5 | perf | cache LiveCollectionLContainerImpl (#52227) | | 685d01e106 | perf | chain template instructions (#51546) | | 88a0af64fd | perf | generate arrow functions for pure function calls (#51668) | | 37d627dbd4 | perf | minimze trackBy calculations (#52227) | | 3861a73135 | perf | Update LView consumer to only mark component for check (#52302) | | 9b9e11fcaf | refactor | deprecate allowing full context object to be replaced in EmbeddedViewRef (#51887) | | ba9fc2419e | refactor | deprecate the NgProbeToken (#51396) |

  http

  | Commit | Type | Description | | -- | -- | -- | | 7dde42a5df | feat | allow customization of the HttpTransferCache. (#52029) | | 8156b3d4ec | fix | Don't override the backend when using the InMemoryWebAPI (#52425) | | bd9e91ecf7 | perf | reduce data transfer when using HTTP caching (#52347) |

  language-service

  | Commit | Type | Description | | -- | -- | -- | | 449830f24e | feat | Complete inside @switch (#52153) | | e2416a284f | feat | Enable go to definition of styleUrl (#51746) | | 023a181ba5 | feat | Implement outlining spans for control flow blocks (#52062) | | 7c052bb6ef | feat | Support autocompletion for blocks (#52121) | | 9d565cd6d6 | fix | Autocomplete block keywords in more cases (#52198) |

  localize

  | Commit | Type | Description | | -- | -- | -- | | 5a20a44c64 | fix | ng-add schematics for application builder (#51777) |

  migrations

  | Commit | Type | Description | | -- | -- | -- | | f0da7c2e44 | feat | schematic to remove deprecated CompilerOptions properties (#49672) | | 965ce5a8c5 | feat | Schematics for TransferState, StateKey and makeStateKey migration. (#49594) | | 09e905ad67 | fix | account for separator characters inside strings (#52525) | | 4c878f90d2 | fix | Add support for nested structures inside a switch statement (#52358) | | d7397fb29b | fix | Ensure control flow migration ignores new block syntax (#52402) | | 6a01d62b9d | fix | fix broken migration when no control flow is present (#52399) | | 9c2be715a3 | fix | Fixes a bug in the ngFor pre-v5 alias translation (#52531) | | 54fed68bbf | fix | Fixes the root level template offset in control flow migration (#52355) | | 57404d4723 | fix | handle comma-separated syntax in ngFor (#52525) | | 54bc384661 | fix | handle nested classes in block entities migration (#52309) | | c9b1ddff4d | fix | handle nested classes in control flow migration (#52309) | | 6988a0070e | fix | handle ngIf else condition with no whitespaces (#52504) | | e40e55d902 | fix | Remove unhelpful parsing errors from the log (#52401) | | c267f54bc3 | fix | Update regex to better match ng-templates (#52529) |

  platform-browser

  | Commit | Type | Description | | -- | -- | -- | | c340d6e044 | feat | enable removal of styles on component destroy by default (#51571) | | c5daa6ce77 | feat | expose EventManagerPlugin in the public API. (#49969) | | 5b375d106f | fix | Fire Animations events when using async animations. (#52087) | | 65786b2b96 | fix | prevent duplicate stylesheets from being created (#52019) | | 75d610d420 | fix | set animation properties when using async animations. (#52087) | | 3c0577f991 | perf | disable styles of removed components instead of removing (#51808) | | c9cde3ab10 | perf | only append style element on creation (#52237) | | dbc14eb41d | refactor | remove withNoDomReuse function (#52057) |

  platform-server

  | Commit | Type | Description | | -- | -- | -- | | 0c66e2424c | fix | resolve relative requests URL (#52326) |

  router

  | Commit | Type | Description | | -- | -- | -- | | 1da28f4825 | feat | Add callback to execute when a view transition is created (#52002) | | 73e4bf2ed2 | feat | Add feature to support the View Transitions API (#51314) | | 86e91463af | feat | Add option to skip the first view transition (#51825) | | ce1b915868 | fix | Allow redirects after an absolute redirect (#51731) | | 37df395be0 | fix | children of routes with loadComponent should not inherit parent data by default (#52114) | | 4dce8766f8 | fix | Ensure newly resolved data is inherited by child routes (#52167) | | f464e39364 | fix | Ensure title observable gets latest values (#51561) | | b2aff43621 | fix | Remove urlHandlingStrategy from public Router properties (#51631) | | c62e680098 | fix | Remove deprecated Router properties (#51502) | | 3c6258c85b | fix | Remove deprecated setupTestingRouter function (#51826) | | 0b3e6a41d0 | fix | Remove malformedUriErrorHandler from ExtraOptions (#51745) | | c03baed854 | fix | use DOCUMENT token instead of document directly in view transitions (#51814) |

16.2.12 (2023-11-02)

animations

16.2.11 (2023-10-25)

core

16.2.10 (2023-10-18)

16.2.9 (2023-10-11)

forms

16.2.8 (2023-10-04)

language-service

15.2.10 (2023-10-04)

service-worker

16.2.7 (2023-09-27)

core

16.2.6 (2023-09-20)

core

16.2.5 (2023-09-13)

16.2.4 (2023-09-06)

16.2.3 (2023-08-30)

animations

16.2.2 (2023-08-23)

common

16.2.1 (2023-08-16)

router

16.2.0 (2023-08-09)

benchpress

16.1.9 (2023-08-09)

16.1.8 (2023-08-02)

compiler

16.1.7 (2023-07-26)

http

16.1.6 (2023-07-19)

http

16.1.5 (2023-07-13)

animations

16.1.4 (2023-07-06)

core

16.1.3 (2023-06-28)

core

16.1.2 (2023-06-21)

http

16.1.1 (2023-06-14)

compiler-cli

16.1.0 (2023-06-13)

compiler

16.0.6 (2023-06-13)

core

16.0.5 (2023-06-08)

compiler

16.0.4 (2023-06-01)

animations

16.0.3 (2023-05-24)

core

16.0.2 (2023-05-17)

core

16.0.1 (2023-05-10)

core

16.0.0 (2023-05-03)

Blog post "Angular v16 is now available".

Breaking Changes

#

• Angular Compatibility Compiler (ngcc) has been removed and as a result Angular View Engine libraries will no longer work
• Deprecated EventManager method addGlobalEventListener has been removed as it is not used by Ivy.

  bazel

• Several changes to the Angular Package Format (APF)
  • Removal of FESM2015
  • Replacing ES2020 with ES2022
  • Replacing FESM2020 with FESM2022
• Several changes to the Angular Package Format (APF)
  • Removal of FESM2015
  • Replacing ES2020 with ES2022
  • Replacing FESM2020 with FESM2022

    common

• MockPlatformLocation is now provided by default in tests. Existing tests may have behaviors which rely on BrowserPlatformLocation instead. For example, direct access to the window.history in either the test or the component rather than going through the Angular APIs (Location.getState()). The quickest fix is to update the providers in the test suite to override the provider again TestBed.configureTestingModule({providers: [{provide: PlatformLocation, useClass: BrowserPlatformLocation}]}). The ideal fix would be to update the code to instead be compatible with MockPlatformLocation instead.

• If the 'ngTemplateOutletContext' is different from the context, it will result in a compile-time error.

  Before the change, the following template was compiling:

  interface MyContext {
   $implicit: string;
  }
  
  @Component({
   standalone: true,
   imports: [NgTemplateOutlet],
   selector: 'person',
   template: `
     <ng-container
       *ngTemplateOutlet="
         myTemplateRef;
         context: { $implicit: 'test', xxx: 'xxx' }
       "></ng-container>
   `,
  })
  export class PersonComponent {
   myTemplateRef!: TemplateRef<MyContext>;
  }

  However, it does not compile now because the 'xxx' property does not exist in 'MyContext', resulting in the error: 'Type '{ $implicit: string; xxx: string; }' is not assignable to type 'MyContext'.'

  The solution is either:

  • add the 'xxx' property to 'MyContext' with the correct type or
  • add '$any(...)' inside the template to make the error disappear. However, adding '$any(...)' does not correct the error but only preserves the previous behavior of the code.
• Deprecated XhrFactory export from @angular/common/http has been removed. Use XhrFactory from @angular/common instead.

  compiler

• • TypeScript 4.8 is no longer supported.

    core

• QueryList.filter now supports type guard functions, which will result in type narrowing. Previously if you used type guard functions, it resulted in no changes to the return type. Now the type would be narrowed, which might require updates to the application code that relied on the old behavior.
• zone.js versions 0.11.x and 0.12.x are not longer supported.
• • entryComponents has been deleted from the @NgModule and @Component public APIs. Any usages can be removed since they weren't doing anyting.
  • ANALYZE_FOR_ENTRY_COMPONENTS injection token has been deleted. Any references can be removed.
• ComponentRef.setInput will only set the input on the component if it is different from the previous value (based on Object.is equality). If code relies on the input always being set, it should be updated to copy objects or wrap primitives in order to ensure the input value differs from the previous call to setInput.
• RendererType2.styles no longer accepts a nested arrays.

• The APP_ID token value is no longer randomly generated. If you are bootstrapping multiple application on the same page you will need to set to provide the APP_ID yourself.

  bootstrapApplication(ComponentA, {
    providers: [
     { provide: APP_ID, useValue: 'app-a' },
     // ... other providers ...
    ]
  });

• The ReflectiveInjector and related symbols were removed. Please update the code to avoid references to the ReflectiveInjector symbol. Use Injector.create as a replacement to create an injector instead.

• Node.js v14 support has been removed

  Node.js v14 is planned to be End-of-Life on 2023-04-30. Angular will stop supporting Node.js v14 in Angular v16. Angular v16 will continue to officially support Node.js versions v16 and v18.

  platform-browser

• The deprecated BrowserTransferStateModule was removed, since it's no longer needed. The TransferState class can be injected without providing the module. The BrowserTransferStateModule was empty starting from v14 and you can just remove the reference to that module from your applications.

  platform-server

• Users that are using SSR with JIT mode will now need to add import to @angular/compiler before bootstrapping the application.

  NOTE: this does not effect users using the Angular CLI.

• renderApplication method no longer accepts a root component as first argument. Instead, provide a bootstrapping function that returns a Promise<ApplicationRef>.

  Before

  const output: string = await renderApplication(RootComponent, options);

  Now

  const bootstrap = () => bootstrapApplication(RootComponent, appConfig);
  const output: string = await renderApplication(bootstrap, options);

• renderModuleFactory has been removed. Use renderModule instead.

  router

• The Scroll event's routerEvent property may also be a NavigationSkipped event. Previously, it was only a NavigationEnd event.
• ComponentFactoryResolver has been removed from Router APIs. Component factories are not required to create an instance of a component dynamically. Passing a factory resolver via resolver argument is no longer needed and code can instead use ViewContainerRef.createComponent without the factory resolver.
• The RouterEvent type is no longer present in the Event union type representing all router event types. If you have code using something like filter((e: Event): e is RouterEvent => e instanceof RouterEvent), you'll need to update it to filter((e: Event|RouterEvent): e is RouterEvent => e instanceof RouterEvent).
• Tests which mock ActivatedRoute instances may need to be adjusted because Router.createUrlTree now does the right thing in more scenarios. This means that tests with invalid/incomplete ActivatedRoute mocks may behave differently than before. Additionally, tests may now navigate to a real URL where before they would navigate to the root. Ensure that tests provide expected routes to match. There is rarely production impact, but it has been found that relative navigations when using an ActivatedRoute that does not appear in the current router state were effectively ignored in the past. By creating the correct URLs, this sometimes resulted in different navigation behavior in the application. Most often, this happens when attempting to create a navigation that only updates query params using an empty command array, for example router.navigate([], {relativeTo: route, queryParams: newQueryParams}). In this case, the relativeTo property should be removed.

  Deprecations

  core

• makeStateKey, StateKey and TransferState exports have been moved from @angular/platform-browser to @angular/core. Please update the imports.

  - import {makeStateKey, StateKey, TransferState} from '@angular/platform-browser';
  + import {makeStateKey, StateKey, TransferState} from '@angular/core';

• EnvironmentInjector.runInContext is now deprecated, with runInInjectionContext functioning as a direct replacement:

  // Previous method version (deprecated):
  envInjector.runInContext(fn);
  // New standalone function:
  runInInjectionContext(envInjector, fn);

• The @Directive/@Component moduleId property is now deprecated. It did not have any effect for multiple major versions and will be removed in v17.

  platform-browser

• BrowserModule.withServerTransition has been deprecated. APP_ID should be used instead to set the application ID. NB: Unless, you render multiple Angular applications on the same page, setting an application ID is not necessary.

  Before:

  imports: [
    BrowserModule.withServerTransition({ appId: 'serverApp' }),
    ...
  ]

  After:

  imports: [
    BrowserModule,
    { provide: APP_ID, useValue: 'serverApp' },
    ...
  ],

• ApplicationConfig has moved, please import ApplicationConfig from @angular/core instead.

  platform-server

• PlatformConfig.baseUrl and PlatformConfig.useAbsoluteUrl platform-server config options are deprecated as these were not used.

  #

  | Commit | Type | Description | | -- | -- | -- | | 48aa96ea13 | refactor | remove Angular Compatibility Compiler (ngcc) (#49101) | | 2703fd6260 | refactor | remove deprecated EventManager method addGlobalEventListener (#49645) |

  common

  | Commit | Type | Description | | -- | -- | -- | | 5dce2a5a3a | feat | Provide MockPlatformLocation by default in BrowserTestingModule (#49137) | | d47fef72cb | fix | strict type checking for ngtemplateoutlet (#48374) | | c41a21658c | refactor | remove deprecated XhrFactory export from http entrypoint (#49251) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | 1a6ca68154 | feat | add support for compile-time required inputs (#49304) | | 13dd614cd1 | feat | add support for compile-time required inputs (#49453) | | 8f539c11f4 | feat | add support for compile-time required inputs (#49468) | | 79cdfeb392 | feat | drop support for TypeScript 4.8 (#49155) | | 1407a9aeaf | feat | support multiple configuration files in extends (#49125) | | 9de1e9da8f | fix | incorrectly matching directives on attribute bindings (#49713) | | 6623810e4d | fix | Produce diagnositc if directive used in host binding is not exported (#49527) |

  compiler-cli

  | Commit | Type | Description | | -- | -- | -- | | 03d1d00ad9 | feat | Add an extended diagnostic for nSkipHydration (#49512) | | ed817e32fe | fix | Catch FatalDiagnosticError during template type checking (#49527) | | 49fe974501 | perf | optimize NgModule emit for standalone components (#49837) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 89d291c367 | feat | add assertInInjectionContext (#49529) | | 4e9531f777 | feat | add mergeApplicationConfig method (#49253) | | d7d6514add | feat | Add ability to configure NgZone in bootstrapApplication (#49557) | | bc5ddabdcb | feat | add Angular Signals to the public API (#49150) | | 17e9862653 | feat | add API to provide CSP nonce for inline stylesheets (#49444) | | 605c536420 | feat | add migration to remove moduleId references (#49496) | | 99d874fe3b | feat | add support for TypeScript 5.0 (#49126) | | d1617c449d | feat | allow removal of previously registered DestroyRef callbacks (#49493) | | b2327f4df1 | feat | Allow typeguards on QueryList.filter (#48042) | | 061f3d1086 | feat | Drop public factories property for IterableDiffers : Breaking change (#49598) | | fdf61974d1 | feat | drop support for zone.js versions <=0.12.0 (#49331) | | 9c5fd50de4 | feat | effects can optionally return a cleanup function (#49625) | | c024574f46 | feat | expose makeStateKey, StateKey and TransferState (#49563) | | a5f1737d1c | feat | expose onDestroy on ApplicationRef (#49677) | | e883198460 | feat | implement takeUntilDestroyed in rxjs-interop (#49154) | | 0814f20594 | feat | introduce runInInjectionContext and deprecate prior version (#49396) | | 0f5c8003cc | feat | introduce concept of DestroyRef (#49158) | | 9b65b84cb9 | feat | Mark components for check if they read a signal (#49153) | | 8997bdc03b | feat | prototype implementation of @angular/core/rxjs-interop (#49154) | | 585e34bf6c | feat | remove entryComponents (#49484) | | aad05ebeb4 | feat | support usage of non-experimental decorators with TypeScript 5.0 (#49492) | | 6d7be42da7 | fix | add newline to hydration mismatch error (#49965) | | f8e25864e8 | fix | allow async functions in effects (#49783) | | 84216dabfc | fix | catch errors from source signals outside of .next (#49769) | | be23b7ce65 | fix | ComponentRef.setInput only sets input when not equal to previous (#49607) | | 316c91b1a4 | fix | deprecate moduleId @Component property (#49496) | | fd9dcd36cd | fix | Ensure effects can be created when Zone is not defined (#49890) | | 9180f98f0e | fix | ensure takeUntilDestroyed unregisters onDestroy listener on unsubscribe (#49901) | | 4721c48a24 | fix | error if document body is null (#49818) | | 2650f1afc1 | fix | execute input setters in non-reactive context (#49906) | | f8b95b9da6 | fix | execute query setters in non-reactive context (#49906) | | ef91a2e0fe | fix | execute template creation in non-reactive context (#49883) | | 87549af73c | fix | Fix capitalization of toObservableOptions (#49832) | | 0e5f9ba6f4 | fix | generate consistent component IDs (#48253) | | fedc75624c | fix | include inner ViewContainerRef anchor nodes into ViewRef.rootNodes output (#49867) | | df1dfc4c17 | fix | make sure that lifecycle hooks are not tracked (#49701) | | c34d7e0822 | fix | onDestroy should be registered only on valid DestroyRef (#49804) | | 2f2ef14f9e | fix | resolve InitialRenderPendingTasks promise on complete (#49784) | | c7d8d3ee37 | fix | toObservable should allow writes to signals in the effect (#49769) | | b4531f1d82 | fix | typing of TestBed Common token. (#49997) | | a4e749ffca | fix | When using setInput, mark view dirty in same was as markForCheck (#49711) | | 9b9c818f99 | perf | change RendererType2.styles to accept a only a flat array (#49072) | | 82d6fbb109 | refactor | generate a static application ID (#49422) | | 3b863ddc1e | refactor | Remove ReflectiveInjector symbol (#48103) | | f594725951 | refactor | remove Node.js v14 support (#49255) |

  forms

  | Commit | Type | Description | | -- | -- | -- | | 07a1aa3004 | feat | Improve typings form (async)Validators (#48679) |

  http

  | Commit | Type | Description | | -- | -- | -- | | aff1512950 | feat | allow HttpClient to cache requests (#49509) | | 15c91a53ae | fix | delay accessing pendingTasks.whenAllTasksComplete (#49784) | | 9f0c6d1ed1 | fix | ensure new cache state is returned on each request (#49749) | | 45a6ac09fd | fix | force macro task creation during HTTP request (#49546) | | 2a580b6f0b | fix | HTTP cache was being disabled prematurely (#49826) | | 2eb9b8b402 | fix | wait for all XHR requests to finish before stabilizing application (#49776) |

  migrations

  | Commit | Type | Description | | -- | -- | -- | | 5e5dac278d | feat | Migration to remove Router guard and resolver interfaces (#49337) |

  platform-browser

  | Commit | Type | Description | | -- | -- | -- | | 761e02d912 | feat | add a public API function to enable non-destructive hydration (#49666) | | 630af63fae | feat | deprecate withServerTransition call (#49422) | | 81e7d15ef6 | feat | enable HTTP request caching when using provideClientHydration (#49699) | | 74c925c19c | fix | export deprecated TransferState as type (#50015) | | 2312eb53ef | fix | KeyEventsPlugin should keep the same behavior (#49330) | | c934a8e72b | fix | only add ng-app-id to style on server side (#49465) | | 9165ff2517 | fix | reuse server generated component styles (#48253) | | e8e36811d5 | fix | set nonce attribute in a platform compatible way (#49624) | | 3aa85a8087 | refactor | move ApplicationConfig to core (#49253) | | 9bd9a11f4e | refactor | remove deprecated BrowserTransferStateModule symbol (#49718) |

  platform-server

  | Commit | Type | Description | | -- | -- | -- | | b5278cc115 | feat | renderApplication now accepts a bootstrapping method (#49248) | | 056d68002f | feat | add provideServerSupport function to provide server capabilities to an application (#49380) | | 7870fb07fe | feat | rename provideServerSupport to provideServerRendering (#49678) | | a08a8ff108 | fix | bundle @angular/domino in via esbuild (#49229) | | 5ea624f313 | fix | remove dependency on @angular/platform-browser-dynamic (#50064) | | e99460865e | refactor | deprecate useAbsoluteUrl and baseUrl (#49546) | | 41f27ad086 | refactor | remove renderApplication overload that accepts a component (#49463) | | 17abe6dc96 | refactor | remove deprecated renderModuleFactory (#49247) |

  router

  | Commit | Type | Description | | -- | -- | -- | | ea32c3289a | feat | Expose information about the last successful Navigation (#49235) | | 455c728525 | feat | helper functions to convert class guards to functional (#48709) | | f982a3f965 | feat | Opt-in for binding Router information to component inputs (#49633) | | 1f055b90b6 | fix | Ensure anchor scrolling happens on ignored same URL navigations (#48025) | | 6193a3d406 | fix | fix = not parsed in router segment name (#47332) | | c0b1b7becf | fix | Remove deprecated ComponentFactoryResolver from APIs (#49239) | | 1e32709e0e | fix | remove RouterEvent from Event union type (#46061) | | 3c7e637374 | fix | Route matching should only happen once when navigating (#49163) | | 1600687fe5 | fix | Route matching should only happen once when navigating (#49163) | | 31f210bf2c | fix | Router.createUrlTree should work with any ActivatedRoute (#48508) |

  service-worker

  | Commit | Type | Description | | -- | -- | -- | | 5e7fc259ea | feat | add function to provide service worker (#48247) |