fix(upgrade): fix HMR for hybrid applications by gkalpak · Pull Request #40045 · angular/angular

gkalpak · 2020-12-09T15:38:33Z

Previously, trying to apply a change via Hot Module Replacement (HMR) in a hybrid app would result in an error. This was caused by not having the AngularJS app destroyed and thus trying to bootstrap an AngularJS app on the same element twice.

This commit fixes HMR for hybrid apps by ensuring the AngularJS app is destroyed when the Angular PlatformRef is destroyed in the module.hot.dispose() callback.

NOTE:
For "ngUpgradeLite" apps (i.e. those using downgradeModule()), HMR will only work if the downgraded module has been bootstrapped and there is at least one Angular component present on the page. The is due to a combination of two facts:

The logic for setting up the listener that destroys the AngularJS app depends on the downgraded module's NgModuleRef, which is only available after the module has been bootstrapped.
The HMR dispose logic depends on having an Angular element (identified by the auto-geenrated ng-version attribute) present in the DOM in order to retrieve the Angular PlatformRef.

Fixes #39935.

mary-poppins · 2020-12-09T15:50:14Z

You can preview 204e21e at https://pr40045-204e21e.ngbuilds.io/.

jelbourn

LGTM

Reviewed-for: public-api

jelbourn · 2020-12-09T16:58:08Z

packages/upgrade/src/dynamic/src/upgrade_adapter.ts

Might be useful to link to #39935 in this comment

jelbourn · 2020-12-09T16:59:14Z

packages/upgrade/src/common/src/util.ts

nit: could probably use a JsDoc description on this function and on destroy app (which IDEs will pick up)

atscott

Reviewed-for: public-api

atscott · 2020-12-09T17:06:21Z

presubmit

AndrewKushnir

Reviewed-for: public-api

petebacondarwin

Can you explain why this is the case?

For "ngUpgradeLite" apps (i.e. those using downgradeModule()), HMR
will only work if there is at least one Angular component present on the
page.

petebacondarwin · 2020-12-10T11:40:12Z

packages/upgrade/src/dynamic/src/upgrade_adapter.ts

Suggested change

// other usecases where desposing of an Angular/AngularJS app is necessary (such

// other use-cases where disposing of an Angular/AngularJS app is necessary (such

Ooops 😅 Fixed.

petebacondarwin · 2020-12-10T11:40:34Z

packages/upgrade/src/dynamic/test/upgrade_spec.ts

petebacondarwin · 2020-12-10T11:47:17Z

packages/upgrade/static/src/downgrade_module.ts

Suggested change

// other usecases where desposing of an Angular/AngularJS app is necessary (such

// other use-cases where disposing of an Angular/AngularJS app is necessary (such

Ooops 😅 Fixed.

This commit removes a couple of unused variables.

This commit moves the code for cleaning jqLite/jQuery data on an element to a re-usable helper function. This way it is easier to keep the code consistent across all places where we need to clean data (now and in the future).

…data

Previously, trying to apply a change via Hot Module Replacement (HMR) in a hybrid app would result in an error. This was caused by not having the AngularJS app destroyed and thus trying to bootstrap an AngularJS app on the same element twice. This commit fixes HMR for hybrid apps by ensuring the AngularJS app is destroyed when the Angular `PlatformRef` is [destroyed][1] in the [`module.hot.dispose()` callback][2]. NOTE: For "ngUpgradeLite" apps (i.e. those using `downgradeModule()`), HMR will only work if the downgraded module has been bootstrapped and there is at least one Angular component present on the page. The is due to a combination of two facts: - The logic for setting up the listener that destroys the AngularJS app depends on the downgraded module's `NgModuleRef`, which is only available after the module has been bootstrapped. - The [HMR dispose logic][3] depends on having an Angular element (identified by the auto-geenrated `ng-version` attribute) present in the DOM in order to retrieve the Angular `PlatformRef`. [1]: https://github.com/angular/angular-cli/blob/205ea2b638f154291993bfd9e065cd66ff20503/packages/angular_devkit/build_angular/src/webpack/plugins/hmr/hmr-accept.ts#L75 [2]: https://github.com/angular/angular-cli/blob/205ea2b638f154291993bfd9e065cd66ff205033/packages/angular_devkit/build_angular/src/webpack/plugins/hmr/hmr-accept.ts#L31 [3]: https://github.com/angular/angular-cli/blob/205ea2b638f154291993bfd9e065cd66ff205033/packages/angular_devkit/build_angular/src/webpack/plugins/hmr/hmr-accept.ts#L116 Fixes angular#39935

gkalpak · 2020-12-10T17:22:03Z

For "ngUpgradeLite" apps (i.e. those using downgradeModule()), HMR will only work if there is at least one Angular component present on the page.

Can you explain why this is the case?

Expanded on this in the commit message. (Also updated the PR description.)

Thx for the reviews. I have addressed the comments. Marking for merging...

mary-poppins · 2020-12-10T17:25:20Z

You can preview 885710a at https://pr40045-885710a.ngbuilds.io/.

This commit removes a couple of unused variables. PR Close #40045

…40045) This commit moves the code for cleaning jqLite/jQuery data on an element to a re-usable helper function. This way it is easier to keep the code consistent across all places where we need to clean data (now and in the future). PR Close #40045

Previously, trying to apply a change via Hot Module Replacement (HMR) in a hybrid app would result in an error. This was caused by not having the AngularJS app destroyed and thus trying to bootstrap an AngularJS app on the same element twice. This commit fixes HMR for hybrid apps by ensuring the AngularJS app is destroyed when the Angular `PlatformRef` is [destroyed][1] in the [`module.hot.dispose()` callback][2]. NOTE: For "ngUpgradeLite" apps (i.e. those using `downgradeModule()`), HMR will only work if the downgraded module has been bootstrapped and there is at least one Angular component present on the page. The is due to a combination of two facts: - The logic for setting up the listener that destroys the AngularJS app depends on the downgraded module's `NgModuleRef`, which is only available after the module has been bootstrapped. - The [HMR dispose logic][3] depends on having an Angular element (identified by the auto-geenrated `ng-version` attribute) present in the DOM in order to retrieve the Angular `PlatformRef`. [1]: https://github.com/angular/angular-cli/blob/205ea2b638f154291993bfd9e065cd66ff20503/packages/angular_devkit/build_angular/src/webpack/plugins/hmr/hmr-accept.ts#L75 [2]: https://github.com/angular/angular-cli/blob/205ea2b638f154291993bfd9e065cd66ff205033/packages/angular_devkit/build_angular/src/webpack/plugins/hmr/hmr-accept.ts#L31 [3]: https://github.com/angular/angular-cli/blob/205ea2b638f154291993bfd9e065cd66ff205033/packages/angular_devkit/build_angular/src/webpack/plugins/hmr/hmr-accept.ts#L116 Fixes #39935 PR Close #40045

…40045) This commit moves the code for cleaning jqLite/jQuery data on an element to a re-usable helper function. This way it is easier to keep the code consistent across all places where we need to clean data (now and in the future). PR Close #40045

Previously, trying to apply a change via Hot Module Replacement (HMR) in a hybrid app would result in an error. This was caused by not having the AngularJS app destroyed and thus trying to bootstrap an AngularJS app on the same element twice. This commit fixes HMR for hybrid apps by ensuring the AngularJS app is destroyed when the Angular `PlatformRef` is [destroyed][1] in the [`module.hot.dispose()` callback][2]. NOTE: For "ngUpgradeLite" apps (i.e. those using `downgradeModule()`), HMR will only work if the downgraded module has been bootstrapped and there is at least one Angular component present on the page. The is due to a combination of two facts: - The logic for setting up the listener that destroys the AngularJS app depends on the downgraded module's `NgModuleRef`, which is only available after the module has been bootstrapped. - The [HMR dispose logic][3] depends on having an Angular element (identified by the auto-geenrated `ng-version` attribute) present in the DOM in order to retrieve the Angular `PlatformRef`. [1]: https://github.com/angular/angular-cli/blob/205ea2b638f154291993bfd9e065cd66ff20503/packages/angular_devkit/build_angular/src/webpack/plugins/hmr/hmr-accept.ts#L75 [2]: https://github.com/angular/angular-cli/blob/205ea2b638f154291993bfd9e065cd66ff205033/packages/angular_devkit/build_angular/src/webpack/plugins/hmr/hmr-accept.ts#L31 [3]: https://github.com/angular/angular-cli/blob/205ea2b638f154291993bfd9e065cd66ff205033/packages/angular_devkit/build_angular/src/webpack/plugins/hmr/hmr-accept.ts#L116 Fixes #39935 PR Close #40045

angular-automatic-lock-bot · 2021-01-11T16:57:23Z

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

_{This action has been performed automatically by a bot.}

google-cla bot added the cla: yes label Dec 9, 2020

gkalpak added area: upgrade Issues related to AngularJS → Angular upgrade APIs target: patch This PR is targeted for the next patch release type: bug/fix labels Dec 9, 2020

ngbot bot modified the milestone: Backlog Dec 9, 2020

gkalpak marked this pull request as ready for review December 9, 2020 16:00

gkalpak added the action: merge The PR is ready for merge by the caretaker label Dec 9, 2020

pullapprove bot requested review from AndrewKushnir, alxhub, atscott and jelbourn December 9, 2020 16:00

gkalpak requested a review from petebacondarwin December 9, 2020 16:00

jelbourn approved these changes Dec 9, 2020

View reviewed changes

atscott approved these changes Dec 9, 2020

View reviewed changes

pullapprove bot requested a review from IgorMinar December 9, 2020 17:04

pullapprove bot removed the area: upgrade Issues related to AngularJS → Angular upgrade APIs label Dec 9, 2020

ngbot bot removed this from the Backlog milestone Dec 9, 2020

AndrewKushnir approved these changes Dec 9, 2020

View reviewed changes

AndrewKushnir added the action: presubmit The PR is in need of a google3 presubmit label Dec 9, 2020

mhevery added the area: upgrade Issues related to AngularJS → Angular upgrade APIs label Dec 9, 2020

ngbot bot added this to the Backlog milestone Dec 9, 2020

pullapprove bot removed the area: upgrade Issues related to AngularJS → Angular upgrade APIs label Dec 9, 2020

ngbot bot removed this from the Backlog milestone Dec 9, 2020

gkalpak added action: cleanup The PR is in need of cleanup, either due to needing a rebase or in response to comments from reviews and removed action: merge The PR is ready for merge by the caretaker labels Dec 9, 2020

petebacondarwin approved these changes Dec 10, 2020

View reviewed changes

gkalpak removed request for IgorMinar and alxhub December 10, 2020 16:46

gkalpak added 5 commits December 10, 2020 19:13

refactor(upgrade): remove unused variables

c1f5f66

This commit removes a couple of unused variables.

fixup! refactor(upgrade): create a helper for cleaning jqLite/jQuery …

e80c8f5

…data

fixup! fix(upgrade): fix HMR for hybrid applications

885710a

gkalpak force-pushed the fix-upgrade-hmr branch from 204e21e to 885710a Compare December 10, 2020 17:14

gkalpak added action: merge The PR is ready for merge by the caretaker and removed action: cleanup The PR is in need of cleanup, either due to needing a rebase or in response to comments from reviews labels Dec 10, 2020

alxhub pushed a commit that referenced this pull request Dec 10, 2020

refactor(upgrade): remove unused variables (#40045)

9a28ddf

This commit removes a couple of unused variables. PR Close #40045

alxhub closed this in 61376d5 Dec 10, 2020

gkalpak deleted the fix-upgrade-hmr branch December 11, 2020 15:28

angular-automatic-lock-bot bot locked and limited conversation to collaborators Jan 11, 2021

	// other usecases where desposing of an Angular/AngularJS app is necessary (such
	// other use-cases where disposing of an Angular/AngularJS app is necessary (such

Conversation

gkalpak commented Dec 9, 2020 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mary-poppins commented Dec 9, 2020

Uh oh!

jelbourn left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

atscott left a comment

Choose a reason for hiding this comment

Uh oh!

atscott commented Dec 9, 2020

Uh oh!

AndrewKushnir left a comment

Choose a reason for hiding this comment

Uh oh!

petebacondarwin left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

gkalpak commented Dec 10, 2020

Uh oh!

mary-poppins commented Dec 10, 2020

Uh oh!

angular-automatic-lock-bot bot commented Jan 11, 2021

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

gkalpak commented Dec 9, 2020 •

edited

Loading