JSPM – express-unless@0.1.0

Package Exports

express-unless

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (express-unless) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Conditionally skip a middleware when a condition is met.

Install

npm i express-unless --save

Usage

With existing middlewares:

var unless = require('express-unless');


var static = express.static(__dirname + '/public');
static.unless = unless;

app.use(static.unless({ method: 'OPTIONS' }));

If you are authoring a middleware you can support unless as follow:

module.exports = function (middlewareOptions) {
  var mymid = function (req, res, next) {

  };

  mymid.unless = require('express-unless');

  return mymid;
};

Current options

method it could be an string or an array of strings. If the request method match the middleware will not run.
path it could be an string, a regexp or an array of any of those. If the request path match, the middleware will not run.
ext it could be an string or an array of strings. If the request path ends with one of these extensions the middleware will not run.
custom it must be a function that accepts req and returns true / false. If the function returns true for the given request, ithe middleware will not run.
useOriginalUrl it should be true or false, default is true. if false, path will match against req.url instead of req.originalUrl. Please refer to Express API for the difference between req.url and req.originalUrl.

Examples

Require authentication for every request unless the path is index.html.

app.use(requiresAuth.unless({ path: ['/index.html', '/'] }))

Avoid a fstat for request to routes doesnt end with a given extension.

app.use(static.unless(function (req) {
  var ext = url.parse(req.originalUrl).pathname.substr(-4);
  return !~['.jpg', '.html', '.css', '.js'].indexOf(ext);
}));

License

MIT 2014 - Jose Romaniello