Angular throws an
ExpressionChangedAfterItHasBeenCheckedError when an expression value has been changed after change detection has completed. Angular only throws this error in development mode.
In development mode, Angular performs an additional check after each change detection run, to ensure the bindings haven’t changed. This catches errors where the view is left in an inconsistent state. This can occur, for example, if a method or getter returns a different value each time it is called, or if a child component changes values on its parent. If either of these occur, this is a sign that change detection is not stabilized. Angular throws the error to ensure data is always reflected correctly in the view, which prevents erratic UI behavior or a possible infinite loop.
This error commonly occurs when you’ve added template expressions or begun to implement lifecycle hooks like
ngOnChanges. It is also common when dealing with loading status and asynchronous operations, or a child component changes its parent bindings.
The source maps generated by the CLI are very useful when debugging. Navigate up the call stack until you find a template expression where the value displayed in the error has changed.
Ensure that there are no changes to the bindings in the template after change detection is run. This often means refactoring to use the correct component lifecycle hook for your use case. If the issue exists within
ngAfterViewInit, the recommended solution is to use a constructor or
ngOnInit to set initial values, or use
ngAfterContentInit for other value bindings.
If you are binding to methods in the view, ensure that the invocation does not update any of the other bindings in the template.
Read more about which solution is right for you in 'Everything you need to know about the "ExpressionChangedAfterItHasBeenCheckedError" error' and why this is useful at 'Angular Debugging "Expression has changed after it was checked": Simple Explanation (and Fix)'.
© 2010–2021 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.