/lux-unless

Conditionally add a middleware to Lux with some common patterns.

Primary LanguageJavaScriptMIT LicenseMIT

Conditionally skip a middleware.

Build Status Coverage Status npm version

This is a port of express-unless to the Lux API framework.

Install

npm i lux-unless --save

Usage

You can use lux-unless in Lux with a middleware called myMiddleware as follows:

import unless from 'lux-unless';

class ApplicationController extends Controller {
    beforeAction = [
        unless({path: ['/users/login']}, myMiddleware)
    ];
}

Current options

  • method it could be a string or an array of strings. If the request method matches, the middleware will not run.
  • path it could be a string, a regexp or an array of any of those. It also could be an array of objects which are url and methods key-pairs. If the request path or path and method match, the middleware will not run. Check Examples for usage.
  • ext it could be a 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, the middleware will not run.

Examples

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

unless({
  path: [
    '/index.html',
    { url: '/', methods: ['GET', 'PUT']  }
  ]
}, requiresAuth);

Avoid a fstat for request to routes which don't end with a given extension.

unless((req) => {
  let ext = url.parse(req.originalUrl).pathname.substr(-4);
  return !['.jpg', '.html', '.css', '.js'].includes(ext);
}, static);

License

This project is licensed under the MIT license. See the LICENSE file for more info.