Security News
Oracle Drags Its Feet in the JavaScript Trademark Dispute
Oracle seeks to dismiss fraud claims in the JavaScript trademark dispute, delaying the case and avoiding questions about its right to the name.
node-execution-context
Advanced tools
Provides execution context wrapper for node JS, can be used to create execution wrapper for handling requests and more
A straightforward library that provides a persistent process-level context wrapper using node "async_hooks" feature.
This library will try to use by default AsyncLocalStorage
implementation based if current node version supports it, otherwise it will fallback to raw async_hooks
implementation for lower versions which mimics this behaviour.
npm i node-execution-context
Let's start with creating the context initialisation point of our app, we will take a simple express app for this example
// main.js
const express = require('express');
const Context = require('node-execution-context');
const UserController = require('./controllers/user');
const app = express();
const port = 3000;
const ContextMiddleware = (req, res, next) => {
Context.run(next, { reference: Math.random() });
};
app.use('/', ContextMiddleware);
app.post('/user', UserController.create);
app.listen(port);
This will expose any point of your code form this point that handles that request.
// ./controller/user/index.js
const Context = require('node-execution-context');
const mongo = require('../service/mongo');
const logger = require('../service/logger');
export class UserController {
async create (req) {
const { user } = req.body;
// This will return the reference number set by out ContextMiddleware (generated by Math.random())
const { reference } = Context.get();
logger.info('Created user for reference: ', reference);
return await mongo.create('user', user);
}
}
Runs given callback that will be exposed to the given context.
The context will be exposed to all callbacks and promise chains triggered from the given fn
.
Gets the current asynchronous execution context.
The
get
result is returned byreference
meaning if you wish any immutability applied, it will have to be manually applied.
This API may throw CONTEXT_DOES_NOT_EXIST error if accessed without initializing the context properly.
Sets the current asynchronous execution context to given value.
This API may throw CONTEXT_DOES_NOT_EXIST error if accessed without initializing the context properly.
Creates a given context for the current asynchronous execution.
It is recommended to use the run
method. This method should be used in special cases in which the run
method cannot be used directly.
Note that if this method will be called not within a AsyncResource context, it will effect current execution context and should be used with caution.
const Context = require('node-execution-context');
// context-events.js
const context = { id: Math.random() };
emitter.on('contextual-event', () => {
Context.create(context);
});
// service.js
emitter.on('contextual-event', () => {
Context.get(); // Returns { id: random }
});
// main.js
emitter.emit('contextual-event');
Context.get(); // Returns { id: random }
Configures execution context settings.
Relevant only for node versions lower than
v12.17.0
.
Returns an monitoring report over the current execution map resources
Relevant only for node versions lower than
v12.17.0
.
Before calling
monitor
, you shouldconfigure
execution context to monitor it's nodes. by default the data kept is as possible.
const Context = require('node-execution-context');
// Startup
Context.configure({ monitor: true });
// Later on
const usage = Context.monitor();
console.log(usage); // Prints execution context usage report.
const Context = require('node-execution-context');
Context.create({
value: true
});
Promise.resolve().then(() => {
console.log(Context.get()); // outputs: {"value": true}
Context.set({
value: false
});
return new Promise((resolve) => {
setTimeout(() => {
console.log(Context.get()); // outputs: {"value": false}
Context.set({
butter: 'fly'
});
process.nextTick(() => {
console.log(Context.get()); // outputs: {"butter": 'fly'}
resolve();
});
}, 1000);
console.log(Context.get()); // outputs: {"value": false}
});
});
The following errors can be thrown while accessing to the context API :
Code | When |
---|---|
CONTEXT_DOES_NOT_EXIST | When attempting to get / set a context, that has not yet been created. |
MONITOR_MISS_CONFIGURATION | When try to monitor without calling configure with monitoring option. |
FAQs
Provides execution context wrapper for node JS, can be used to create execution wrapper for handling requests and more
We found that node-execution-context demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Oracle seeks to dismiss fraud claims in the JavaScript trademark dispute, delaying the case and avoiding questions about its right to the name.
Security News
The Linux Foundation is warning open source developers that compliance with global sanctions is mandatory, highlighting legal risks and restrictions on contributions.
Security News
Maven Central now validates Sigstore signatures, making it easier for developers to verify the provenance of Java packages.