Angular 6 View is not updated after changing a variable within subscribe

TypescriptAngular6ObservableRxjs6Angular Changedetection

Typescript Problem Overview


Why is the view not being updated when a variable changes within a subscribe?

I have this code:

example.component.ts

testVariable: string;

ngOnInit() {
    this.testVariable = 'foo';

    this.someService.someObservable.subscribe(
        () => console.log('success'),
        (error) => console.log('error', error),
        () => {
            this.testVariable += '-bar';

            console.log('completed', this.testVariable);
            // prints: foo-Hello-bar
        }
    );

    this.testVariable += '-Hello';
}

example.component.html

{{testVariable}}

But the view displays: foo-Hello.

Why won't it display: foo-Hello-bar?

If I call ChangeDetectorRef.detectChanges() within the subscribe it will display the proper value, but why do I have to do this?

I shouldn't be calling this method from every subscribe, or, at all (angular should handle this). Is there a right way?

Did I miss something in the update from Angular/rxjs 5 to 6?

Right now I have Angular version 6.0.2 and rxjs 6.0.0. The same code works ok in Angular 5.2 and rxjs 5.5.10 without the need of calling detectChanges.

Typescript Solutions


Solution 1 - Typescript

As far as I know, Angular is only updating the view, if you change data in the "Angular zone". The asynchronous call in your example does not qualify for this. But if you want, you can put it in the Angular zone or use rxjs or extract part of the code to a new component to solve this problem. I will explain all:

EDIT: It seems like not all solutions are working anymore. For most users the first Solution "Angular Zone" does the job.

1 Angular Zone

> The most common use of this service is to optimize performance when starting a work consisting of one or more asynchronous tasks that don't require UI updates or error handling to be handled by Angular. Such tasks can be kicked off via runOutsideAngular and if needed, these tasks can reenter the Angular zone via run. https://angular.io/api/core/NgZone

The key part is the "run" function. You could inject NgZone and put your value update in the run callback of the NgZone object:

constructor(private ngZone: NgZone ) { }
testVariable: string;

ngOnInit() {
   this.testVariable = 'foo';

   this.someService.someObservable.subscribe(
      () => console.log('success'),
      (error) => console.log('error', error),
      () => {
      this.ngZone.run( () => {
         this.testVariable += '-bar';
      });
      }
   );
}

According to this answer, it would cause the whole application to detect changes, whereas your ChangeDetectorRef.detectChanges approach would only detect changes in your component and it's descendants.

2 RxJS

Another way would be to use rxjs to update the view. When you first subscribe to a ReplaySubject, it will give you the latest value. A BehaviorSubject is basically the same, but allows you to define a default value (makes sense in your example, but does not necessary be the right choice all the time). After this initial emission is it basically a normal Replay Subject:

this.testVariable = 'foo';
testEmitter$ = new BehaviorSubject<string>(this.testVariable);


ngOnInit() {

   this.someService.someObservable.subscribe(
      () => console.log('success'),
      (error) => console.log('error', error),
      () => {
         this.testVariable += '-bar';
         this.testEmitter.next(this.testVariable);
      }
   );
}

In your view, you could subscribe to the Subject using the async pipe:

{{testEmitter$ | async}}

3 Extract code to new Component

If you submit the string to another component, it will also be updated. You would have to use the @Input() selector in the new component.

So the new component has code like this:

@Input() testVariable = '';

And the testVariable is assigned in the HTML like before with curly brakets.

In the parent HTML View you can then pass the variable of the parentelement to the child element:

<app-child [testVariable]="testVariable"></app-child>

This way you are in the Angular zone.

4 Personal preference

My personal preference is to use the rxjs or the component way. Using detectChanges oder NGZone feels more hacky to me.

Solution 2 - Typescript

For me none of the above worked. However, ChangeDetectorRef did the trick.

From angular docs; this is how you can implement it

    class GiantList {
      constructor(private ref: ChangeDetectorRef, public dataProvider: DataListProvider) {
        ref.detach();
        setInterval(() => { this.ref.detectChanges(); }, 5000);
      }
    }

https://angular.io/api/core/ChangeDetectorRef

Solution 3 - Typescript

Important notice - Short way in subjects can makes problem!

I know it's not exactly what the PO asked, but there is sometimes very common problem that can happen, and maybe it will be helpful for someone.

It's very simple, and also I didn't inspect the issue deeply.

But in my case the problem was that I have used in short syntax for subscribe the subject to observable instead of full, and when I have changed it, it solved the issue.

So While this didn't work :

myServiceObservableCall.subscribe(this.myBehavSubj)

and with the same behavior that on log I am seeing the changes properly, only on the view not.

This does update the view :

myServiceObservableCall.subscribe((res)=>{
        this.myBehavSubj.next(res);
      } );

Although it's seems to be the same and the above only short-way syntax .

You are invited to explain the reason

Solution 4 - Typescript

The way I found that works best is to just wrap the variable assignment in a setTimeout() function. Angular's NgZone change detection checks for changes anytime a setTimeout() function is called. Example using the code in the question:


ngOnInit() {
    this.testVariable = 'foo';

    this.someService.someObservable.subscribe(
        () => console.log('success'),
        (error) => console.log('error', error),
        () => {
            setTimeout(() => { this.testVariable += '-bar'; }, 0); // Here's the line

            console.log('completed', this.testVariable);
            // prints: foo-Hello-bar
        }
    );

    this.testVariable += '-Hello';
}

Solution 5 - Typescript

I came here because cdkVirtualFor didn't update with new items pushed in array. So if anybody has the same issue, the source of the problem is that cdkVirtualFor will only be updated when the array is updated immutably.

Like this for example:

addNewItem(){
    let  newItem= {'name':'stack'};
    this.myItemArray = [...this.myList, newItem];
  }

Solution 6 - Typescript

All the solutions above are great. However, I found an easier solution that I believe will apply to most cases when trying to refresh the UI with new data from an external service.

The idea is pretty simple, set a loading flag, show the spinner while new data is getting fetched and then clear the spinner by resetting the flag:

getData() {
 // Set loading spinner
 this.loading = true;
 this.service.getData().subscribe((data: any) => {
   this.newData = data;
   //Remove loading spinner
   this.loading = false;
 });

}

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionDanny MencosView Question on Stackoverflow
Solution 1 - TypescriptbesserwisserView Answer on Stackoverflow
Solution 2 - TypescriptDalorzoView Answer on Stackoverflow
Solution 3 - TypescriptlingarView Answer on Stackoverflow
Solution 4 - TypescriptDerek J.View Answer on Stackoverflow
Solution 5 - TypescriptVladimir FilipovicView Answer on Stackoverflow
Solution 6 - TypescriptSagar PatelView Answer on Stackoverflow