@angular/compiler

What is @angular/compiler?

The @angular/compiler package is a core part of the Angular framework that is responsible for compiling Angular templates into JavaScript code that can be executed by the browser. It takes the templates and annotations provided in Angular components and generates code that represents the structure and behavior of the application.

What are @angular/compiler's main functionalities?

Template Compilation

This feature allows you to compile Angular components and modules dynamically at runtime. The code sample demonstrates how to use the JIT compiler to compile a module and its components asynchronously.

import { Compiler, COMPILER_OPTIONS, CompilerFactory } from '@angular/core';
import { JitCompilerFactory } from '@angular/platform-browser-dynamic';

// Get a reference to the JIT compiler factory
const compilerFactory: CompilerFactory = platformBrowserDynamic().injector.get(CompilerFactory);
const compiler = compilerFactory.createCompiler();

// Compile a component dynamically
compiler.compileModuleAndAllComponentsAsync(DynamicModule)
  .then(compiled => {
    const moduleRef = compiled.ngModuleFactory.create(this.injector);
    const componentFactory = compiled.componentFactories[0];
    this.container.createComponent(componentFactory);
  });

AOT Compilation

Ahead-of-Time (AOT) compilation converts Angular HTML and TypeScript code into efficient JavaScript code during the build process, before the browser downloads and runs the code. This code sample shows how to bootstrap an Angular application using the AOT-compiled module factory.

import { enableProdMode } from '@angular/core';
import { platformBrowser } from '@angular/platform-browser';
import { AppModuleNgFactory } from './app/app.module.ngfactory';

enableProdMode();
platformBrowser().bootstrapModuleFactory(AppModuleNgFactory);

Other packages similar to @angular/compiler

babel

Babel is a JavaScript compiler that converts ECMAScript 2015+ code into a backwards-compatible version of JavaScript that can be run by older JavaScript engines. Babel is similar to @angular/compiler in that it performs code transformation, but it is not specific to Angular and does not compile Angular templates.

typescript

TypeScript is a superset of JavaScript that compiles to plain JavaScript. It is similar to @angular/compiler in that it performs a compilation step, but TypeScript focuses on type-checking and converting TypeScript code to JavaScript, rather than compiling framework-specific templates.

vue-template-compiler

The vue-template-compiler package is used to compile Vue.js templates into render functions. It is similar to @angular/compiler as both are used for compiling framework-specific templates, but they target different frameworks (Vue.js vs Angular).

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-next.9 (2025-04-30)

Breaking Changes

core

• the TestBed.flushEffects() was removed - use the TestBed.tick() instead.

• provideExperimentalCheckNoChangesForDebug has several breaking changes:

  • It is renamed to provideCheckNoChangesConfig
  • The behavior applies to all checkNoChanges runs
  • The useNgZoneOnStable option is removed. This wasn't found to be generally more useful than interval

• afterRender was renamed to afterEveryRender.

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

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

common

| Commit | Type | Description | | -- | -- | -- | | b7d3f3dbfc | feat | Allow passing ScrollOptions to ViewportScroller (#61002) | | fc4a56d5c5 | fix | rename httpResource function in factory (#60022) |

compiler-cli

| Commit | Type | Description | | -- | -- | -- | | c889382a20 | feat | detect missing structural directive imports (#59443) |

core

| Commit | Type | Description | | -- | -- | -- | | d5fd7349fb | feat | introduce TestBed.tick() (#60993) | | e711f99d81 | feat | move provideExperimentalCheckNoChangesForDebug to provideCheckNoChangesConfig (#60906) | | d8fbb909ce | feat | rename afterRender to afterEveryRender and stabilize (#60999) | | 8d82a39a60 | fix | async EventEmitter error should not prevent stability (#61028) | | 624be2ef0c | fix | prevent stash listener conflicts (#59635) | | c2987d8402 | refactor | stop producing ng-reflect attributes by default (#60973) |

http

| Commit | Type | Description | | -- | -- | -- | | ccc5cc068f | feat | add keepalive support for fetch requests (#60621) |

<!-- CHANGELOG SPLIT MARKER -->

<a name="19.2.9"></a>