HMR
Hot Module Replacement (HMR) is a Webpack feature to update code in a running app without rebuilding it. This results in faster updates and less full page-reloads. In order to get HMR working with Angular CLI we first need to add a new environment and enable it.
As of Angular v10, HMR is no longer supported and will be deprecated.As a workaround to keep store's state on full-page reloads you can use@ngxs/storage-plugin. Here's a basic implementation example​
Add environment for HMR
In this step we will configure the Angular CLI environments and define in which environment we enable HMR. We will start out by adding and changing files in the
src/environments/ directory. First we create a file called src/environments/environment.hmr.ts with the following contents:1
export const environment = {
2
production: false,
3
hmr: true
4
};
Copied!
Update
src/environments/environment.prod.ts and add the hmr: false flag to the environment:1
export const environment = {
2
production: true,
3
hmr: false
4
};
Copied!
Lastly we edit
src/environments/environment.ts and change the environment to:1
export const environment = {
2
production: false,
3
hmr: false
4
};
Copied!
Update angular.json to include an hmr environment as explained here and add configurations within build and serve to enable hmr. Note that \ here represents the name of the project you are adding this configuration to in angular.json.
1
"build": {
2
"configurations": {
3
...
4
"hmr": {
5
"fileReplacements": [
6
{
7
"replace": "src/environments/environment.ts",
8
"with": "src/environments/environment.hmr.ts"
9
}
10
]
11
}
12
}
13
},
14
...
15
"serve": {
16
"configurations": {
17
...
18
"hmr": {
19
"hmr": true,
20
"browserTarget": "<project-name>:build:hmr"
21
}
22
}
23
}
Copied!
Add the necessary types to src/tsconfig.app.json
1
{
2
...
3
"compilerOptions": {
4
...
5
"types": ["node"]
6
},
7
}
Copied!
Run ng serve with the flag --configuration hmr to enable hmr and select the new environment:
1
ng serve --configuration hmr
Copied!
Create a shortcut for this by updating package.json and adding an entry to the script object:
1
"scripts": {
2
...
3
"hmr": "ng serve --configuration hmr"
4
}
Copied!
Add dependency and configure app
In order to get HMR working we need to install the dependency and configure our app to use it.
Install the
@ngxs/hmr-plugin package as a dev-dependencyUpdate src/main.ts to use the file we just created:
1
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
2
import { enableProdMode, NgModuleRef } from '@angular/core';
3
​
4
import { AppModule } from './app/app.module';
5
import { environment } from './environments/environment';
6
​
7
if (environment.production) {
8
enableProdMode();
9
}
10
​
11
const bootstrap = () => platformBrowserDynamic().bootstrapModule(AppModule);
12
​
13
if (environment.hmr) {
14
import('@ngxs/hmr-plugin').then(plugin => {
15
plugin.hmr(module, bootstrap).catch((err: Error) => console.error(err));
16
});
17
} else {
18
bootstrap().catch((err: Error) => console.log(err));
19
}
Copied!
The
@ngxs/hmr-plugin should be loaded on demand using dynamic import thus this can benefit more readily from tree shaking.(OPTIONAL) Update src/app/app.module.ts to manage the state in HMR lifecycle:
1
import { StateContext } from '@ngxs/store';
2
import { NgxsHmrLifeCycle, NgxsHmrSnapshot as Snapshot } from '@ngxs/hmr-plugin';
3
​
4
@NgModule({ .. })
5
export class AppBrowserModule implements NgxsHmrLifeCycle<Snapshot> {
6
public hmrNgxsStoreOnInit(ctx: StateContext<Snapshot>, snapshot: Partial<Snapshot>) {
7
ctx.patchState(snapshot);
8
}
9
​
10
public hmrNgxsStoreBeforeOnDestroy(ctx: StateContext<Snapshot>): Partial<Snapshot> {
11
return ctx.getState();
12
}
13
}
Copied!
Starting the development environment with HMR enabled
Now that everything is set up we can run the new configuration:
1
npm run hmr
Copied!
Example:
hmr
When starting the server Webpack will tell you that it’s enabled:
1
NOTICE Hot Module Replacement (HMR) is enabled for the dev server.
Copied!
Now if you make changes to one of your components, those changes should be visible automatically without a complete browser refresh.
HMR lifecycle
If you want to do some modifications to the state during the hmr lifecycle you can use these built-in actions. They will not be executed in production.
1
import { HmrInitAction, HmrBeforeDestroyAction } from '@ngxs/hmr-plugin';
2
​
3
@State({ ... })
4
@Injectable()
5
export class MyState {
6
@Action(HmrInitAction)
7
public hmrInit(ctx: StateContext, { payload }) {
8
ctx.setState({ ... })
9
}
10
​
11
@Action(HmrBeforeDestroyAction)
12
public hrmBeforeDestroy(ctx: StateContext, { payload }) {
13
ctx.setState({ ... })
14
}
15
}
Copied!
HMR Options
The following options are available:
autoClearLogs- Clear logs after each refresh (default value istrue).deferTime- Deferred time before loading the old state (default value is100ms);
1
import('@ngxs/hmr-plugin').then(plugin => {
2
plugin
3
.hmr(module, bootstrap, {
4
deferTime: 100,
5
autoClearLogs: true
6
})
7
.catch((err: Error) => console.error(err));
8
});
Copied!
HMR Utils
hmrIsReloaded- returnstrueif the application was hot module replaced at least once or more.
Examples:
1
import { hmrIsReloaded } from '@ngxs/hmr-plugin';
2
​
3
@Component({})
4
class SomeComponent implements OnDestroy {
5
ngOnDestroy(): void {
6
if (hmrIsReloaded()) {
7
return;
8
}
9
​
10
// heavy logic
11
}
12
}
Copied!
Last modified 1yr ago