@momsfriendlydevco/express-middleware-promise v0.0.0

Express-Middleware-Promise

A simple wrapper around Express to make it promise compatible.

• Completely Promise library agnostic - Use native promises, Q, Bluebird or whatever library you want
• Backwards compatible - Mix and match callbacks and promises as needed
• Low overhead - While this library does have to wrap all middleware calls the codebase is minimal to prevent drag

var express = require('express');
var expressPromises = require('@momsfriendlydevco/express-middleware-promise');

var app = express();
expressPromises(app);


// Any simple return value gets sent via res.send() automatically
app.get('/api/hello-world', ()=> 'Hello World!'); 

// Use setTimeout to pause for 100 inside a promise
app.get('/api/pause', ()=> new Promise(resolve => setTimeout(()=> resolve('I waited!'), 100)));

// Make a middleware chain of promises
app.get('/api/chain',
	()=> BigComplexPromise(),
	()=> AnotherComplexPromise(),
	()=> YetAnotherPromise()
);

// Normal callback style express functions are still fully supported
app.get('/api/classic', (req, res) => res.send('Old school!'));

// Mix and match approches
app.get('/api/mixed',
	(req, res, next) => next(),
	(req, res, next) => setTimeout(()=> next(), 10),
	(req, res, next) => new Promise(resolve => setTimeout(()=> resolve(), 20)),
	(req, res) => res.send('Done!'),
);

API

Express-As-Promised exports one function which mutates the Express app object, replacing some built in functions so that promises are supported.

The function can either be called with the entire Express object:

var app = express();
expressAsPromised(app);

... or with options:

var app = express();
expressAsPromised({
	app: app,
	setting1: settingValue,
});

Supported options are listed below.