0.2.0 • Published 8 years ago

esrol-middlewares v0.2.0

Weekly downloads
4
License
MIT
Repository
github
Last release
8 years ago

NPM version Build Status Test coverage

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
ParamTypeDescription
middlewareobject{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

ParamTypeDescription
reqobjecthttp(s) request
resobjecthttp(s) response
routefunctionthe 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

0.2.0

8 years ago

0.1.9

8 years ago

0.1.8

8 years ago

0.1.6

8 years ago

0.1.5

8 years ago

0.1.4

8 years ago

0.1.3

8 years ago

0.1.2

8 years ago