sans-server-middleware v1.4.5

sans-server-middleware

A sans-server hook runner.

This package is used by sans-server and sans-server-router to enact hooks.

Example

const Middleware = require('sans-server-middleware');
const SansServer = require('sans-server');

const middleware = new Middleware();

// add normal middleware
middleware.add(function a(req, res, next) {
    req.str = 'a';
});

// add normal middleware - produces error
middleware.add(function b(req, res, next) {
    req.str += 'b';
    next(Error('Failure'));
});

// add normal middleware - skipped because of error before
middleware.add(function c(req, res, next) {
    req.str += 'c';
});

// add error middleware - resolves error
middleware.add(function d(err, req, res, next) {
    req.str += 'd';
    next();
});

// add normal middleware
middleware.add(function e(req, res, next) {
    req.str = 'e';
});

// run the middleware
SansServer.use(function(req, res, next) {
    middleware.run(req, res, next);
});

Middleware constructor

This constructor is used gather and run hooks that are added to it.

Signature Middleware() : Middleware

Methods

• add - Add a hook function.
• from - Add an array-like or iterable of hook functions.
• reverse - Run the added middleware functions in reverse order.
• run - Run the added middleware functions.

Properties

• length - Get the number of hooks attached to the instance.

Parameters None

Returns a middleware instance.

Example

const Middleware = require('sans-server-middleware');

const middleware = new Middleware();

middleware.add(function myHook(req, res, next) {
    // do something ...
    next();
});

Middleware#add

Add a middleware hook.

Signature Middleware#add( weight, hook ) : undefined

Parameters

Returns undefined

Example

const Middleware = require('sans-server-middleware');

const middleware = new Middleware();

middleware.add(function myHook(req, res, next) {
    // do something ...
    next();
});

Middleware#from

Add middleware from an array-like object or an iterable. Each item must be a function.

Signature Middleware#from( iterable ) : undefined

Parameters

Returns undefined

Example

const Middleware = require('sans-server-middleware');

const middleware = new Middleware();

const ar = [];
ar.push(function myHook(req, res, next) {
    // do something ...
    next();
});

middleware.from(ar);

Middleware#length

Get the number of hooks that have been added to the instance.

Signature Middleware#length : number

Type number

Example

const SansServer = require('sans-server');
const Middleware = SansServer.Middleware;

const middleware = new Middleware();

middleware.add(function(req, res, next) {
    // do something ...
    next();
});

console.log(middleware.length);     // 1

Middleware#reverse

Run through the added hooks in reverse order.

Signature Middleware#reverse( req, res , next ) : Promise|undefined

Parameters

Returns a Promise if the next parameter was not provided. The promise resolves if there are no unresolved errors while running the middleware, otherwise it rejects with the error reason. If the next parameter was provided then undefined is returned instead.

Example

const SansServer = require('sans-server');
const Middleware = SansServer.Middleware;

const middleware = new Middleware();

middleware.add(function(req, res, next) {
    // do something ...
    next();
});

const server = new SansServer();
server.use(function(req, res, next) {
    middleware.reverse(req, res, next);
});

Middleware#run

Run through the added hooks in order.

Signature Middleware#run( req, res , next ) : Promise|undefined

Parameters

Returns a Promise if the next parameter was not provided. The promise resolves if there are no unresolved errors while running the middleware, otherwise it rejects with the error reason. If the next parameter was provided then undefined is returned instead.

Example

const SansServer = require('sans-server');
const Middleware = SansServer.Middleware;

const middleware = new Middleware();

middleware.add(function(req, res, next) {
    // do something ...
    next();
});

const server = new SansServer();
server.use(function(req, res, next) {
    middleware.reverse(req, res, next);
});