AsyncResolver.js implements a PubSub architecture where subscribers of events are decision makers (return promise when they receive an event) and after publishing an event, publisher gets the decision of the subscribers. Supports both Node and browser.
There are situations where we want to maintain distinct subscribers of an event, though want to act on the basis of how subscribers react. AsyncResolver.js is the solution for this need, it's an amalgamation of pub sub architecture and promises to provide decision making capability in asynchronous environment.
For example: Let's consider a case where there are several components on a webpage, whose state can be changed by the user and we make every component to subscribe as listener to listen to a page transition so that we can check if a user is trying to move without saving data.
Now, when an individual clicks on a link, we publish an event mentioning of the transition of the user from the page, though we want to ask every listener (or component) if user has made any changes to their state and is moving without saving them. In case there are any unsaved changes in any of the component, then we cancel the transition and instead dispay an information dialog to the user asking him to save information before proceeding further.
### NPM
npm install async-resolver
### Yarn
yarn add async-resolverconst AsyncResolver = require('async-resolver');
let resolver = new AsyncResolver();
resolver.subscribe('locationChange', () => {
// custom logic
return Promise.resolve();
});
resolver.subscribe('locationChange', () => {
// custom logic
return Promise.reject();
});
resolver
.publish('locationChange', {
promiseMethod: 'any'
})
.then(() => console.log('location change allowed'))
.catch(() => console.log('location change denied'))Returns AsyncResolver function that can be instantiated.
Allows subscribing to the event and executing the callback when an event is published.
Type: string
Event published.
Type: function
Callback to be executed when the publish event is received.
Returns a promise, that defines the decision of subscribers.
Type: string
Event published.
Type: object
Options to be passed while publishing to an event.
Type: string
Method to be applied at the collection of promises such as all, any etc. Here's list of methods supported by Promise collection.
MIT © Apoorv Saxena