Node's Package Magician

npm

Need private packages and team management tools?Check out npm Orgs. »

node-hmr

1.2.0 • Public • Published

node-hmr

Build Status Coverage Status License: MIT

🔥 Hot Module Replacement for Node.js

This module adds hot module replacement support for node.js applications, it intended as an alternative to such tools like nodemon. Reloading modules while an application is running significantly faster than full reloading which in some cases may add additional downtime to a development process.

Inspired by this article https://codeburst.io/dont-use-nodemon-there-are-better-ways-fc016b50b45e

API

hmr(callback, [options])
  • callback Function which will be called each time when some file was changed
  • options Options object. Optional
    • debug Show list of modules which was removed from the cache. Default: false
    • watchDir Relative path to the directory to be watched recursively. Default: directory of the current module
    • chokidar Chokidar options

Usage

const hmr = require('node-hmr');
 
hmr(() => {
  require('./path_to_your_script');
});

How to use it with frameworks

You should split your application into two parts first is server setup and second is application module. Below are examples of how to use it with some popular frameworks.

Express.js with HMR example

app.js

const express = require('express');
const app = express();
 
app.get('/', (req, res, next) => {
  res.send('Express');
});
 
module.exports = app;

bin/www

const http = require('http');
const hmr = require('node-hmr');
 
let app;
 
hmr(() => {
  app = require('../app');
}, { watchDir: '../' });
 
const server = http.createServer((req, res) => app(req, res));
 
server.listen(3000);

Koa.js with HMR example

app.js

const Koa = require('koa');
const app = new Koa();
 
app.use(async ctx => {
  ctx.body = 'Koa';
});
 
module.exports = app;

index.js

const hmr = require('node-hmr');
 
let callback;
hmr(() => {
  const app = require('./app');
  callback = app.callback();
});
 
const server = http.createServer((req, res) => callback(req, res));
server.listen(3000);

Limitations

In some cases, HMR may not work correctly with libraries which using some internal caching storage Mongoose is the example of one. If you see this error message Cannot overwrite `User` model once compiled the workaround could be add the following syntax to each model declaration, but in this case changes to the model will not be 'hot reloaded'.

module.exports = mongoose.models.Users || mongoose.model('Users', UsersSchema);

License

MIT

install

npm i node-hmr

Downloadsweekly downloads

179

version

1.2.0

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability