callback-registry
v2.7.2
Published
Registry for callbacks
Downloads
5,310
Readme
Intro
A simple registry for callbacks that allows you to add one or more callbacks under some key and then execute all callbacks under some key.
Example:
const registryFactory = require('callback-registry');
const registry = registryFactory();
// add a new callback for that event key
registry.add('event-key', function(){
console.log('the event occurred')
});
// execute all callbacks that were registred for that key
registry.execute('event-key');
Passing arguments
You can pass any arguments to the callbacks when you execute them
// execute all callbacks that were registred for that key
registry.execute('event-key', arg1, arg2, arg3);
Returning results
The execute method returns an array with the results returned from the callbacks.
Removing a callback
When you add a new callback a function is returned that can be used to unsubscribe
// A callback that will be called just the first time
var unsubscribe = registry.add('event-key', function(){
console.log('the event occurred');
unsubscribe();
});
Change log
- 2.7.2 dependencies update
- 2.7.1 fixed potentional memory leak
- 2.6.0 added replayArgumentsArr that allows you to replay arguments to a new callback
- 2.5.0 added clearKey method that removes a key from the registry
- 2.3.2
- fix case where unsubscribe function removes all subscriptions with the same callback reference
- 2.1.1
- return empty array as result if no subscribers
- catch errors in user callbacks (returns undefined in the result if error)