Provide a convenient mechanism for accessing requests and response. Register and iterate through the registered middlewares on request. When the last registered middleware is resolved, the passed route as argument is called.

Part of Esrol

Installation

$ npm install --save esrol-middlewares

Node Version Compatibility

| Node Version | | ---- | | >= 4.x |

Usage

'use strict';
let http = require('http');
let Middlewares = require ('esrol-middlewares');
let middlewares = new Middlewares();

middlewares.registerMiddleware({
  priority: 1,
  middleware: function(req, res, next){
    // some code
    req.iterator++;
    console.log ('step 1');
    next();
  }
});

middlewares.registerMiddleware({
  priority: 2,
  middleware: function(req, res, next) {
    // some code
    setTimeout(() => {
      // some code
      req.iterator++;
      console.log ('step 2');
      next();
    }, 1000);
  }
});

middlewares.registerMiddleware({
  priority: 3,
  middleware: function(req, res, next) {
    // some code
    req.iterator++;
    console.log ('step 3');
    next();
  }
});

let router = {
  route: function(req, res) {
    console.log ('Request passed through %s middlewares', req.iterator);
  }
};

http.createServer((req, res) => {
  req.iterator = 0;
  middlewares.onRequest(req, res, router.route, router);
}).listen(3333);
console.log('Server is listening on port: 3333');

Please see the docs here, for information how to use middlewares

Methods

registerMiddleware(middleware) ⇒ array

Register middleware

Returns: array - this._queue - registered middlewares
Throws:

• error catchAndConsoleLogThisErrorForMoreInfo - throws error when incorrect arguments are passed

| Param | Type | Description | | --- | --- | --- | | middleware | object | {priority: 1, onRequest: function(req, res, next)} |

onRequest(req, res, route) ⇒ mixed

Call this method when you need to pass the request through the middleware

Returns: mixed - value - the returned value from the last middleware
Scope: object scope - set scope for route param

| Param | Type | Description | | --- | --- | --- | | req | object | http(s) request | | res | object | http(s) response | | route | function | the function which will be called when all middlewares are resolved |

Contriubtion

Any contribution will be highly appreciated. Just make sure that:

1. Your code works.
2. You have 100% successful tests coverage.
3. You have comments in your code.
4. Follows eslint config. Exceptions are possible where that make sense.

Tests

To run the test suite, first install the dependencies, then run npm test:

$ npm install
$ npm test

License

MIT