@angular/common

What is @angular/common?

The @angular/common package is a core Angular library that provides commonly needed services, pipes, and directives that are essential for application development. It is part of the Angular framework and is used for tasks such as HTTP communication, localization, and various utility functions.

What are @angular/common's main functionalities?

HTTP Client

Provides a simplified API for HTTP functionality which allows performing HTTP requests and handling responses within an Angular application.

import { HttpClientModule } from '@angular/common/http';

@NgModule({
  imports: [
    HttpClientModule
  ]
})
export class AppModule { }

Common Directives

Includes directives like ngIf, ngFor, and ngSwitch which are essential for controlling the rendering of the template.

import { CommonModule } from '@angular/common';

@NgModule({
  imports: [
    CommonModule
  ]
})
export class SharedModule { }

Location Services

Provides services for interacting with the browser's URL. Useful for routing and navigation within an Angular application.

import { Location } from '@angular/common';

@Component({
  selector: 'app-component',
  template: '<p>Current path: {{ location.path() }}</p>'
})
export class AppComponent {
  constructor(public location: Location) { }
}

Date, Currency, and Decimal Pipes

Provides built-in pipes for formatting data such as dates, currency, and numbers.

import { DatePipe, CurrencyPipe, DecimalPipe } from '@angular/common';

@Component({
  selector: 'app-component',
  template: '<p>Today is {{ today | date }}</p><p>Amount: {{ amount | currency }}</p>'
})
export class AppComponent {
  today = new Date();
  amount = 1234.56;
}

Other packages similar to @angular/common

react

React is a JavaScript library for building user interfaces. While it is not a one-to-one comparison with @angular/common, React provides a component-based architecture similar to Angular's directives and services.

vue

Vue.js is a progressive JavaScript framework used for building UIs and single-page applications. It offers similar directives and reactivity systems but is generally considered to be more lightweight and easier to integrate into projects than Angular.

axios

Axios is a promise-based HTTP client for the browser and Node.js. It provides many of the same HTTP client capabilities as the HttpClientModule in @angular/common.

moment

Moment.js is a library for parsing, validating, manipulating, and formatting dates. It is similar to the DatePipe in @angular/common but is a standalone library focused solely on date manipulation.

README

Angular

The sources for this package are in the main Angular repo. Please file issues and pull requests against that repo.

Usage information and reference details can be found in Angular documentation.

License: MIT

Changelog

20.0.0-rc.2 (2025-05-21)

Deprecations

platform-browser

• All entries of the @angular/platform-browser-dynamic

Breaking Changes

core

• Resource.value() now returns a default value when in a loading state after reloading the error state
• Resource.value() now throws an error when it's in an error state. Previously it returned undefined.
• Resource.error now has a type of Signal<Error | undefined> instead of Signal<unknown>
• Resource.reload has been moved to WritableResource.reload.

common

| Commit | Type | Description | | -- | -- | -- | | af7881abac | fix | cancel reader when app is destroyed (#61528) | | 966df84351 | fix | prevent reading chunks if app is destroyed (#61354) |

compiler

| Commit | Type | Description | | -- | -- | -- | | e74266b108 | fix | avoid conflicts between HMR code and local symbols (#61550) |

compiler-cli

| Commit | Type | Description | | -- | -- | -- | | b57084267e | fix | Always retain prior results for all files (#61487) | | 7a3a41f33f | fix | avoid ECMAScript private field metadata emit (#61227) |

core

| Commit | Type | Description | | -- | -- | -- | | 7efb3384a7 | fix | cleanup rxResource abort listener (#58306) | | b90160d10a | fix | cleanup testability subscriptions (#61261) | | 3ba39bc28f | fix | getting resource value throws an error instead of returning undefined (#61441) | | ca6295e90b | fix | handle different DI token types in Chrome DevTools integration (#61333) | | d62379bb13 | fix | move reload method from Resource to WritableResource (#61441) | | a89f1cff24 | fix | narrow error type for resources API (#61441) | | 6e79eaf739 | fix | reading resource value after reload in the error state (#61441) | | 350776b412 | fix | TestBed.tick should ensure test components are synchronized (#61382) | | 648d42fe65 | fix | Testing should not throw when Zone does not patch test FW APIs (#61376) | | 5dbeb42308 | fix | unregister onDestroy in toSignal. (#61514) | | 30e081287d | fix | update min Node.js support to 20.19, 22.12, and 24.0 (#61500) |

platform-browser

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

platform-server

| Commit | Type | Description | | -- | -- | -- | | 6d8e57d131 | perf | speed up resolution of base (#61392) |

<!-- CHANGELOG SPLIT MARKER -->

<a name="19.2.12"></a>