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.

www.angular.io

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

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.

• Twitter
• Discord
• Gitter
• YouTube
• StackOverflow
• Find a Local Meetup

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

15.2.9 (2023-05-03)

common

15.2.8 (2023-04-19)

core

15.2.7 (2023-04-12)

compiler

15.2.6 (2023-04-05)

core

15.2.5 (2023-03-29)

common

15.2.4 (2023-03-22)

core

15.2.3 (2023-03-16)

Special Thanks

Alan Agius, Esteban Gehring, Matthieu Riegler and Virginia Dooley

15.2.2 (2023-03-08)

migrations

15.2.1 (2023-03-01)

common

15.2.0 (2023-02-22)

Deprecations

• Class and InjectionToken guards and resolvers are deprecated. Instead, write guards as plain JavaScript functions and inject dependencies with inject from @angular/core.
  | Commit | Type | Description | | -- | -- | -- | | 926c35f4ac | docs | Deprecate class and InjectionToken and resolvers (#47924) |

  common

  | Commit | Type | Description | | -- | -- | -- | | 54b24eb40f | feat | Add loaderParams attribute to NgOptimizedImage (#48907) |

  compiler-cli

  | Commit | Type | Description | | -- | -- | -- | | 0cf11167f1 | fix | incorrectly detecting forward refs when symbol already exists in file (#48988) |

  core

  | Commit | Type | Description | | -- | -- | -- | | a154db8a81 | feat | add ng generate schematic to convert declarations to standalone (#48790) | | 345e737daa | feat | add ng generate schematic to convert to standalone bootstrapping APIs (#48848) | | e7318fc758 | feat | add ng generate schematic to remove unnecessary modules (#48832) |

  language-service

  | Commit | Type | Description | | -- | -- | -- | | 4ae384fd61 | feat | Allow auto-imports of a pipe via quick fix when its selector is used, both directly and via reexports. (#48354) | | 141333411e | feat | Introduce a new NgModuleIndex, and use it to suggest re-exports. (#48354) | | d0145033bd | fix | generate forwardRef for same file imports (#48898) |

  migrations

  | Commit | Type | Description | | -- | -- | -- | | 2796230e95 | fix | add enum in mode option in standalone schema (#48851) | | 816e76a578 | fix | automatically prune root module after bootstrap step (#49030) | | bdbf21d04b | fix | avoid generating imports with forward slashes (#48993) | | 32cf4e5cb9 | fix | avoid internal modules when generating imports (#48958) | | 521ccfbe6c | fix | avoid interrupting the migration if language service lookup fails (#49010) | | a40cd47aa7 | fix | avoid modifying testing modules without declarations (#48921) | | 1afa6ed322 | fix | don't add ModuleWithProviders to standalone test components (#48987) | | c98c6a8452 | fix | don't copy animations modules into the imports of test components (#49147) | | 8389557848 | fix | don't copy unmigrated declarations into imports array (#48882) | | f82bdc4b01 | fix | don't delete classes that may provide dependencies transitively (#48866) | | 759db12e0b | fix | duplicated comments on migrated classes (#48966) | | ba38178d19 | fix | generate forwardRef for same file imports (#48898) | | 03fcb36cfd | fix | migrate HttpClientModule to provideHttpClient() (#48949) | | 2de6dae16d | fix | migrate RouterModule.forRoot with a config object to use features (#48935) | | 770191cf1f | fix | migrate tests when switching to standalone bootstrap API (#48987) | | c7926b5773 | fix | move standalone migrations into imports (#48987) | | 65c74ed93e | fix | normalize paths to posix (#48850) | | 6377487b1a | fix | only exclude bootstrapped declarations from initial standalone migration (#48987) | | e9e4449a43 | fix | preserve tsconfig in standalone migration (#48987) | | ffad1b49d9 | fix | reduce number of files that need to be checked (#48987) | | ba7a757cc5 | fix | return correct alias when conflicting import exists (#49139) | | 49a7c9f94a | fix | standalone migration incorrectly throwing path error for multi app projects (#48958) | | 584976e6c8 | fix | support --defaults in standalone migration (#48921) | | 03f47ac901 | fix | use consistent quotes in generated imports (#48876) | | ebae506d89 | fix | use import remapper in root component (#49046) | | 40c976c909 | fix | use NgForOf instead of NgFor (#49022) | | 4ac25b2aff | perf | avoid re-traversing nodes when resolving bootstrap call dependencies (#49010) | | 26cb7ab2e6 | perf | speed up language service lookups (#49010) |

  platform-browser

  | Commit | Type | Description | | -- | -- | -- | | bf4ad38117 | fix | remove styles from DOM of destroyed components (#48298) |

  platform-server

  | Commit | Type | Description | | -- | -- | -- | | 25e220a23a | fix | avoid duplicate TransferState info after renderApplication call (#49094) |

  router

  | Commit | Type | Description | | -- | -- | -- | | 31b94c762f | feat | Add a withNavigationErrorHandler feature to provideRouter (#48551) | | dedac8d3f7 | feat | Add test helper for trigger navigations in tests (#48552) |

  Special Thanks

  Alan Agius, Alex Castle, Alex Rickabaugh, Andrew Kushnir, Andrew Scott, Dylan Hunn, Ikko Eltociear Ashimine, Ilyass, Jessica Janiuk, Joey Perrott, John Manners, Kalbarczyk, Kristiyan Kostadinov, Matthieu Riegler, Paul Gschwendtner, Pawel Kozlowski, Virginia Dooley, Walid Bouguima, cexbrayat and mgechev

15.1.5 (2023-02-15)

forms

15.1.4 (2023-02-08)

Special Thanks

Jessica Janiuk, Kian Yang Lee, Matthieu Riegler, Redouane Bekkouche and Simona Cotin

15.1.3 (2023-02-02)

animations

15.1.2 (2023-01-25)

compiler

15.1.1 (2023-01-18)

common

15.1.0 (2023-01-10)

Deprecations

router

• CanLoad guards in the Router are deprecated. Use CanMatch instead.

• router writable properties

  The following strategies are meant to be configured by registering the application strategy in DI via the providers in the root NgModule or bootstrapApplication:

  • routeReuseStrategy
  • titleStrategy
  • urlHandlingStrategy

  The following options are meant to be configured using the options available in RouterModule.forRoot or provideRouter.

  • onSameUrlNavigation
  • paramsInheritanceStrategy
  • urlUpdateStrategy
  • canceledNavigationResolution

  The following options are available in RouterModule.forRoot but not available in provideRouter:

  • malformedUriErrorHandler - This was found to not be used anywhere internally.
  • errorHandler - Developers can instead subscribe to Router.events and filter for NavigationError.

    common

    | Commit | Type | Description | | -- | -- | -- | | fe50813664 | feat | Add BrowserPlatformLocation to the public API (#48488) | | 2f4f0638c7 | fix | Add data attribtue to NgOptimizedImage (#48497) |

    compiler

    | Commit | Type | Description | | -- | -- | -- | | a532d71975 | feat | allow self-closing tags on custom elements (#48535) | | caf7228f8a | fix | resolve deprecation warning (#48652) | | 33f35b04ef | fix | type-only symbols incorrectly retained when downlevelling custom decorators (#48638) |

    compiler-cli

    | Commit | Type | Description | | -- | -- | -- | | caedef0f5b | fix | update @babel/core dependency and lock version (#48634) |

    core

    | Commit | Type | Description | | -- | -- | -- | | 6acae1477a | feat | Add TestBed.runInInjectionContext to help test functions which use inject (#47955) | | 38421578a2 | feat | Make the isStandalone() function available in public API (#48114) | | dd42974b07 | feat | support TypeScript 4.9 (#48005) |

    forms

    | Commit | Type | Description | | -- | -- | -- | | 8aa8b4b77c | fix | Form provider FormsModule.withConfig return a FormsModule (#48526) |

    language-service

    | Commit | Type | Description | | -- | -- | -- | | 5f0b53c735 | feat | Allow auto-imports to suggest multiple possible imports. (#47787) | | 6a8ea29a04 | fix | expose package.json for vscode extension resolution (#48678) | | ce8160ecb2 | fix | Prevent crashes on unemitable references (#47938) | | e615b598ba | fix | ship /api entry-point (#48670) | | 6ce7d76a0e | fix | update packages/language-service/build.sh script to work with vscode-ng-language-service's new Bazel build (#48663) |

    localize

    | Commit | Type | Description | | -- | -- | -- | | a1a8e91eca | fix | add triple slash type reference on @angular/localize on `ng add (#48502) |

    migrations

    | Commit | Type | Description | | -- | -- | -- | | cc284afbbc | fix | combine newly-added imports in import manager (#48620) |

    router

    | Commit | Type | Description | | -- | -- | -- | | 228e992db7 | docs | Deprecate canLoad guards in favor of canMatch (#48180) | | 0a8b8a66cd | docs | Deprecate public members of Router that are meant to be configured elsewhere (#48006) | | 332461bd0c | feat | Add ability to override onSameUrlNavigation default per-navigation (#48050) | | f58ad86e51 | feat | Add feature provider for enabling hash navigation (#48301) | | 73f03ad2d2 | feat | Add new NavigationSkipped event for ignored navigations (#48024) | | 3fe75710d9 | fix | page refresh should not destroy history state (#48540) |

    Special Thanks

    Alan Agius, Alex Castle, Alex Rickabaugh, Andrew Kushnir, Andrew Scott, Bob Watson, Charles Lyding, Derek Cormier, Doug Parker, Dylan Hunn, George Kalpakas, Greg Magolan, Jessica Janiuk, JiaLiPassion, Joey Perrott, Kristiyan Kostadinov, Matthieu Riegler, Paul Gschwendtner, Pawel Kozlowski, Renan Ferro, Tim Gates, Vadim, Virginia Dooley, ced, mgechev, piyush132000, robertIsaac and sr5434

15.0.4 (2022-12-14)

animations

15.0.3 (2022-12-07)

common

15.0.2 (2022-11-30)

compiler-cli

15.0.1 (2022-11-22)

common

12.2.17 (2022-11-22)

Breaking Changes

core

• Existing iframe usages may have security-sensitive attributes applied as an attribute or property binding in a template or via host bindings in a directive. Such usages would require an update to ensure compliance with the new stricter rules around iframe bindings.

  core

  | Commit | Type | Description | | -- | -- | -- | | b871db57da | fix | hardening attribute and property binding rules for <iframe> elements (#48059) |

  Special Thanks

  Andrew Kushnir, Andrew Scott, George Looshch, Joey Perrott and Paul Gschwendtner

13.3.12 (2022-11-21)

Breaking Changes

core

• Existing iframe usages may have security-sensitive attributes applied as an attribute or property binding in a template or via host bindings in a directive. Such usages would require an update to ensure compliance with the new stricter rules around iframe bindings.

  core

  | Commit | Type | Description | | -- | -- | -- | | b1d7b79ff4 | fix | hardening attribute and property binding rules for <iframe> elements (#48029) |

  Special Thanks

  Andrew Kushnir, Andrew Scott, George Looshch, Joey Perrott and Paul Gschwendtner

14.2.12 (2022-11-21)

Breaking Changes

core

• Existing iframe usages may have security-sensitive attributes applied as an attribute or property binding in a template or via host bindings in a directive. Such usages would require an update to ensure compliance with the new stricter rules around iframe bindings.

  core

  | Commit | Type | Description | | -- | -- | -- | | 54814c8e9b | fix | hardening attribute and property binding rules for <iframe> elements (#48028) |

  Special Thanks

  Andrew Kushnir

15.0.0 (2022-11-16)

Blog post "Angular v15 is now available".

Breaking Changes

compiler

• Keyframes names are now prefixed with the component's "scope name". For example, the following keyframes rule in a component definition, whose "scope name" is host-my-cmp:

  @keyframes foo { ... }

  will become:

  @keyframes host-my-cmp_foo { ... }

  Any TypeScript/JavaScript code which relied on the names of keyframes rules will no longer match.

  The recommended solutions in this case are to either:

  • change the component's view encapsulation to the None or ShadowDom
  • define keyframes rules in global stylesheets (e.g styles.css)
  • define keyframes rules programmatically in code.

    compiler-cli

• Invalid constructors for DI may now report compilation errors

  When a class inherits its constructor from a base class, the compiler may now report an error when that constructor cannot be used for DI purposes. This may either be because the base class is missing an Angular decorator such as @Injectable() or @Directive(), or because the constructor contains parameters which do not have an associated token (such as primitive types like string). These situations used to behave unexpectedly at runtime, where the class may be constructed without any of its constructor parameters, so this is now reported as an error during compilation.

  Any new errors that may be reported because of this change can be resolved either by decorating the base class from which the constructor is inherited, or by adding an explicit constructor to the class for which the error is reported.

• Angular compiler option enableIvy has been removed as Ivy is the only rendering engine.

  core

• Angular no longer supports Node.js versions 14.[15-19].x and 16.[10-12].x. Current supported versions of Node.js are 14.20.x, 16.13.x and 18.10.x.
• TypeScript versions older than 4.8 are no longer supported.
• Existing iframe usages may have security-sensitive attributes applied as an attribute or property binding in a template or via host bindings in a directive. Such usages would require an update to ensure compliance with the new stricter rules around iframe bindings.
• Existing iframe usages may have src or srcdoc preceding other attributes. Such usages may need to be updated to ensure compliance with the new stricter rules around iframe bindings.

  forms

• setDisabledState will always be called when a ControlValueAccessor is attached. You can opt-out with FormsModule.withConfig or ReactiveFormsModule.withConfig.

  localize

• • canParse method has been removed from all translation parsers in @angular/localize/tools. analyze should be used instead.
  • the hint parameter in theparse methods is now mandatory.

    router

• Previously, the RouterOutlet would immediately instantiate the component being activated during navigation. Now the component is not instantiated until the change detection runs. This could affect tests which do not trigger change detection after a router navigation. In rarer cases, this can affect production code that relies on the exact timing of component availability.
• The title property is now required on ActivatedRouteSnapshot
• relativeLinkResolution is no longer configurable in the Router. This option was used as a means to opt out of a bug fix.

  Deprecations

  common

• The DATE_PIPE_DEFAULT_TIMEZONE token is now deprecated in favor of the DATE_PIPE_DEFAULT_OPTIONS token, which accepts an object as a value and the timezone can be defined as a field (called timezone) on that object.

  core

• • The ability to pass an NgModule to the providedIn option for @Injectable and InjectionToken is now deprecated.

  providedIn: NgModule was intended to be a tree-shakable alternative to NgModule providers. It does not have wide usage, and in most cases is used incorrectly, in circumstances where providedIn: 'root' should be preferred. If providers should truly be scoped to a specific NgModule, use NgModule.providers instead.

  • The ability to set providedIn: 'any' for an @Injectable or InjectionToken is now deprecated.

  providedIn: 'any' is an option with confusing semantics and is almost never used apart from a handful of esoteric cases internal to the framework.

• The bit field signature of Injector.get() has been deprecated, in favor of the new options object.
• The bit field signature of TestBed.inject() has been deprecated, in favor of the new options object.

  router

• The RouterLinkWithHref directive is deprecated, use the RouterLink directive instead. The RouterLink contains the code from the RouterLinkWithHref to handle elements with href attributes.

  common

  | Commit | Type | Description | | -- | -- | -- | | c0c7efaf7c | feat | add provideLocationMocks() function to provide Location mocks (#47674) | | 75e6297f09 | feat | add <link> preload tag on server for priority img (#47343) | | 4fde292bb5 | feat | Add automatic srcset generation to ngOptimizedImage (#47547) | | 9483343ebf | feat | Add fill mode to NgOptimizedImage (#47738) | | bdb5371033 | feat | add injection token for default DatePipe configuration (#47157) | | 449d29b701 | fix | Add fetchpriority to ngOptimizedImage preloads (#48010) | | 4f52d4e474 | fix | don't generate srcset if noopImageLoader is used (#47804) | | 3a18398d83 | fix | Don't warn about image distortion is fill mode is enabled (#47824) | | edea15f2c6 | fix | export the IMAGE_CONFIG token (#48051) | | 8abf1c844c | fix | fix formatting on oversized image error (#47188) | | ca7bf65933 | fix | rename rawSrc -> ngSrc in NgOptimizedImage directive (#47362) | | b3879dbf14 | fix | support density descriptors with 2+ decimals (#47197) | | fa4798095e | fix | update size error to mention 'fill' mode (#47797) | | 23f210c0ab | fix | warn if using supported CDN but not built-in loader (#47330) | | 945432e3fa | fix | Warn on fill ngOptimizedImage without height (#48036) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | 051f75648d | fix | scope css keyframes in emulated view encapsulation (#42608) | | 39b72e208b | fix | update element schema (#47552) | | 48b354a83e | fix | update element schema (#47552) |

  compiler-cli

  | Commit | Type | Description | | -- | -- | -- | | bc54687c7b | fix | exclude abstract classes from strictInjectionParameters requirement (#44615) | | 309b2cde51 | fix | implement more host directive validations as diagnostics (#47768) | | 2e1dddec45 | fix | support hasInvalidatedResolutions. (#47585) | | 19ad4987f9 | fix | use @ts-ignore. (#47636) | | 8fcadaad48 | perf | cache source file for reporting type-checking diagnostics (#47471) | | 16f96eeabf | refactor | remove enableIvy options (#47346) |

  core

  | Commit | Type | Description | | -- | -- | -- | | e3cef4a784 | docs | deprecate providedIn: NgModule and providedIn: 'any' (#47616) | | 1b9fd46d14 | feat | add support for Node.js version 18 (#47730) | | ed11a13c3c | feat | drop support for TypeScript 4.6 and 4.7 (#47690) | | db28badfe6 | feat | enable the new directive composition API (#47642) | | 7de1469be6 | feat | introduce EnvironmentProviders wrapper type (#47669) | | 841c8e5138 | feat | support object-based DI flags in Injector.get() (#46761) | | 120555a626 | feat | support object-based DI flags in TestBed.inject() (#46761) | | 96c0e42e61 | fix | allow readonly arrays for standalone imports (#47851) | | 28f289b825 | fix | hardening attribute and property binding rules for <iframe> elements (#47964) | | d4b3c0b47c | fix | hardening rules related to the attribute order on iframe elements (#47935) | | 85330f3fd9 | fix | update isDevMode to rely on ngDevMode (#47475) |

  forms

  | Commit | Type | Description | | -- | -- | -- | | a8569e3802 | feat | export forms utility functions: isFormArray, isFormGroup… (#47718) | | 96b7fe93af | fix | call setDisabledState on ControlValueAcessor when control is enabled (#47576) | | a99d9d67f3 | fix | don't mutate validators array (#47830) | | 2625dc1312 | fix | Improve a very commonly viewed error message by adding a guide. (#47969) | | ae29f98c20 | fix | Runtime error pages must begin with leading zero (#47991) |

  http

  | Commit | Type | Description | | -- | -- | -- | | 3ba99e286a | feat | allow for child HttpClients to request via parents (#47502) | | 84d0d33c35 | feat | introduce provideHttpClientTesting provider function (#47502) | | 62c7a7a16e | feat | introduce functional interceptors (#47502) | | e47b129070 | feat | introduce the provideHttpClient() API (#47502) | | ea16a98dfe | fix | better handle unexpected undefined XSRF tokens (#47683) | | e7b48da713 | fix | rename withLegacyInterceptors to withInterceptorsFromDi (#47901) |

  language-service

  | Commit | Type | Description | | -- | -- | -- | | bebef5fb43 | feat | Quick fix to import a component when its selector is used (#47088) | | e7ee53c541 | feat | support to fix invalid banana in box (#47393) |

  localize

  | Commit | Type | Description | | -- | -- | -- | | 400a6b5e37 | fix | add polyfill in polyfills array instead of polyfills.ts (#47569) | | b6fd814542 | fix | update ng add schematic to support Angular CLI version 15 (#47763) | | d36fd3d9e4 | refactor | remove deprecated canParse method from TranslationParsers (#47275) |

  platform-server

  | Commit | Type | Description | | -- | -- | -- | | 2908eba59c | fix | align server renderer interface with base renderer (#47868) |

  router

  | Commit | Type | Description | | -- | -- | -- | | 7bee28d037 | feat | add a migration to remove relativeLinkResolution usages (#47604) | | 5163e3d876 | feat | Add UrlTree constructor to public API (#47186) | | da58801f95 | feat | auto-unwrap default exports when lazy loading (#47586) | | c3f857975d | feat | make RouterOutlet name an Input so it can be set dynamically (#46569) | | f73ef21442 | feat | merge RouterLinkWithHref into RouterLink (#47630) | | 16c8f55663 | feat | migrate RouterLinkWithHref references to RouterLink (#47599) | | 07017a7bd3 | feat | prevent provideRouter() from usage in @Component (#47669) | | 79e9e8ab77 | fix | Delay router scroll event until navigated components have rendered (#47563) | | 6a88bad019 | fix | Ensure ActivatedRouteSnapshot#title has correct value (#47481) | | 7b89d95c0e | fix | Remove deprecated relativeLinkResolution (#47623) |

  Special Thanks

  Alan Agius, AleksanderBodurri, Alex Castle, Alex Rickabaugh, Andrew Kushnir, Andrew Scott, Charles Lyding, Dylan Hunn, Ferdinand Malcher, George Kalpakas, Jeremy Elbourn, Jessica Janiuk, JiaLiPassion, Joey Perrott, JoostK, Kara Erickson, Kristiyan Kostadinov, Martin Probst, Matthias Weiß, Matthieu Riegler, Paul Gschwendtner, Pawel Kozlowski, Sabareesh Kappagantu, WD Snoeijer, angular-robot[bot], arturovt, ced, dario-piotrowicz, ivanwonder and jaybell

14.2.11 (2022-11-16)

router

14.2.10 (2022-11-09)

core

14.2.9 (2022-11-03)

platform-browser

14.2.8 (2022-10-26)

Special Thanks

Andrew Scott, Balaji, Paul Gschwendtner, WD Snoeijer, onrails and vyom1611

14.2.7 (2022-10-19)

Special Thanks

Bob Watson, Charles Barnes, Joey Perrott, Virginia Dooley, WD Snoeijer, abergquist and urugator

14.2.6 (2022-10-12)

compiler-cli

14.2.5 (2022-10-05)

This release contains various API docs improvements.

Special Thanks

Alexander Wiebe, Ciprian Sauliuc, Dmytro Mezhenskyi, George Kalpakas, Joe Martin (Crowdstaffing), Jordan, Ole M, Paul Gschwendtner, Pawel Kozlowski and mgechev

14.2.4 (2022-09-28)

compiler-cli

14.2.3 (2022-09-21)

animations

14.2.2 (2022-09-14)

animations

14.2.1 (2022-09-07)

common

14.2.0 (2022-08-25)

animations

14.1.3 (2022-08-17)

compiler

14.1.2 (2022-08-10)

core

14.1.1 (2022-08-03)

core

14.1.0 (2022-07-20)

Deprecations

core

• The createNgModuleRef is deprecated in favor of newly added createNgModule one.
• The bit field signature of inject() has been deprecated, in favor of the new options object. Correspondingly, InjectFlags is deprecated as well.

  animations

  | Commit | Type | Description | | -- | -- | -- | | 55308f2df5 | feat | add provideAnimations() and provideNoopAnimations() functions (#46793) |

  common

  | Commit | Type | Description | | -- | -- | -- | | 4a2e7335b1 | feat | make the CommonModule pipes standalone (#46401) | | a7597dd080 | feat | make the CommonModule directives standalone (#46469) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | 33ce3883a5 | feat | Add extended diagnostic to warn when missing let on ngForOf (#46683) | | 6f11a58040 | feat | Add extended diagnostic to warn when text attributes are intended to be bindings (#46161) | | 9e836c232f | feat | warn when style suffixes are used with attribute bindings (#46651) |

  compiler-cli

  | Commit | Type | Description | | -- | -- | -- | | 93c65e7b14 | feat | add extended diagnostic for non-nullable optional chains (#46686) | | 131d029da1 | feat | detect missing control flow directive imports in standalone components (#46146) | | 6b8e60c06a | fix | improve the missingControlFlowDirective message (#46846) |

  core

  | Commit | Type | Description | | -- | -- | -- | | e8e8e5f171 | feat | add createComponent function | | b5153814af | feat | add reflectComponentType function | | 96c6139c9a | feat | add ability to set inputs on ComponentRef (#46641) | | a6d5fe202c | feat | alias createNgModuleRef as createNgModule (#46789) | | 71e606d3c3 | feat | expose EnvironmentInjector on ApplicationRef (#46665) | | 19e6d9ccd3 | feat | import AsyncStackTaggingZone if available (#46693) | | a7a14df5f8 | feat | introduce EnvironmentInjector.runInContext API (#46653) | | fa52b6e906 | feat | options object to supersede bit flags for inject() (#46649) | | af20112222 | feat | support the descendants option for ContentChild queries (#46638) | | 945a3ad359 | fix | Fix runInContext for NgModuleRef injector (#46877) | | bb7c80477b | fix | make parent injector argument required in createEnvironmentInjector (#46397) |

  http

  | Commit | Type | Description | | -- | -- | -- | | 82acbf919b | feat | improve error message for nullish header (#46059) |

  router

  | Commit | Type | Description | | -- | -- | -- | | 53ca936366 | feat | Add ability to create UrlTree from any ActivatedRouteSnapshot (#45877) | | de058bba99 | feat | Add CanMatch guard to control whether a Route should match (#46021) | | 6c1357dd7d | feat | Add stable cancelation code to NavigationCancel event (#46675) | | a4ce273e50 | feat | Add the target RouterStateSnapshot to NavigationError (#46731) | | abe3759e24 | fix | allow to return UrlTree from CanMatchFn (#46455) | | e8c7dd10e9 | fix | Ensure APP_INITIALIZER of enabledBlocking option completes (#46026) | | ce20ed067f | fix | Ensure Route injector is created before running CanMatch guards (#46394) | | 6a7b818d94 | fix | Ensure target RouterStateSnapshot is defined in NavigationError (#46842) | | f94c6f433d | fix | Expose CanMatchFn as public API (#46394) | | e8ae0fe3e9 | fix | Fix cancelation code for canLoad rejections (#46752) |

  upgrade

  | Commit | Type | Description | | -- | -- | -- | | e9cb0454dc | feat | more closely align UpgradeModule#bootstrap() with angular.bootstrap() (#46214) |

  Special Thanks

  AleksanderBodurri, Alex Rickabaugh, Andrew Kushnir, Andrew Scott, Cédric Exbrayat, Dmitrij Kuba, Dylan Hunn, George Kalpakas, Jessica Janiuk, JiaLiPassion, Joey Perrott, John Vandenberg, JoostK, Keith Li, Or'el Ben-Ya'ir, Paul Gschwendtner, Pawel Kozlowski, SyedAhm3r, arturovt, mariu, markostanimirovic and mgechev

14.0.7 (2022-07-20)

animations

14.0.6 (2022-07-13)

compiler-cli

14.0.5 (2022-07-06)

router

14.0.4 (2022-06-29)

animations

14.0.3 (2022-06-22)

animations

14.0.2 (2022-06-15)

common

14.0.1 (2022-06-08)

bazel

14.0.0 (2022-06-02)

Blog post "Angular v14 is now available".

Breaking Changes

animations

• The AnimationDriver.getParentElement method has become required, so any implementors of this interface are now required to provide an implementation for this method. This breakage is unlikely to affect application developers, as AnimationDriver is not expected to be implemented in user code.

  common

• Adds new required class member that any implementors of the LocationStrategy will need to satisfy. Location does not depend on PlatformLocation anymore.

  compiler

• Keyframes names are now prefixed with the component's "scope name". For example, the following keyframes rule in a component definition, whose "scope name" is host-my-cmp:

  @keyframes foo { ... }

  will become:

  @keyframes host-my-cmp_foo { ... }

  Any TypeScript/JavaScript code which relied on the names of keyframes rules will no longer match.

  The recommended solutions in this case are to either:

  • change the component's view encapsulation to the None or ShadowDom
  • define keyframes rules in global stylesheets (e.g styles.css)
  • define keyframes rules programmatically in code.

core

• Support for Node.js v12 has been removed as it will become EOL on 2022-04-30. Please use Node.js v14.15 or later.
• TypeScript versions older than 4.6 are no longer supported.

• Forms [email] input coercion

  Forms [email] input value will be considered as true if it is defined with any value rather than false and 'false'.

• Since Ivy, TestBed doesn't use AOT summaries. The aotSummaries fields in TestBed APIs were present, but unused. The fields were deprecated in previous major version and in v14 those fields are removed. The aotSummaries fields were completely unused, so you can just drop them from the TestBed APIs usage.

  forms

• Forms classes accept a generic.

  Forms model classes now accept a generic type parameter. Untyped versions of these classes are available to opt-out of the new, stricter behavior.

• objects with a length key set to zero will no longer validate as empty.

  This is technically a breaking change, since objects with a key length and value 0 will no longer validate as empty. This is a very minor change, and any reliance on this behavior is probably a bug anyway.

  http

• Queries including + will now actually query for + instead of space. Most workarounds involving custom codecs will be unaffected. Possible server-side workarounds will need to be undone.

• JSONP will throw an error when headers are set on a reques

  JSONP does not support headers being set on requests. Before when a request was sent to a JSONP backend that had headers set the headers were ignored. The JSONP backend will now throw an error if it receives a request that has any headers set. Any uses of JSONP on requests with headers set will need to remove the headers to avoid the error.

  platform-browser

• This change may cause a breaking change in unit tests that are implicitly depending on a specific number and sequence of change detections in order for their assertions to pass.

• This may break invalid calls to TransferState methods.

  This tightens parameter types of TransferState usage, and is a minor breaking change which may reveal existing problematic calls.

  router

• The type of Route.pathMatch is now stricter. Places that use pathMatch will likely need to be updated to have an explicit Route/Routes type so that TypeScript does not infer the type as string.
• When returning a Promise from the LoadChildrenCallback, the possible type is now restricted to Type<any>|NgModuleFactory<any> rather than any.
• initialNavigation: 'enabled' was deprecated in v11 and is replaced by initialNavigation: 'enabledBlocking'.
• The type of component on ActivatedRoute and ActivatedRouteSnapshot includes string. In reality, this is not the case. The component cannot be anything other than a component class.
• • The type of initialUrl is set to string|UrlTree but in reality, the Router only sets it to a value that will always be UrlTree
  • initialUrl is documented as "The target URL passed into the Router#navigateByUrl() call before navigation" but the value actually gets set to something completely different. It's set to the current internal UrlTree of the Router at the time navigation occurs.

  With this change, there is no exact replacement for the old value of initialUrl because it was never intended to be exposed. Router.url is likely the best replacement for this. In more specific use-cases, tracking the finalUrl between successful navigations can also be used as a replacement.

• Lazy loaded configs are now also validated once loaded like the initial set of routes are. Lazy loaded modules which have invalid Route configs will now error. Note that this is only done in dev mode so there is no production impact of this change.
• When a guard returns a UrlTree, the router would previously schedule the redirect navigation within a setTimeout. This timeout is now removed, which can result in test failures due to incorrectly written tests. Tests which perform navigations should ensure that all timeouts are flushed before making assertions. Tests should ensure they are capable of handling all redirects from the original navigation.
• Previously, resolvers were waiting to be completed before proceeding with the navigation and the Router would take the last value emitted from the resolver. The router now takes only the first emitted value by the resolvers and then proceeds with navigation. This is now consistent with Observables returned by other guards: only the first value is used.

  zone.js

• in TaskTrackingZoneSpec track a periodic task until it is cancelled

  The breaking change is scoped only to the plugin zone.js/plugins/task-tracking. If you used TaskTrackingZoneSpec and checked the pending macroTasks e.g. using (this.ngZone as any)._inner ._parent._properties.TaskTrackingZone.getTasksFor('macroTask'), then its behavior slightly changed for periodic macrotasks. For example, previously the setInterval macrotask was no longer tracked after its callback was executed for the first time. Now it's tracked until the task is explicitly cancelled, e.g with clearInterval(id).

Deprecations

common

• The ngModuleFactory input of the NgComponentOutlet directive is deprecated in favor of a newly added ngModule input. The ngModule input accepts references to the NgModule class directly, without the need to resolve module factory first.

  forms

• The initialValueIsDefault option has been deprecated and replaced with the otherwise-identical nonNullable option, for the sake of naming consistency.
• It is now deprecated to provide both AbstractControlOptions and an async validators argument to a FormControl. Previously, the async validators would just be silently dropped, resulting in a probably buggy forms. Now, the constructor call is deprecated, and Angular will print a warning in devmode.

  router

• The resolver argument of the RouterOutletContract.activateWith function and the resolver field of the OutletContext class are deprecated. Passing component factory resolvers are no longer needed. The ComponentFactoryResolver-related symbols were deprecated in @angular/core package since v13.

  animations

  | Commit | Type | Description | | -- | -- | -- | | a6fa37bc6e | feat | make validateStyleProperty check dev-mode only (#45570) | | 79d334b138 | feat | provide warnings for non-animatable CSS properties (#45212) | | f8dc660605 | fix | allow animations with unsupported CSS properties (#44729) | | 2a75754ee8 | fix | apply default params when resolved value is null or undefined (#45339) | | e46b379204 | fix | implement missing transition delay (#44799) | | 5c7c56bc85 | perf | improve algorithm to balance animation namespaces (#45057) | | 4c778cdb28 | perf | made errors in the animations package tree shakeable (#45004) | | 7a81481fb2 | perf | Remove generic objects in favor of Maps (#44482) | | 6642e3c8fd | perf | remove no longer needed CssKeyframes classes (#44903) | | 59559fdbac | refactor | make AnimationDriver.getParentElement required (#45114) |

  common

  | Commit | Type | Description | | -- | -- | -- | | 31d7c3bd71 | feat | add getState method to LocationStrategy interface (#45648) | | c89cf63059 | feat | support NgModule as an input to the NgComponentOutlet (#44815) | | 38c03a2035 | feat | support years greater than 9999 (#43622) | | bedb257afc | fix | cleanup URL change listeners when the root view is removed (#44901) | | 10691c626b | fix | properly cast http param values to strings (#42643) | | 05d50b849b | perf | make NgLocalization token tree-shakable (#45118) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | bb8d7091c6 | fix | exclude empty styles from emitted metadata (#45459) | | 4d6a1d6722 | fix | scope css keyframes in emulated view encapsulation (#42608) | | f03e313f24 | fix | scope css keyframes in emulated view encapsulation (#42608) |

  compiler-cli

  | Commit | Type | Description | | -- | -- | -- | | 9cf14ff03d | feat | exclude abstract classes from strictInjectionParameters requirement (#44615) | | 0072eb48ba | feat | initial implementation of standalone components (#44812) | | 2142ffd295 | feat | propagate standalone flag to runtime (#44973) | | 6f653e05f9 | feat | standalone types imported into NgModule scopes (#44973) | | 752ddbc165 | feat | Support template binding to protected component members (#45823) | | 3d13343975 | fix | better error messages for NgModule structural issues (#44973) | | 046dad1a8d | fix | fix issue with incremental tracking of APIs for pipes (#45672) | | 27b4af7240 | fix | full side-effectful registration of NgModules with ids (#45024) | | 32c625d027 | fix | handle forwardRef in imports of standalone component (#45869) | | 06050ac2b4 | fix | handle inline type-check blocks in nullish coalescing extended check (#45454) | | a524a50361 | fix | handle standalone components with cycles (#46029) | | 724e88e042 | fix | preserve forwardRef for component scopes (#46139) | | 9cfea3d522 | fix | report invalid imports in standalone components during resolve phase (#45827) | | c0778b4dfc | fix | Support resolve animation name from the DTS (#45107) | | f2e5234e07 | fix | update unknown tag error for aot standalone components (#45919) | | 35f20afcac | fix | use existing imports for standalone dependencies (#46029) | | 8155428ba6 | perf | ignore the module.id anti-pattern for NgModule ids (#45024) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 174ce7dd13 | feat | add ApplicationRef.destroy method (#45624) | | 5771b18a98 | feat | add the bootstrapApplication function (#45674) | | 69018c9f42 | feat | allow for injector to be specified when creating an embedded view (#45156) | | 94c949a60a | feat | allow for injector to be specified when creating an embedded view (#45156) | | e702cafcf2 | feat | allow to throw on unknown elements in tests (#45479) | | 6662a97c61 | feat | allow to throw on unknown elements in tests (#45479) | | a6675925b0 | feat | allow to throw on unknown properties in tests (#45853) | | 6eaaefd22e | feat | drop support for Node.js 12 (#45286) | | c9d566ce4b | feat | drop support for TypeScript 4.4 and 4.5 (#45394) | | b568a5e708 | feat | implement importProvidersFrom function (#45626) | | d5a6cd1111 | feat | implement EnvironmentInjector with adapter to NgModuleRef (#45626) | | 5a10fc4f82 | feat | implement standalone directives, components, and pipes (#45687) | | e461f716d4 | feat | move ANIMATION_MODULE_TYPE injection token into core (#44970) | | 94bba76a4a | feat | support TypeScript 4.6 (#45190) | | 29039fcdbc | feat | support TypeScript 4.7 (#45749) | | 225e4f2dbe | feat | triggerEventHandler accept optional eventObj (#45279) | | 401dec46eb | feat | update TestBed to recognize Standalone Components (#45809) | | 35653ce337 | fix | add more details to the MISSING_INJECTION_CONTEXT error (#46166) | | d36fa111eb | fix | avoid Closure Compiler error in restoreView (#45445) | | 0bc77f4cab | fix | better error message when unknown property is present (#46147) | | f3eb7d9ecb | fix | Ensure the StandaloneService is retained after closure minification (#45783) | | 701405fa71 | fix | handle AOT-compiled standalone components in TestBed correctly (#46052) | | ddce357d1d | fix | improve TestBed declarations standalone error message (#45999) | | ba9f30c9a6 | fix | include component name into unknown element/property error message (#46160) | | 9fa6f5a552 | fix | incorrectly inserting elements inside <template> element (#43429) | | d5719c2e0f | fix | input coercion (#42803) | | be161bef79 | fix | memory leak in event listeners inside embedded views (#43075) | | fa755b2a54 | fix | prevent BrowserModule providers from being loaded twice (#45826) | | 3172b4cc99 | fix | produce proper error message for unknown props on <ng-template>s (#46068) | | 4f1a813596 | fix | restore NgModule state correctly after TestBed overrides (#46049) | | 3f7ecec59b | fix | set correct context for inject() for component ctors (#45991) | | 4e413d9240 | fix | support nested arrays of providers in EnvironmentInjector (#45789) | | fde4942cdf | fix | throw if standalone components are present in `@NgModule.bootstrap([#45825](https://github.com/angular/angular/pull/45825)) | | [560188bf12](https://github.com/angular/angular/commit/560188bf126f259328477773cabb367587a257d5) | fix | update unknown property error to account for standalone components in AOT ([#46159](https://github.com/angular/angular/pull/46159)) | | [df339d8abf](https://github.com/angular/angular/commit/df339d8abf979c715c35db813c5a80252a92eba7) | fix | update unknown tag error for jit standalone components ([#45920](https://github.com/angular/angular/pull/45920)) | | [aafac7228f](https://github.com/angular/angular/commit/aafac7228f3d18bb720e85d2b889df446122f4c7) | fix | verify standalone component imports in JiT ([#45777](https://github.com/angular/angular/pull/45777)) | | [e9317aee71](https://github.com/angular/angular/commit/e9317aee71f64f4aadea0529601e589b37f6b46f) | perf | allowcheckNoChangesmode to be tree-shaken in production ([#45913](https://github.com/angular/angular/pull/45913)) | | [071c8af8ba](https://github.com/angular/angular/commit/071c8af8ba89163270f17657c0c7f1c944f186f7) | perf | avoid storing LView inngContext([#45051](https://github.com/angular/angular/pull/45051)) | | [a96c4827c4](https://github.com/angular/angular/commit/a96c4827c4f62e1d665d8544a3e66c51d2644c88) | perf | makeCompiler,ApplicationRefandApplicationInitStatustree-shakable ([#45102](https://github.com/angular/angular/pull/45102)) | | [45d98e7ca5](https://github.com/angular/angular/commit/45d98e7ca5accf918e2602cbc17805e11e18896b) | perf | makeIterableDiffersandKeyValueDifferstree-shakable ([#45094](https://github.com/angular/angular/pull/45094)) | | [1e60fe0a3e](https://github.com/angular/angular/commit/1e60fe0a3eeb6bd46997f7eeb4825351cfbe3c44) | perf | makeLOCALE_IDand other tokens fromApplicationModuletree-shakable ([#45102](https://github.com/angular/angular/pull/45102)) | | [88f1168506](https://github.com/angular/angular/commit/88f1168506befd0665125da1fca2a719cb27dbb5) | perf | only track LViews that are referenced inngContext([#45172](https://github.com/angular/angular/pull/45172)) | | [9add714b13](https://github.com/angular/angular/commit/9add714b13740db621eb2b200d72be74cc7eb630) | refactor | remove deprecatedaotSummaries` fields in TestBed config (#45487) |

  devtools tabs

  | Commit | Type | Description | | -- | -- | -- | | 6c284ef32e | fix | stop scroll occuring at tabs level |

  forms

  | Commit | Type | Description | | -- | -- | -- | | 2dbdebc646 | feat | Add FormBuilder.nonNullable. (#45852) | | e0a2248b32 | feat | Add a FormRecord type. (#45607) | | 7ee121f595 | feat | Add untyped versions of the model classes for use in migration. (#45205) | | 89d299105a | feat | Implement strict types for the Angular Forms package. (#43834) | | f490c2de4e | feat | support negative indices in FormArray methods. (#44848) | | 39be06037d | fix | Add a nonNullable option to FormControl for consistency. | | 4332897baa | fix | Add UntypedFormBuilder (#45268) | | 5d13e58aed | fix | Allow NonNullableFormBuilder to be injected. (#45904) | | 8dd3f82f94 | fix | Correct empty validator to handle objects with a property length: 0. (#33729) | | ff3f5a8d12 | fix | Fix a typing bug in FormBuilder. (#45684) | | fe0e42a996 | fix | Make UntypedFormBuilder assignable to FormBuilder, and vice versa. (#45421) | | b36dec6b5b | fix | not picking up disabled state if group is swapped out and disabled (#43499) | | 9f6fa5b746 | fix | Prevent FormBuilder from distributing unions to control types. (#45942) | | aa7b857be8 | fix | Property renaming safe code (#45271) | | cae1e44608 | fix | Update the typed forms migration to use FormArray<T> instead of FormArray<T[]>. (#44933) | | d336ba96d9 | fix | Update the typed forms migration. (#45281) | | 018550ed50 | fix | Value and RawValue should be part of the public API. (#45978) | | 2e96cede3e | fix | Warn on FormControls that are constructed with both options and asyncValidators. |

  http

  | Commit | Type | Description | | -- | -- | -- | | 76a9a24cdc | fix | encode + signs in query params as %2B (angular#11058) (#45111) | | d43c0e973f | fix | Throw error when headers are supplied in JSONP request (#45210) |

  language-service

  | Commit | Type | Description | | -- | -- | -- | | 9d4af65e34 | feat | Provide plugin to delegate rename requests to Angular (#44696) | | 3ae133c69e | fix | Fix detection of Angular for v14+ projects (#45998) |

  localize

  | Commit | Type | Description | | -- | -- | -- | | a50e2da64a | fix | ensure transitively loaded compiler code is tree-shakable (#45405) |

  migrations

  | Commit | Type | Description | | -- | -- | -- | | d56a537196 | feat | Add migration to add explicit Route/Routes type (#45084) |

  ngcc

  | Commit | Type | Description | | -- | -- | -- | | 74a2e2e2ec | fix | cope with packages following APF v14+ (#45833) |

  platform-browser

  | Commit | Type | Description | | -- | -- | -- | | a01bcb8e7e | fix | do not run change detection when loading Hammer (#44921) | | b32647dc68 | fix | Make transfer state key typesafe. (#23020) | | c7bf75dd5e | fix | remove obsolete shim for Map comparison in Jasmine (#45521) | | 23c4c9601e | perf | avoid including Testability by default in bootstrapApplication (#45885) |

  platform-server

  | Commit | Type | Description | | -- | -- | -- | | dff5586d52 | feat | implement renderApplication function (#45785) | | 22c71be94c | fix | update renderApplication to move appId to options (#45844) |

  router

  | Commit | Type | Description | | -- | -- | -- | | f4fd1a8262 | feat | Add EnvironmentInjector to RouterOutlet.activateWith (#45597) | | 910de8bc33 | feat | Add Route.title with a configurable TitleStrategy (#43307) | | 4e0957a4e1 | feat | Add ability to specify providers on a Route (#45673) | | dea8c86cd5 | feat | add ariaCurrentWhenActive input to RouterLinkActive directive (#45167) | | 41e2a68e30 | feat | add type properties to all router events (#44189) | | 4962a4a332 | feat | Allow loadChildren to return a Route array (#45700) | | 791bd31424 | feat | set stricter type for Route.title (#44939) | | 50004c143b | feat | Support lazy loading standalone components with loadComponent (#45705) | | 7fd416d060 | fix | Fix type of Route.pathMatch to be more accurate (#45176) | | 1c11a57155 | fix | merge interited resolved data and static data (#45276) | | f8f3ab377b | fix | Remove any from LoadChildrenCallback type (#45524) | | d4fc12fa19 | fix | Remove deprecated initialNavigation option (#45729) | | 989e840cce | fix | Remove unused string type for ActivatedRoute.component (#45625) | | 64f837d2c0 | fix | Update Navigation#initialUrl to match documentation and reality (#43863) | | 96fd29c6d2 | fix | validate lazy loaded configs (#45526) | | f13295f3a3 | perf | cancel the navigation instantly if at least one resolver doesn't emit any value (#45621) | | 1d2f5c1101 | refactor | deprecate no longer needed resolver fields (#45597) | | 7b367d9d90 | refactor | Remove unnecessary setTimeout in UrlTree redirects (#45735) | | c9679760b2 | refactor | take only the first emitted value of every resolver to make it consistent with guards (#44573) |

  service-worker

  | Commit | Type | Description | | -- | -- | -- | | ec0a0e0669 | feat | add cacheOpaqueResponses option for data-groups (#44723) | | bd04fbc05b | feat | emit a notification when the service worker is already up-to-date after check (#45216) |

  Special Thanks

  Adrian Kunz, Alan Agius, AleksanderBodurri, Alex Rickabaugh, AlirezaEbrahimkhani, Amir Rustamzadeh, Andrew Kushnir, Andrew Scott, Chabbey François, Charles Lyding, Cédric Exbrayat, Daan De Smedt, David Schmidt, Derek Cormier, Dmitrij Kuba, Doug Parker, Dylan Hunn, Emma Twersky, George Kalpakas, George Looshch, Jan Kuehle, Jessica Janiuk, JiaLiPassion, JimMorrison723, Joe Martin (Crowdstaffing), Joey Perrott, JoostK, Kristiyan Kostadinov, Krzysztof Platis, Leosvel Pérez Espinosa, Maddie Klein, Mark Whitfeld, Martin Sikora, Michael-Doner, Michal Materowski, Minko Gechev, Paul Gschwendtner, Pawel Kozlowski, Payam Shahidi, Pusztai Tibor, Ricardo Mattiazzi Baumgartner, Roy Dorombozi, Ruslan Lekhman, Samuel Littley, Sergej Grilborzer, Sumit Arora, Tobias Speicher, Virginia Dooley, Zack Elliott, alirezaghey, ananyahs96, arturovt, cexbrayat, dario-piotrowicz, ivanwonder, kamikopi, markostanimirovic, markwhitfeld, mgechev, renovate[bot], twerske and zverbeta

13.3.11 (2022-05-31)

Special Thanks

Andrew Scott, Billy Lando, George Kalpakas, Ian Gregory, Matt Shaffer, Rune Andersen Hartvig, dario-piotrowicz and mgechev

13.3.10 (2022-05-25)

Special Thanks

A. J. Javier, Aristeidis Bampakos, J Rob Gant, Jerome Kruse, Joey Perrott, Nathan Nontell, Paul Gschwendtner, Roopesh Chinnakampalli, Thomas Mair, Tom Raithel, dario-piotrowicz and mgechev

13.3.9 (2022-05-18)

This release contains API docs improvements.

Special Thanks

4javier, Bob Watson, Evan Lee, George Kalpakas, Joey Perrott, Pavan Kumar Jadda, celinetunc and mariu

13.3.8 (2022-05-12)

language-service

13.3.7 (2022-05-11)

core

13.3.6 (2022-05-04)

Special Thanks

Andrew Kushnir, Andrew Scott, George Kalpakas, Paul Gschwendtner, Pawel Kozlowski, Ryan Day and dario-piotrowicz

13.3.5 (2022-04-27)

bazel

13.3.4 (2022-04-20)

core

13.3.3 (2022-04-13)

compiler

13.3.2 (2022-04-06)

animations

13.3.1 (2022-03-30)

bazel

13.3.0-rc.0 (2022-03-16)

core

13.2.7 (2022-03-16)

forms

13.3.0-rc.0 (2022-03-10)

core

13.2.6 (2022-03-09)

compiler

13.2.5 (2022-03-02)

animations

13.2.4 (2022-02-23)

animations

13.2.3 (2022-02-16)

animations

13.2.2 (2022-02-08)

compiler

13.2.1 (2022-02-02)

animations

13.2.0 (2022-01-26)

Deprecations

• The CachedResourceLoader and RESOURCE_CACHE_PROVIDER symbols were previously necessary in some cases to test AOT-compiled components with View Engine, but they are no longer needed since Ivy.

• The ComponentFactory and ComponentFactoryResolver classes are deprecated. Since Ivy, there is no need to resolve Component factories. Please use other APIs where you Component classes can be used directly (without resolving their factories).

• Since Ivy, the CompilerOptions.useJit and CompilerOptions.missingTranslation config options are unused, passing them has no effect.

  | Commit | Type | Description | | -- | -- | -- | | 9c11183e74 | docs | deprecate CachedResourceLoader and RESOURCE_CACHE_PROVIDER symbols (#44749) | | 9f12e7fea4 | docs | deprecate ComponentFactory and ComponentFactoryResolver symbols (#44749) | | 4e95a316ce | docs | deprecate unused config options from the CompilerOptions interface (#44749) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | a4ab6d6b72 | feat | add support for safe calls in templates (#44580) | | abd1bc8039 | fix | correct spans when parsing bindings with comments (#44785) | | ed67a074ce | fix | properly compile DI factories when coverage reporting is enabled (#44732) |

  compiler-cli

  | Commit | Type | Description | | -- | -- | -- | | fa835b5a29 | feat | enable extended diagnostics by default (#44712) | | 73424def13 | feat | provide the animations for DirectiveMeta (#44630) | | fe3e4d6865 | fix | Handle ng-template with structural directive in indexer (#44788) | | 7316e72ec5 | fix | properly index <svg> elements when on a template (#44785) | | 100091ebf0 | fix | remove leftover _extendedTemplateDiagnostics requirements (#44777) | | d2ae96f742 | fix | skip ExtendedTemplateCheckerImpl construction if there were configuration errors (#44778) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 5626b34264 | fix | consistently use namespace short name rather than URI (#44766) | | 94bfcdd9de | fix | error if NgZone.isInAngularZone is called with a noop zone (#44800) |

  forms

  | Commit | Type | Description | | -- | -- | -- | | 72092ebd26 | feat | Allow a FormControl to use initial value as default. (#44434) | | f7aa937cac | fix | Make some minor fixups for forward-compatibility with typed forms. (#44540) |

  router

  | Commit | Type | Description | | -- | -- | -- | | 5a4ddfd4f5 | feat | Allow symbol keys for Route data and resolve properties (#44519) |

  Special Thanks

  Alex Rickabaugh, Andrew Kushnir, Andrew Scott, Dario Piotrowicz, Derek Cormier, Doug Parker, Douglas Parker, Dylan Hunn, George Kalpakas, Jessica Janiuk, JoostK, Kristiyan Kostadinov, Martin Probst, Oleg Postoev, Stephanie Tuerk, Tim Bowersox, Wiley Marques, Yousaf Nawaz, dario-piotrowicz, iRealNirmal, ivanwonder and shejialuo

13.1.3 (2022-01-19)

animations

13.1.2 (2022-01-12)

animations

13.1.1 (2021-12-15)

animations

13.1.0 (2021-12-09)

Deprecations

• The downgradeModule function calls with NgModule factories are deprecated. Please use NgModule class based downgradeModule calls instead.

  common

• TestRequest from @angular/common/http/testing no longer accepts ErrorEvent when simulating XHR errors. Instead, instances of ProgressEvent should be passed, matching with the native browser behavior.
  | Commit | Type | Description | | -- | -- | -- | | dbc46d68b9 | docs | deprecate factory-based signature of the downgradeModule function (#44090) |

  common

  | Commit | Type | Description | | -- | -- | -- | | 489cf42cd0 | fix | incorrect error type for XHR errors in TestRequest (#36082) | | 13362972bb | perf | code size reduction of ngFor directive (#44315) |

  compiler

  | Commit | Type | Description | | -- | -- | -- | | c85bcb0c63 | feat | reference ICU message IDs from their placeholders (#43534) |

  core

  | Commit | Type | Description | | -- | -- | -- | | 5dff077d50 | feat | add migration to remove entryComponents (#44308) | | e65a245a0b | feat | add migration to remove entryComponents (#44322) | | d56e3f43a1 | feat | support TypeScript 4.5 (#44164) |

  http

  | Commit | Type | Description | | -- | -- | -- | | d452b388bd | feat | add has() method to HttpContext class (#43887) |

  localize

  | Commit | Type | Description | | -- | -- | -- | | d3cf222a81 | feat | support "associated message ids" for placeholders (#43534) |

  ngcc

  | Commit | Type | Description | | -- | -- | -- | | 41265919aa | fix | correctly resolve UMD dependencies (#44381) |

  upgrade

  | Commit | Type | Description | | -- | -- | -- | | 34f990986c | feat | support NgModule class as an argument of the downgradeModule function (#43973) |

  Special Thanks

  Alex Rickabaugh, Andrew Kushnir, Andrew Scott, Doug Parker, Dustin M. Eastway, Dylan Hunn, George Kalpakas, HyperLife1119, Jelle Bruisten, Jessica Janiuk, Joey Perrott, JoostK, Kristiyan Kostadinov, Markus Doggweiler, Paul Gschwendtner, Pei Wang, Pete Bacon Darwin and dario-piotrowicz

13.0.3 (2021-12-01)

compiler-cli

13.0.2 (2021-11-17)

This release contains various API docs improvements.

Special Thanks

Andrew Kushnir, Armen Vardanyan, Dylan Hunn, Joey Perrott, Martin von Gagern, Paul Gschwendtner, Pete Bacon Darwin, Ramesh Thiruchelvam, dario-piotrowicz and fusho-takahashi

13.0.1 (2021-11-10)

compiler

13.1.0-next.0 (2021-11-03)

compiler

13.0.0 (2021-11-03)

Blog post "Angular v13 is now available".

Breaking Changes

common

• The behavior of the SpyLocation used by the RouterTestingModule has changed to match the behavior of browsers. It no longer emits a 'popstate' event when Location.go is called. In addition, simulateHashChange now triggers both a hashchange and a popstate event. Tests which use location.go and expect the changes to be picked up by the Router should likely change to simulateHashChange instead. Each test is different in what it attempts to assert so there is no single change that works for all tests. Each test using the SpyLocation to simulate browser URL changes should be evaluated on a case-by-case basis.

  core

• TypeScript versions older than 4.4.2 are no longer supported.

• NodeJS versions older than v12.20.0 are no longer supported due to the Angular packages using the NodeJS package exports feature with subpath patterns.

• The WrappedValue class can no longer be imported from @angular/core, which may result in compile errors or failures at runtime if outdated libraries are used that are still using WrappedValue. The usage of WrappedValue should be removed as no replacement is available.

  forms

• A new type called FormControlStatus has been introduced, which is a union of all possible status strings for form controls. AbstractControl.status has been narrowed from string to FormControlStatus, and statusChanges has been narrowed from Observable<any> to Observable<FormControlStatus>. Most applications should consume the new types seamlessly. Any breakage caused by this change is likely due to one of the following two problems: (1) the app is comparing AbstractControl.status against a string which is not a valid status; or, (2) the app is using statusChanges events as if they were something other than strings.

  router

• The default url serializer would previously drop everything after and including a question mark in query parameters. That is, for a navigation to /path?q=hello?&other=123, the query params would be parsed to just {q: 'hello'}. This is incorrect because the URI spec allows for question mark characers in query data. This change will now correctly parse the params for the above example to be {v: 'hello?', other: '123'}.

• Previously null and undefined inputs for routerLink were equivalent to empty string and there was no way to disable the link's navigation. In addition, the href is changed from a property HostBinding() to an attribute binding (HostBinding('attr.href')). The effect of this change is that DebugElement.properties['href'] will now return the href value returned by the native element which will be the full URL rather than the internal value of the RouterLink href property.

• When storing and retrieving a DetachedRouteHandle, the Router traverses the Route children in order to correctly allow storing a parent route when there are several possible child Route configs that can be stored. This allows a RouteReuseStrategy to store a parent Route and a child, while preserving the ability to change the child route while restoring the parent. Some implementations of RouteReuseStrategy will need to be updated to correctly store and retrieve the DetachedRouteHandle of descendants as well as the stored parent ActivatedRouteSnapshot. Previously, the Router would only store the parent, making it impossible to change descendant paths when a stored parent was retrieved. See #20114.

• The router will no longer replace the browser URL when a new navigation cancels an ongoing navigation. This often causes URL flicker and was only in place to support some AngularJS hybrid applications. Hybrid applications which rely on the navigationId being present on initial navigations that were handled by the Angular router should instead subscribe to NavigationCancel events and perform the location.replaceState themselves to add navigationId to the Router state. In addition, tests which assert urlChanges on the SpyLocation may need to be adjusted to account for the replaceState which is no longer triggered.

• It is no longer possible to use Route.loadChildren using a string value. The following supporting classes were removed from @angular/core:

• NgModuleFactoryLoader

• SystemJsNgModuleFactoryLoader

The @angular/router package no longer exports these symbols:

• SpyNgModuleFactoryLoader
• DeprecatedLoadChildren

The signature of the setupTestingRouter function from @angular/core/testing has been changed to drop its NgModuleFactoryLoader parameter, as an argument for that parameter can no longer be created.

service-worker

• The return type of SwUpdate#activateUpdate and SwUpdate#checkForUpdate changed to Promise<boolean>.

Although unlikely, it is possible that this change will cause TypeScript type-checking to fail in some cases. If necessary, update your types to account for the new return type.

Deprecations

core

• Angular no longer requires component factories to dynamically create components. The factory-based signature of the ViewContainerRef.createComponent function is deprecated in favor of a different signature that allows passing component classes instead.

• The getModuleFactory function is deprecated in favor of the getNgModuleById one. With Ivy, it's possible to work with NgModule classes directly, without retrieving corresponding factories, so the getNgModuleById should be used instead.

• Ivy made it possible to avoid the need to resolve Component and NgModule factories. Framework APIs allow to use Component and NgModule Types directly. As a result, the PlatformRef.bootstrapModuleFactory and a factory-based signature of the ApplicationRef.bootstrap method are now obsolete and are now deprecated. The PlatformRef.bootstrapModuleFactory calls can be replaced with PlatformRef.bootstrapModule ones. The ApplicationRef.bootstrap method allows to provide Component Type, so this can be used a replacement for the factory-based calls.

• In ViewEngine, JIT compilation required special providers (like Compiler, CompilerFactory, etc) to be injected in the app and corresponding methods to be invoked. With Ivy, JIT compilation takes place implicitly if the Component, NgModule, etc. have not already been AOT compiled. Those special providers were made available in Ivy for backwards-compatibility with ViewEngine to make the transition to Ivy smoother. Since ViewEngine is deprecated and will soon be removed, those symbols are now deprecated as well:

• ModuleWithComponentFactories

• Compiler
• CompilerFactory
• JitCompilerFactory
• NgModuleFactory

Important note: this deprecation doesn't affect JIT mode in Ivy (JIT remains available with Ivy).

• In Ivy, AOT summary files are unused in TestBed. Passing AOT summary files in TestBed has no effect, so the aotSummaries usage in TestBed is deprecated and will be removed in a future version of Angular.

  platform-server

• The renderModuleFactory symbol in @angular/platform-server is no longer necessary as of Angular v13.

The renderModuleFactory calls can be replaced with renderModule.

service-worker

• The SwUpdate#activated observable is deprecated.

The SwUpdate#activated observable only emits values as a direct response to calling SwUpdate#activateUpdate() and was only useful for determining whether the call resulted in an update or not. Now, the return value of SwUpdate#activateUpdate() can be used to determine the outcome of the operation and therefore using SwUpdate#activated does not offer any benefit.

• The SwUpdate#availalbe observable is deprecated.

The new SwUpdate#versionUpdates observable provides the same information and more. Therefore, it is possible to rebuild the same behavior as SwUpdate#availalbe using the events emitted by SwUpdate#versionUpdates and filtering for VersionReadyEvent events. As a result, the SwUpdate#availalbe observable is now redundant.

#

12.2.15 (2021-12-08)

ngcc

12.2.14 (2021-12-01)

compiler

12.2.13 (2021-11-03)

compiler-cli

12.2.12 (2021-10-27)

compiler-cli

12.2.11 (2021-10-20)

ngcc

12.2.10 (2021-10-13)

Special Thanks

Alan Agius, Daniel Díaz, David Shevitz, Doug Parker, George Kalpakas, Joe Martin (Crowdstaffing), Tanguy Nodet, Thomas Turrell-Croft, dario-piotrowicz, hchiam, markostanimirovic and mgechev

12.2.9 (2021-10-06)

core

12.2.8 (2021-09-30)

compiler-cli

12.2.7 (2021-09-22)

common

12.2.6 (2021-09-15)

animations

12.2.5 (2021-09-08)

router

12.2.4 (2021-09-01)

compiler-cli

12.2.3 (2021-08-25)

service-worker

12.2.2 (2021-08-18)

animations

12.2.1 (2021-08-11)

router

12.2.0 (2021-08-04)

core

12.1.5 (2021-08-04)

This release contains various API docs improvements.

12.2.0-rc.0 (2021-07-28)

compiler-cli

12.1.4 (2021-07-28)

compiler-cli

12.2.0-next.3 (2021-07-21)

animations

12.1.3 (2021-07-21)

animations

12.2.0-next.2 (2021-07-14)

bazel

12.1.2 (2021-07-14)

bazel

12.2.0-next.1 (2021-06-30)

compiler

12.1.1 (2021-06-30)

compiler-cli

12.2.0-next.0 (2021-06-24)

This release contains the same set of changes as 12.1.0.

12.1.0 (2021-06-24)

compiler

12.1.0-next.6 (2021-06-16)

compiler

12.0.5 (2021-06-16)

compiler

12.1.0-next.5 (2021-06-09)

common

12.0.4 (2021-06-09)

common

12.1.0-next.4 (2021-06-02)

compiler-cli

12.0.3 (2021-06-02)

compiler-cli

12.0.2 (2021-05-26)

forms

12.1.0-next.3 (2021-05-26)

forms

12.1.0-next.2 (2021-05-19)

common

12.0.1 (2021-05-19)

benchpress

12.0.0 (2021-05-12)

Blog post "Angular v12 is now available".

Bug Fixes

• animations: ensure consistent transition namespace ordering (#19854) (01cc995)
• animations: update supported range of node versions to only include LTS versions (#41822) (e918250)
• animations: cleanup DOM elements when the root view is removed (#41059) (c49b280)
• animations: allow animations on elements in the shadow DOM (#40134) (dad42c8), closes #25672
• animations: cleanup DOM elements when the root view is removed (#41001) (a31da48)
• bazel: update supported range of node versions to only include LTS versions (#41822) (8503246)
• bazel: update build tooling for latest changes in rules_nodejs (#40710) (696f7bc)
• bazel: update integration test to use rules_nodejs@3.1.0 (#40710) (34de89a)
• bazel: update type castings for JSON.parse usage (#40710) (2c90391)
• benchpress: update type castings for JSON.parse usage (#40710) (e721a5d)
• common: add right ContentType for boolean values with HttpClient request body(#38924) (#41885) (922a602)
• common: update supported range of node versions to only include LTS versions (#41822) (f2b6fd8)
• common: viewport scroller not finding elements inside the shadow DOM (#41644) (c0f5ba3), closes #41470
• common: temporarily re-export and deprecate XhrFactory (#41393) (7dfa446)
• common: cleanup location change listeners when the root view is removed (#40867) (38524c4), closes #31546
• common: allow number or boolean as http params (#40663) (91cdc11), closes #23856
• common: avoid mutating context object in NgTemplateOutlet (#40360) (d3705b3), closes #24515
• compiler: preserve @page rules in encapsulated styles (#41915) (3e365ba), closes #26269
• compiler: strip scoped selectors from @font-face rules (#41815) (2a11cda), closes #41751
• compiler: update supported range of node versions to only include LTS versions (#41822) (bae8126)
• compiler: non-literal inline templates incorrectly processed in partial compilation (#41583) (ab257b3)
• compiler: not generating update instructions for ng-template inside alternate namespaces (#41669) (2bcbbda), closes #41308
• compiler: avoid parsing EmptyExpr with a backwards span (#41581) (e1a2930)
• compiler: handle case-sensitive CSS custom properties (#41380) (e112e32), closes #41364
• compiler: include used components during JIT compilation of partial component declaration (#41353) (ff9470b), closes #41104 #41318
• compiler: support multiple :host-context() selectors (#40494) (07b7af3), closes #19199
• compiler: update type castings for JSON.parse usage (#40710) (f728490)
• compiler-cli: use '' for the source map URL of indirect templates (#41973) (7a4d980), closes #40854
• compiler-cli: expose the linker as a Babel plugin (#41918) (8fdac8f)
• compiler-cli: prefer non-aliased exports in reference emitters (#41866) (75bb931), closes #41443 #41277
• compiler-cli: allow linker to process minified booleans (#41747) (1fb6724), closes #41655
• compiler-cli: match string indexed partial declarations (#41747) (f885750), closes #41655
• compiler-cli: update supported range of node versions to only include LTS versions (#41822) (5b463f4)
• compiler-cli: autocomplete literal types in templates. (#41456) (#41645) (8b2b5ef)
• compiler-cli: do not error with prepocessing if component has no inline styles (#41602) (a5fe8b9)
• compiler-cli: ensure the compiler tracks ts.Programs correctly (#41291) (deacc74)
• compiler-cli: prevent eliding default imports in incremental recompilations (#41557) (7f16515), closes #41377
• compiler-cli: resolve rootDirs to absolute (#41359) (3e0fda9), closes #36290
• compiler-cli: add useInlining option to type check config (#41043) (09aefd2), closes #40963
• compiler-cli: readConfiguration existing options should override options in tsconfig (#40694) (b7c4d07)
• compiler-cli: extend angularCompilerOptions in tsconfig from node (#40694) (5eb1954), closes #36715
• compiler-cli: update ngcc integration tests for latest changes in rules_nodejs (#40710) (d7f5755)
• compiler-cli: update type castings for JSON.parse usage (#40710) (b75d7cb)
• core: do not retain dynamically compiled components and modules (#42003) (1449c5c), closes #19997
• core: invoke profiler around ngOnDestroy lifecycle hooks (#41969) (e9ddc57)
• core: AsyncPipe now compatible with RxJS 7 (#41590) (9759bca)
• core: handle multiple i18n attributes with expression bindings (#41882) (73c6c64), closes #41869
• core: update supported range of node versions to only include LTS versions (#41822) (f9c1f08)
• core: detect synthesized constructors that have been downleveled using TS 4.2 (#41305) (274dc15), closes #41298
• core: Switch emitDistinctChangesOnlyDefaultValue to true (#41121) (7096246)
• core: remove duplicated EMPTY_OBJ constant (#41066) (bf158e7)
• core: remove duplicated EMPTY_ARRAY constant (#40991) (e12d9de)
• core: allow EmbeddedViewRef context to be updated (#40360) (a3e1719), closes #24515
• core: make DefaultIterableDiffer keep the order of duplicates (#23941) (a826926), closes #23815
• core: NgZone coaleascing options should trigger onStable correctly (#40540) (22f9e45)
• elements: update supported range of node versions to only include LTS versions (#41822) (4f5d094)
• elements: update type castings for JSON.parse usage (#40710) (efd4149)
• forms: update supported range of node versions to only include LTS versions (#41822) (dc975ba)
• http: complete the request on timeout (#39807) (61a0b6d), closes #26453
• http: emit error on XMLHttpRequest abort event (#40767) (3897265), closes #22324
• language-service: update supported range of node versions to only include LTS versions (#41822) (9b6198c)
• language-service: use script versions for incremental compilations (#41475) (78236bf)
• language-service: Only provide Angular property completions in templates (#41278) (0226a11)
• language-service: Add plugin option to force strictTemplates (#41062) (e9e7c33)
• language-service: use single entry point for Ivy and View Engine (#40967) (e986a97)
• localize: relax error to warning for missing target (#41944) (35ceed2), closes #21690
• localize: update supported range of node versions to only include LTS versions (#41822) (658ed1f)
• localize: update type castings for JSON.parse usage (#40710) (4b469c9)
• ngcc: detect synthesized constructors that have been downleveled using TS 4.2 (#41305) (8d3da56), closes #41298
• platform-browser: prevent memory leak of style nodes if shadow DOM encapsulation is used (#42005) (d555555), closes #36655
• platform-browser: update supported range of node versions to only include LTS versions (#41822) (ea05cfd)
• platform-browser: configure XhrFactory to use BrowserXhr (#41313) (e0028e5), closes #41311
• platform-browser: update type castings for JSON.parse usage (#40710) (7ecfd2d)
• platform-browser-dynamic: update supported range of node versions to only include LTS versions (#41822) (bc45029)
• platform-server: update supported range of node versions to only include LTS versions (#41822) (4b9d4fa)
• router: update supported range of node versions to only include LTS versions (#41822) (0067edd)
• router: Only retrieve stored route when reuse strategy indicates it should reattach (#30263) (a4ff071), closes #23162
• router: recursively merge empty path matches (#41584) (1179dc8), closes #41481
• router: fragment can be null (#37336) (b555160), closes #23894 #34197
• router: update type castings for JSON.parse usage (#40710) (350dada)
• service-worker: update supported range of node versions to only include LTS versions (#41822) (6b823d7)
• service-worker: update type castings for JSON.parse usage (#40710) (4f7ff96)
• upgrade: preserve $interval flush when ngMocks is being used (#30229) (87dc851)
• upgrade: update supported range of node versions to only include LTS versions (#41822) (10c4523)