Package Exports
- @dekkai/event-emitter
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@dekkai/event-emitter) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
@dekkai/event-emitter
An event emitter class, supports omni-listeners and symbol events. Tested on browsers, node.js and deno.
Check out the full API Documentation
Installation
Browser/NodeJS
$ yarn add @dekkai/event-emitterDeno
// import from directly from a CDN, like unpkg.com
import {EventEmitter} from 'https://unpkg.com/@dekkai/event-emitter';Usage
// import EventEmitter
import {EventEmitter} from '@dekkai/event-emitter';
// can be extended
class MyEmitter extends EventEmitter {
// ...
}
// used as a mixin
const MyEmitter = EventEmitter.mixin(BaseClass);
// or injected in the inheritance chain
class MyEmitter extends EventEmitter.mixin(BaseClass) {
// ...
}
// instantiate the emitter
const emitter = new MyEmitter();
// create an event handler
const handler = (evt, num0, num1) => console.log(`Event [${evt.toString()}] result: ${num0 + num1}`);
// register the handler
emitter.on('add', handler);
// events can also be symbols
const symbolEvent = Symbol('add-symbol');
emitter.on(symbolEvent, handler);
// emit events
emitter.emit('add', 4, 6); // Event [add] result: 10
emitter.emit(symbolEvent, 12, 8); // Event [Symbol(add-symbol)] result: 20
// remove previously added listeners
emitter.off('add', handler);
emitter.off(symbolEvent, handler);
// use omni-listeners to catch all events, register them using the `omniEvent` static property
const omniHandler = evt => console.log(evt.toString());
emitter.on(MyEmitter.omniEvent, omniHandler);
// the omni-listener will catch all events
emitter.emit('hello'); // hello
emitter.emit(Symbol('random symbol')); // Symbol(random symbol)
// removing omni-listeners works the same way as with regular listeners, but using the `omniEvent`
emitter.off(MyEmitter.omniEvent, omniHandler);Check out the full API Documentation