Building High-Performance Components with Angular and OnPush Change Detection

Anton Ioffe - November 23rd 2023 - 10 minutes read

As we venture ever deeper into the sophisticated landscape of modern web development, performance tuning has become a cardinal concern. The Angular framework, with its prowess in building scalable applications, offers a potent mechanism for component optimization: the OnPush change detection strategy. In this article, we will not only dissect the underpinnings of OnPush and its harmonious relationship with immutability but also navigate through the practicalities of leveraging this strategy across complex component hierarchies. We'll unpack the common pitfalls and misconceptions, providing actionable insights for refactoring and fine-tuning your Angular applications. What's more, we'll culminate our exploration by intersecting OnPush with the reactive streams of RxJS, showcasing patterns that solidify the high responsiveness and performance of your components. Prepare to elevate your Angular expertise by mastering the nuances of OnPush for a sleek, performant user experience that stands the test of time and scale.

Harnessing OnPush for Optimizing Angular Component Trees

Understanding Angular's OnPush change detection strategy is essential for developers aiming to optimize their Angular component trees. This strategy fundamentally alters the way Angular checks for changes, and when implemented correctly, leads to substantial performance gains. Rather than performing checks on all components following every single event, OnPush confines the process to specific triggering conditions. It initiates re-rendering only if an @Input property changes via the "===" reference check, a new value is emitted from an Observable via the "async" pipe, or detection is manually invoked. Moreover, for the events within the component or its children, OnPush relies on @Output() decorators to determine when change detection should occur, thus ensuring that re-rendering is confined to relevant component events.

To enable OnPush, you simply set the changeDetection property in the @Component decorator to ChangeDetectionStrategy.OnPush. This instructs Angular to adopt a more conservative approach, avoiding unnecessary checks and thus enhancing performance significantly. However, this strategy assumes that your component is working with immutable data to effectively detect changes.

Immutability plays a critical role when it comes to leveraging OnPush. In JavaScript, immutability means once an object is created, it cannot be altered; any modification yields a new object. Libraries like Immutable.js facilitate enforcing immutability, offering structures like List and Map that follow this principle. Using immutable data ensures that Angular's OnPush strategy can determine precisely when an @Input has truly changed, as opposed to mere property mutations within the object—which would go undetected.

With immutability as the backbone, OnPush grants us the benefit of reduced check complexity and frequency. When components exclusively receive immutable objects as inputs, any change detection is a matter of comparing object references rather than deeply inspecting object property changes. This results in a drastic reduction of Angular's workload for components structured with an OnPush strategy.

When used in such contexts, along with immutable data patterns, OnPush ensures that components are only refreshed when absolutely necessary, yielding a highly optimized application. It is a strategic feature that, when understood and applied properly, can result in responsive, high-performance Angular applications.

Implementing OnPush in Complex Hierarchies

In a scenario where complex component hierarchies are prevalent, leveraging the OnPush change detection strategy can prove influential in streamlining performance. One notable instance is within deeply nested components, often referred to as "smart" components, which traditionally involve processing a substantial amount of data or integrating with external services. Implementing OnPush in such components can significantly reduce the overhead of Angular's change detection mechanism by preventing unnecessary checks on entire sub-trees, provided that these components adhere to immutability patterns.

However, while the benefits are clear in theory, the practical implementation of OnPush across nested hierarchies may not always yield substantial performance gains. Specifically, when numerous intermediary components don't directly rely on external inputs, but instead serve as conduits for event handling or control flow, the impact of OnPush becomes less pronounced. These components, while contributing to the structural integrity of the application, may not be the prime candidates for performance gains through OnPush, as their change detection cycles are inherently minimal.

In contrast, scenarios that include components deeply nested yet primarily presentational in nature stand to benefit the most from OnPush. Such components, often used for displaying data without significant business logic, can exacerbate the change detection workload when dealing with frequent updates or large datasets. By employing OnPush, these components remain dormant until explicitly instructed to update, thus severing the continuous and resource-intensive change detection Cascades typical in dynamic applications.

Applying OnPush to service-dependent components – those that eschew @Input properties in favor of retrieving data directly from services – necessitates a strategic approach. While it may seem advantageous to free components from superfluous inputs, the OnPush strategy, in this context, can introduce additional challenges. It becomes imperative to manage the subscription to data streams meticulously, ensuring that change detection is invoked accurately when the underlying service data mutates. Careless handling can lead to components with stale views, failing to reflect the current application state.

Lastly, a common coding mistake occurs when developers unintentionally mutate the state within components governed by OnPush. Consider the following:

// Incorrect: Mutating an array directly leads to change detection not being triggered

// Correct: Creating a new array reference for the change detection to recognize
this.items = [...this.items, newItem];

In this example, directly pushing an item to an array fails to trigger OnPush change detection due to reference equality. By spreading the existing items into a new array along with the new item, a new reference is created, spurring the OnPush mechanism into action. This highlights the critical importance of understanding reference versus value changes when working with OnPush.

Developers must carefully weigh the interplay between component structures and the change detection strategy employed. Could nesting smart components more deeply inadvertently lead to performance bottlenecks or stale data, even with OnPush enabled? It's a thought-provoking question warranting careful consideration in the quest for high-performance web applications with Angular.

One frequent error occurring when using the OnPush change detection strategy is treating mutable objects as if they were immutable. Since OnPush performs a shallow check on object references, directly modifying an object's property will not prompt a view update, leading to a state where the data model and the view are out of sync. Correct practice involves replacing the object with a new one whenever a change is needed. For example, instead of doing = newValue, the right approach would be to clone the object with the updated value:

this.myObject = { ...this.myObject, property: newValue };

Another pitfall is failing to trigger change detection after asynchronous operations, such as HTTP requests or timer events. This can be a subtle issue because developers might forget that these operations do not automatically notify Angular to run checks under OnPush. An observable hooked up to the async pipe in a template does trigger change detection, but other cases require manual intervention. Consider injecting the ChangeDetectorRef and invoking its markForCheck() method when you know changes have occurred requiring view updates.

constructor(private cdr: ChangeDetectorRef) { }

someAsyncOperation().subscribe(data => {
  this.dataModel = data;
  this.cdr.markForCheck(); // Ensures the view is updated

Furthermore, developers must tread carefully when managing state in stateful versus stateless components. Stateless or presentational components primarily rely on inputs and emit outputs without managing state explicitly, which works harmoniously with OnPush. In contrast, stateful or container components might demand a different approach. Although they can also benefit from OnPush, care must be taken to ensure that all state mutations result in the generation of new object references, or change detection is manually invoked when necessary.

When dealing with nested components, it's essential to propagate the mutation pattern throughout. A change in a child component must be communicated up to its parent component using a cloned object rather than directly mutating a shared object reference. This ensures that OnPush change detection in the parent triggers correctly.

// Child component
@Output() update = new EventEmitter();

onValueChange(newValue) {
  this.update.emit({ ...this.value, ...newValue });

Lastly, despite the performance gains offered by OnPush, it is paramount to understand that not all components benefit equally. Components frequently interacting with dynamic data sources or heavily engaged in user interactions might need careful strategies for change detection to prevent performance degradation or complex blowback in state management. Always review each component’s role within your application's data flow and interaction patterns to determine the suitability of OnPush.

// A stateful component that manages its data stream properly
private dataStreamSubscription: Subscription;

ngOnInit() {
  this.dataStreamSubscription = this.dataService
    .subscribe(data => {
      this.componentState = {};

ngOnDestroy() {

In essence, successful implementation of OnPush requires rigorous attention to detail when creating or updating state to maintain component performance and integrity.

Refactoring Components for OnPush Compatibility

To refactor existing Angular components for OnPush compatibility, begin with isolating each component that relies on input data and can be classified as a 'presentational' or 'dumb' component. These are the prime candidates for refactoring because their dependencies are most manageable. Start by setting their changeDetection property to ChangeDetectionStrategy.OnPush within the @Component metadata. This switches the component's change detection mechanism to only check for changes when new references are passed to its inputs, or when an event it subscribes to emits a new value.

The next step involves a thorough review of each targeted component's input properties. Replace all mutable data structures with immutable equivalents wherever possible. If using third-party libraries like Immutable.js is not an option, consider native JavaScript constructs such as Object.freeze for objects or spreading syntax for arrays when creating new instances. This ensures that any change to the data will require a new object reference, triggering the OnPush detection.

Assess all component methods that require triggering change detection manually. This particularly applies to asynchronous operations that resolve outside the Angular zone. In such instances, inject the ChangeDetectorRef service into your component to manually mark it for check with changeDetectorRef.markForCheck() once the asynchronous operations are complete. This approach ensures that OnPush components remain up to date with the latest state changes induced by interactions that occur outside Angular's awareness.

Moreover, you must audit all component interactions. Ensure that events, outputs, and child component inputs propagate changes clearly and do not mutate any data within the component. Employ techniques such as callback functions or reactive patterns with observables to facilitate such interactions. This guarantees that change detection flows as expected from child to parent components without any unpredictable side-effects.

Lastly, evaluate the overall architecture of your application to validate the global impact of these local component changes. The integration of OnPush components into your application should not compromise the performance gains by creating an excessive load on different system aspects, such as services or state management. By following these guidelines, the shift towards OnPush change detection will enhance performance while maintaining the maintainability and clarity of your Angular application's codebase.

Advanced OnPush Strategies and Observable Data Patterns

In the realm of Angular development, embracing reactive programming principles through RxJS observables enhances the effectiveness of OnPush change detection. When configuring components with OnPush, it becomes crucial to architect them around observable data streams. This ensures that change detection is performed in response to new values being emitted, in line with the reactive paradigm which orchestrates data as a continuous flow of events. For developers, it is imperative to handle data bindings using Angular's async pipe, as it subscribes to an observable and manages its lifecycle, guaranteeing that OnPush components refresh only upon receiving new observable emissions.

To harness observables with OnPush fully, an advanced technique involves architecting the component's logic into presentational and container components. Presentational components, intended for UI rendering, interact with data dynamically, be it static via inputs or streamed through observables, making them ideal for OnPush. Container components deal with business logic, manage state with observables, and communicate data to presentation components. By neatly segmenting roles and employing OnPush with observables, developers can build a reactive application that minimizes superfluous computations, delivering notable performance improvements.

However, the judicious management of observable data sources is paramount when implementing OnPush. Developers should opt for delineated subjects or observables tailored to specific data streams to circumvent superfluous updates across various components. Moreover, within component events that induce state changes, it is preferable to release an immutable data structure over mutating the existing one, thereby leveraging OnPush detection naturally. By following these practices, developers can avert common pitfalls such as memory leaks while preserving the application’s reactivity.

In the pursuit of effective OnPush strategies paired with Angular, the prioritization of state immutability is essential. Developers should habitually create new objects to reflect updated values instead of modifying existing structures, a principle that aligns with reactive programming standards. Combined with RxJS’s powerful operators such as map, scan, or combineLatest, developers can facilitate the propagation of state changes through the application, signaling OnPush components to update accordingly. This coupling of observables and immutability not only enhances scalability but also fosters a maintainable codebase, boosting Angular application performance.

While the synergy of OnPush with observables can serve as a catalyst for transformation, it demands a dedicated adherence to reactive programming fundamentals across the application's architecture. Integrating observables should be intrinsic to component design, not an auxiliary consideration. By embracing a reactive mindset from the start, developers ensure the full utilization of Angular's change detection capabilities, paving the way for robust web applications that respond swiftly to user interactions and fluctuating states.


In this article, the author explores the OnPush change detection strategy in Angular and its impact on component optimization. The article delves into the importance of immutability in leveraging OnPush, provides insights on implementing OnPush in complex component hierarchies, and offers tips for navigating common pitfalls and challenges. The author also highlights the intersection of OnPush with RxJS observables and the benefits of combining these strategies for high-performance components. The article concludes by encouraging readers to refactor their existing Angular components for OnPush compatibility and suggests an advanced task of architecting components around observable data streams to maximize the effectiveness of OnPush change detection.

Don't Get Left Behind:
The Top 5 Career-Ending Mistakes Software Developers Make
FREE Cheat Sheet for Software Developers