A simple and lightweight EventEmitter for node.js or browsers.
npm install @botdev-univ/eventsA simple and lightweight EventEmitter library for node.js or browsers.
Install the dependency
``shell`
npm install @botdev-univ/events
yarn add @botdev-univ/events
- EventEmitter
- on / addListener
- once
- off / removeListener
- emit
- EventHandler
- Event
It's a class for managing events. It can be extended to provide event functionality for other classes or object.
- class - ES6 Class
There have two ways to use it.
One way:
`typescript
import EventEmitter from '@botdev-univ/events';
const emitter = new EventEmitter();
emitter.on('event', evt => {
console.log(evt);
});
`
Another way:
`typescriptchange:${key}
class Store extends EventEmitter {
set(key: string, value: any) {
this.emit(, value);`
}
}
Listen on a new event by type and handler. If listen on, the true is returned, otherwise the false.
The handler will not be listen if it is a duplicate.
- type (string) - event type, it must be a unique string.boolean
- handler (EventHandler) - event handler, when if the same handler is passed, listen it by only once.
- return () If listen on, the true is returned, otherwise the false.
`typescript`
const emitter = new EventEmitter();
emitter.on('event', evt => {
console.log(evt);
});
Listen on an once event by type and handler. When the event is fired, that will be listen off immediately and automatically.
The handler will not be listen if it is a duplicate.
- type (string) - event type, it must be a unique string.boolean
- handler (EventHandler) - event handler, when if the same handler is passed, listened by only once.
- return () If listened on, the true is returned, otherwise the false.
`typescript`
const emitter = new EventEmitter();
emitter.once('event', evt => {
console.log(evt);
});
Listen off an event by type and handler.
Or listen off events by type, when if only type argument is passed.
Or listen off all events, when if no arguments are passed.
- _[type]_ (string optional) event typeoptional
- _[handler]_ (EventHandler ) event handler
Listen off the specified event.
`typescript`
const emitter = new EventEmitter();
emitter.off('event', evt => undefined);
Listen off events by type.
`typescript`
const emitter = new EventEmitter();
emitter.off('event');
Listen off all events, it does samething as offAll method.
`typescript`
const emitter = new EventEmitter();
emitter.off();
Emit the specified event, and you can to pass a data. When emitted, every handler attached to that event will be executed.
But, if it's an once event, listen off it immediately after called handler.
- type (string) - event typeany
- _[data]_ () - event data
`typescript`
const emitter = new EventEmitter();
emitter.emit('event', 'test data');
The event handler, that is a normal function.
- evt (Event) - event object, that will be pass to event handler as it argument.
Event object.
- type (string) - event typeany
- data () - event datanumber
- timestamp () - the timestamp when event emittedboolean`) - it is an once event, that meaning listen off after event fired
- once (