require-middleware

Inject middleware into require calls before they hit the cache, file system, or native modules

npm install require-middleware
4 downloads in the last week
10 downloads in the last month

Require Middleware

This library will give you the capabilities of middleware in calls to require. It's super handy for unit testing and dependency injection, but could be used for broader application purposes as well.

This is heavily inspired by, and modeled after, Connect middleware.

Installation

Use --save if using in your core app, --save-dev if using for testing

npm install [--save/--save-dev] require-middleware

Basic Usage

// Remember this is going to hijack all require calls to follow!
// That also means that you might want to load it first

var requireMiddleware = require('require-middleware');
requireMiddleware.use(function myMiddleware(req, next) {
    if (req.name === 'something') {
        // Transparent dependency replacement
        return require('somethingelse');
    }
    next();
});

var myModule = require('something'); // Gets resolved as if I called `require('somethingelse');
`

If your module isn't going to block the request for the middleware (by calling next(err)) or resolve the dependency by returning the result, calling next() will execute the next registered middleware.

Throwing errors

Simply pass a return value to next and that will be thrown as an exception

function myMiddleware(req, next) {
    if (req.name === 'fs') {
        next('Sorry dude, no fs for you.');
    }
}

Fiddling with registered middleware

The middleware stack is exposed on requireMiddleware.stack.

Naming your middleware

requireMiddleware.use(function myMiddleware() { });
// OR
requireMiddleware.use(function () { }).as('someOtherMiddleware');

The stack, after registering this middleware would look like:

[
    { handle: [Function myMiddleware], name: 'myMiddleware' },
    { handle: [Function someOtherMiddleware], name: 'someOtherMiddleware' }
]

The .as() function is handy if you want to load up common middleware from another location but name it something specific that you control for later manipulation on the stack. Naming middleware will not impact its functionality in any way.

npm loves you