DEV Community

Cover image for Angular Component Guide: How ngOnChanges Hook Works ?
Hasan Teoman Tıngır
Hasan Teoman Tıngır

Posted on

Angular Component Guide: How ngOnChanges Hook Works ?

Angular is a very modern and powerfull framework comes with tons of core features like dependency injection, content projection, advanced component lifecycle hooks and so on. Some developers claim it makes angular complex and cumbersome. In my opinion it makes angular productive. You can developer large scale application with less amount of time and complexity. Angular provides lots of handy features which you don't have to develop it from scratch.

In this post I would like to focus lifecycle hooks, what they are and how we can use effectively. I see that most of developers new to angular makes a lot of mistakes. I believe it is because we are tend to avoid reading documentation :D But no worries. If you don't know anything about the hooks or you are looking for some usefull tips, we will cover in this post starting with ngOnChanges

Let discover ngOnChanges()

This is the first hook invoked in the component. Angular calls the ngOnChanges when the inputs initialized and updated. But there is one critical detail about this hook. If your component doesn't have any input Angular will never invoke ngOnChanges.

When ngOnChanges called, angular pass a parameter with type of SimpleChanges. It is a dictionary of input properties that contains previous and current value of the propery.

When should we use ngOnChanges() ?

Most of developers using angular don't even know there is a such hook! It is quite handy specially when you are working with 3.rd party libraries.

1. Working With 3.rd Party Libraries

When you are working with 3.rd party libraries sometime you are not able to update the state using angular lifecycle. Let say you are showing some live GPS data on google maps. When you receive the latest coordinate, you need to update the position of the coordinate right ? We created the marker ngOnInit hook with the first coordinate, but then when the coordinate has changed, we can setup ngOnChanges() hook and listen following changes.

Image description

Update Map Center When Location Input Has Changed

2. Making recurring API calls

If your components needs to fetch some data from a external service or API based on input. You can easly listen input changes using ngOnChanges and make consecutive api calls.

Image description
Fetch Step File From Server When FileId Input Property Has Changed

3. Component Validation and Security

If your component is fragile and relies what you get from input properties, you do better if you validate your input values using ngOnChanges. You can easily filter out invalid values and show senseful messages.

Image description

Validate Data Type When Input Property Has Changed

4. Debugging The Component

When you are developing a component that have input properties frequently updated. You might need to use ngOnChanges when you debug the component to check everything is working fine.

Image description

Debug Component When Input Properties Has Changed

When should we NOT use ngOnChanges() ?

1. Initialization Logic

When you are perform some initialization logic that should be made one time, you should use ngOnInit hook over ngOnChanges. Since ngOnChanges called when the input properties change, it might break your initialization configuration when it get called multiple times.

2. Cleanup Operations

When the component needs to perform some cleanup logic: If the component needs to perform some cleanup logic when it is destroyed, then ngOnDestroy should be used instead of ngOnChanges.

Conclusion

Hooks are very powerfull and handy features. We should use more often instead trying to develop a workaround which we can achieve with the hooks in couple line of codes. But you need to be carefull when you are using it. For example in the ngOnChanges if you emit an event that might effect input properties in the parent component. It might leads sirious performance problems. We must be precise when should we use hooks, specially using ngOnChanges.

I tried to explain hooks and specially ngOnChanges in general. If you have questions about hooks or anything about angular feel fre to ask me.

If you would like to learn more about the angular you can visit one of the following links;

Top comments (0)