request-context

Simple connect middleware for accessing data in a request context. Wrap the request handling in a domain and set and access data for the current request lifecycle only. All following functions will be run in the created 'namespace'.

The problem

You would like to access data from the request or any middleware in a completely different context. Due to the async architecture of Node it can become a nightmare to pass the data to all callbacks is the function chain. This module provides a middleware and an easy to use API to access data from anywhere in the function chain. No matter if the functions are called async or not.

See the Domain Docs for further information on error handling for domains. Note that the domain module is pending deprecation!

Install

1$ npm install request-context

Example

server config in app.js:

1const app = express();
2const contextService = require('request-context');
3
4// wrap requests in the 'request' namespace (can be any string)
5app.use(contextService.middleware('request'));
6
7// set the logged in user in some auth middleware
8app.use(function (req, res, next) {
9	User.findById(req.cookies._id, (err, user) => {
10		// set the user who made this request on the context
11		contextService.set('request:user', user);
12		next();
13	});
14});
15
16// save a model in put requests
17app.put(function (req, res, next) {
18	new Model(req.body).save((err, doc) => res.json(doc));
19});
20
21// always use an default express/connect error handling middleware
22// it will be called if any errors occur in the domain
23// see http://expressjs.com/en/guide/error-handling.html
24app.use(function (err, req, res, next) {
25	res.status(err.status || 500);
26});
27
28// start server etc.
29[...]

In the Model definition file:

1var contextService = require('request-context');
2
3[...]
4
5// set the user who made changes to this document
6// note that this method is called async in the document context
7modelSchema.pre('save', function (next) {
8	// access the user object which has been set in the request middleware
9	this.modifiedBy = contextService.get('request:user.name');
10	// or this.modifiedBy = contextService.get('request').user.name;
11	next();
12});

API

Also available on the github pages.

• middleware Returns a function that can be used as connect middleware. Takes a string as the name of the namespace as its argument. All functions called after this middleware, async or not, will have read/write access to the context.

1var middleware = require('request-context').middleware;
2app.use(middleware('some namespace'));

• set, setContext Set the context for a key on the context created by the middleware.

1var contextService = require('request-context');
2contextService.set('namespace:key', {some: 'value'});
3contextService.set('namespace:key.some', 'other');

• get, getContext Get the context for a key on the context created by the middleware.

1var contextService = require('request-context');
2contextService.get('namespace:key.some'); // returns 'other'

Object Path Syntax

Any value from the context object can be accessed by a simple object dot notation:

1var contextService = require('request-context');
2
3// set an object on the namespace
4contextService.set('namespace:character',	{
5		name: 'Arya Stark',
6		location: {
7			name: 'Winterfell',
8			region: 'North'
9		}
10	});
11
12// this will return the complete object
13var char = contextService.get('namespace:character');
14
15// work with the object
16var region = char.location.region;
17
18// this will return 'Arya Stark'
19contextService.get('namespace:character.name');
20
21// this will set the region to 'Westeros'
22contextService.set('namespace:character.location.region', 'Westeros');
23

Documentation

The documentation is available on the github pages. To generate the jsdoc documentation run

1$ gulp docs

Test

To run the packaged tests:

1$ gulp test