venttiseiska
Advanced tools
The good 'ol event emitter pattern with a few handy extras, future facing implementation and a sugary sweet API. If you're looking for the tiniest and fastest event emitter implementation keep on looking, this is not it.
Venttiseiska treats the listener as a first-class citizen that has it's own set of methods and properties. Listeners can be queried and updated at any time allowing you to easily extend the existing functionality if the need should arise. This approach sets some limits to the performance when compared to emitters with more simplistic approach.
Venttiseiska has no dependencies, works in Node.js as well as most browsers (IE9+) and is future-facing (some ES6 features such as WeakMap and WeakSet are used where appropriate with fallbacks to ES5 compatible code).
In case you're wondering, Venttiseiska is a Finnish military slang word referring to AN/PRC-77 Portable Transceiver which is used by the Finnish army, hence the name.
Enjoy, it's MIT licensed.
Node
npm install venttiseiska --save-dev
Browser
<script src='venttiseiska.js'></script>
var emitter = new Venttiseiska();
var listener = function (msg) { console.log(msg); };
emitter.on('someEvent', listener);
emitter.emit('someEvent', ['hello']);
emitter.off('someEvent', listener);
#1: Namespaced events (aka event tags).
var emitter = new Venttiseiska();
var listener = function (msg) { console.log(msg); };
emitter.on('someEvent:tagA ', listener);
emitter.on('someEvent:tagB', listener);
emitter.emit('someEvent:tagA', ['tagA fired']);
emitter.emit('someEvent:tagB', ['tagB fired']);
emitter.emit('someEvent', ['tagA and tagB fired']);
#2: Bind, unbind and emit multiple events simultaneously.
var emitter = new Venttiseiska();
var listener = function (msg) { console.log(msg); };
emitter.on('someEvent anotherEvent', listener);
emitter.emit('someEvent anotherEvent', ['hello']);
emitter.off('someEvent anotherEvent', listener);
#3: Define listener cycles — how many times a listener can be called before it is automatically unbound.
var emitter = new Venttiseiska();
// Let's bind a listener to trigger twice and then automatically
// unbind itself. Note that we need to use alternative binding
// syntax to access the extra functionality.
emitter.on({
events: 'someEvent',
cycles: 2, // Defauls to 0 which means infinite cycles.
listener: function (msg) {
console.log(msg);
}
});
// Trigger the event twice.
emitter.emit('someEvent someEvent', ['hello']);
// By now the listener is automatically unbound from "someEvent".
// Emitting "someEvent" does nothing at this point.
emitter.emit('someEvent', ['hello']);
#4. Query events and listeners.
var emitter = new Venttiseiska();
// Let's bind some listeners.
emitter.on('a b c', function (msg) {
console.log(msg);
});
// Get instance's events.
var events = emitter.getEvents(); // ['a', 'b', 'c']
// Get all listeners in the instace sorted by the binding order.
var allListeners = emitter.getListeners();
// Get listeners of events "a" and "b" sorted by the binding order.
var abListeners = emitter.getListeners('a b');
#5. Update event listeners.
var emitter = new Venttiseiska();
// Let's bind some listeners. Surprise! The .on() method
// returns an array of the bound listeners. This is
// also the reason the emitter instance methods are not
// chainable, in case you were wondering.
var listeners = emitter.on('a b c', function (msg) {
console.log(msg);
});
// Now let's modify the listener of "b" event.
// Note that you cannot modify the listener's event.
listeners[1].update({
fn: function (msg) {
console.log(msg + ' updated');
},
tags: ['tagA', 'tagB'],
context: listeners[1],
cycles: 5
});
#6. Bind listener to specific context and switch it on the fly.
var emitter = new Venttiseiska();
var listener = function () { console.log(this); };
var contextA = 'a';
var contextB = 'b';
// Let's bind listener to event "a" with special context.
emitter.on('a', listener, contextA);
// On emit you should see "a" in your console.
emitter.emit('a');
// Now let's override the bound context for the
// following emit call. On emit you should now
// see "b" in your console.
emitter.emit('a', [], contextB);
// As mentioned already the context specified in
// last emit call was not permanent. You should
// see "a" again in your console.
emitter.emit('a');
new Venttiseiska()Create a new event emitter instance.
var emitter = new Venttiseiska();
emitter.on( events, listener, [context] )Bind a listener to one or more events. Returns an array of all the bound listeners in the binding order.
Arguments
'ev1 ev2 ev3'. You can also attach tags (targetable metadata) to listeners. The tag delimiter is ':', e.g. 'ev1:tag1 ev2:tag2 ev3:tag1:tag2'.0Returns — Array
An array of all the bound listeners in the binding order.
Examples
var emitter = new Venttiseiska();
var listener = function (msg) { console.log(msg); };
// Bind an event listener to a single event.
emitter.on('one', listener);
// Bind an event listener to a single event with one tag.
emitter.on('one:a', listener);
// Bind an event listener to a single event with multiple
// namespaces.
emitter.on('one:a:b:c', listener);
// Bind an event listener to multiple events.
emitter.on('one two:a three:b:c', listener);
// The same with array notation.
emitter.on(['one', 'two:a', 'three:b:c'], listener);
// Bind an event listener with custom context
emitter.on('one', listener, {custom: 'context'});
// Bind an event listener which is automatically unbound
// after it has been emitted 3 times.
emitter.on({
events: 'one',
listener: listener,
context: {custom: 'context'},
cycles: 3
});
emitter.once( events, listener, [context] )Bind a one-off listener to one or more events. Returns an array of all the bound listeners in the binding order.
Arguments
'ev1 ev2 ev3'. You can also attach tags (targetable metadata) to listeners. The tag delimiter is ':', e.g. 'ev1:tag1 ev2:tag2 ev3:tag1:tag2'.1.Returns — Array
An array of all the bound listeners in the binding order.
emitter.off( [events], [target] )Unbind event listeners. If no target is provided all listeners for the specified events will be removed. If no events are provided all listeners from all events of the instance are removed.
Arguments
'ev1 ev2 ev3'. You can additionally target event tags to filter the removable listeners, e.g. 'ev1:tag1 ev2:tag2'.Examples
var emitter = new Venttiseiska();
var listener = function (msg) { console.log(msg); };
// First, let's bind some events.
emitter.on('eventA:tagA eventB:tagB', listener);
// Unbind all listeners in the emitter instance.
emitter.off();
// Unbind all listeners bound to specific event(s).
emitter.off('eventA eventB');;
// Unbind all listeners that match the provided
// event(s) and listener function.
emitter.off('eventA eventB', listener);
// You can also target listeners with specific tags.
emitter.off('eventA:tagA eventB:tagB', listener);
emitter.emit( events, [args], [context] )Emit events.
Arguments
'ev1 ev2 ev3'. You can additionally target event tags, e.g. 'ev1:tag1 ev2:tag2'..on() method.Examples
var emitter = new Venttiseiska();
var listener = function (msgA, msgB) { console.log(msgA + ' ' + msgB); };
// First, let's bind some listeners.
emitter.on('eventA:tagA eventA:tagB eventB:tagB', listener);
// Emit event(s) with arguments.
emitter.emit('eventA:tagA eventB', ['hello', 'beautiful']);
// Emit an event with custom context.
emitter.emit('eventA:tagB', ['Ka', 'Pow'], {custom: 'context'});
emitter.getListeners( [events] )Get instance's listeners. Optionally you can provide a set of event names as the first argument if you want to filter the listeners. The returned event listeners are always sorted by the bind order starting from the listener that was bound earliest. Additionally the returned array never contains duplicate listeners.
Arguments
'ev1 ev2 ev3'. You can additionally target event tags, e.g. 'ev1:tag1 ev2:tag2'.Returns — Array
Returns an array of event listeners, sorterd by their binding order.
Examples
var emitter = new Venttiseiska();
var listener = function (msg) { console.log(msg); };
// First, let's bind some events.
emitter.on('eventA:tagA eventA:tagB eventB:tagB', listener);
// Get all listeners of the emitter instance.
var allListeners = emitter.getListeners();
// Get listeners of specific event(s).
var filteredListeners = emitter.getListeners('eventA:tagA eventB');
emitter.getEvents()Get all events in the instance which have listeners bound to them.
Returns — Array
Returns an array of event names.
Examples
var emitter = new Venttiseiska();
var listener = function (msg) { console.log(msg); };
// First, let's bind some events.
emitter.on('eventA eventB eventC', listener);
// Get all event names of the emitter instance.
var events = emitter.getEvents(); // ['eventA', 'eventB', 'eventC']
new Venttiseiska.Listener( emitter, event, fn, [tags], [context], [cycles] )Venttiseiska listener instance constructor.
Arguments
Examples
var emitter = new Venttiseiska();
var fn = function (msg) { console.log(msg); };
var listener = new Venttiseiska.Listener(emitter, 'eventA', fn);
listener.off()Unbind listener instance.
Returns — Venttiseiska.Listener
Returns the Venttiseiska.Listener instance that called the method.
Examples
var emitter = new Venttiseiska();
var fn = function (msg) { console.log(msg); };
var listener = new Venttiseiska.Listener(emitter, 'eventA', fn);
listener.off();
listener.emit( [args], [context] )Emit listener instance.
Arguments
Returns — Venttiseiska.Listener
Returns the Venttiseiska.Listener instance that called the method.
Examples
var emitter = new Venttiseiska();
var fn = function (msg) { console.log(msg); };
var listener = new Venttiseiska.Listener(emitter, 'eventA', fn);
listener.emit(['hello']);
listener.update( data )Update listener's data.
Arguments
Returns — Venttiseiska.Listener
Returns the Venttiseiska.Listener instance that called the method.
Examples
var emitter = new Venttiseiska();
var fn = function (msg) { console.log(msg); };
var listener = new Venttiseiska.Listener(emitter, 'eventA', fn);
listener.update({
fn: function () { console.log('updated'); },
tags: ['tagA', 'tagB'],
context: listener,
cycles: 7
});
listener.inspect()Inspect listener's data.
Returns — Object
Returns an object that contains the listener's information.
0, which means that the cycles feature is disabled (in other words the listener has infinite cycles).Examples
var emitter = new Venttiseiska();
var fn = function (msg) { console.log(msg); };
var listener = new Venttiseiska.Listener(emitter, 'eventA', fn);
var listenerData = listener.inspect();
FAQs
A decent event emitter for the browser and Node.js
The npm package venttiseiska receives a total of 2 weekly downloads. As such, venttiseiska popularity was classified as not popular.
We found that venttiseiska 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
Socket CEO Feross Aboukhadijeh discusses open source security challenges, including zero-day attacks and supply chain risks, on the Cyber Security Council podcast.
Security News
Research
Socket researchers uncover how threat actors weaponize Out-of-Band Application Security Testing (OAST) techniques across the npm, PyPI, and RubyGems ecosystems to exfiltrate sensitive data.
Security News
Research
A malicious npm campaign is targeting Ethereum developers by impersonating Hardhat plugins and the Nomic Foundation, stealing sensitive data like private keys.