mdlware v0.1.0

middleware-generic

Simple module that implements the middleware pattern.

Think of it as a mix between EventEmitter and express.

This is useful for implementing plugin systems.

API

• use([namespace ,]handler[,...handlers]): Pushes a handle into the stack. If you want a middleware that always gets executed you don't need to specify the string.

• handle(namespace[,...args]): Runs a set of handlers which match the given namespace.

• on(event, callback): The middleware inherits from the EventEmitter prototype. The only even available is the error event, which is emitted whenever an error is caught when executing the middlewares.

Example

var m = middleware()

m.use(function(request, done, next) {
	if(request === 'greet') {
		done(null, 'hai')
	} else {
		next()
	}
})

m.use(function(request, done, next) {
	if(request === 'shake hand') {
		done(null, '*shakes hands*')
	} else {
		next()
	}
})

m.use('bleh', function(request, done) {
	done(null, 'BLEH YOURSELF')
})

m.use(function(request, done) {
	done(new Error('unhandled'))
})

m.handle('x', 'shake hand', function(err, res) {
	assert.equal(res, '*shakes hands*')
	assert(!err)
})

m.handle('x', 'greet', function(err, res) {
	assert.equal(res, 'hai')
	assert(!err)
})

m.handle('bleh', null, function(err, res) {
	assert(!err)
	assert.equal(res, 'BLEH YOURSELF')
})