Something went wrong. Try again.
[READ-ONLY] Mirror of https://github.com/okikio/native. An initiative which aims to make it easy to create complex, light-weight, and perfor okikio.github.io/native
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236import { Manager, methodCall } from "@okikio/manager";
/** * Represents a listener callback function */export type TypeListenerCallback = ((...args: any) => void);
/** Represents a new event listener consisting of properties like: callback, scope, name */export interface IListener { readonly callback: TypeListenerCallback; readonly scope: object; readonly name: string;}
/** * Creates a new listener based on {@link IListener | IListener} */export const newListener = ({ callback = () => { }, scope = null, name = "event",}: IListener): IListener => ({ callback, scope, name });
/** Represents a new event */export class Event extends Manager<number, IListener> { /** The name of the event */ public name: string; constructor(name: string = "event") { super(); this.name = name; }}
/** * The types of values `EventEmitter.prototype.on(...), EventEmitter.prototype.once(...), and EventEmitter.prototype.off(...)` accept */export type TypeEventInput = string | object | Array<string>;
/** * An Event Emitter * */export class EventEmitter extends Manager<string, Event> { constructor() { super(); }
/** Gets event, if event doesn't exist create a new one */ public getEvent(name: string): Event { let event = this.get(name); if (!(event instanceof Event)) { this.set(name, new Event(name)); return this.get(name); }
return event; }
/** Creates a listener and adds it to an event */ public newListener( name: string, callback: TypeListenerCallback, scope: object ): Event { let event = this.getEvent(name); event.add(newListener({ name, callback, scope })); return event; }
/** Adds a listener to a given event */ public on( events: TypeEventInput, callback?: TypeListenerCallback | object, scope?: object ): EventEmitter { // If there is no event break if ( typeof events == "undefined" || events == null ) return this;
// Create a new event every space if (typeof events == "string") events = events.trim().split(/\s/g);
let _name: string; let _callback: TypeListenerCallback; let isObject = typeof events == "object" && !Array.isArray(events);
let _scope: object = isObject ? callback : scope; if (!isObject) _callback = (callback as TypeListenerCallback);
// Loop through the list of events Object.keys(events).forEach(key => { // Select the name of the event from the list // Remember events can be {String | Object | Array<string>}
// Check If events is an Object (JSON like Object, and not an Array) _name = isObject ? key : events[key]; if (isObject) _callback = events[key];
this.newListener(_name, _callback, _scope); }, this); return this; }
/** Removes a listener from an event */ public removeListener( name: string, callback: TypeListenerCallback, scope: object ): Event { let event: Event = this.get(name); if (event instanceof Event && callback) { let listener = newListener({ name, callback, scope }); event.forEach((value: IListener, i: number) => { if ( value.callback === listener.callback && value.scope === listener.scope ) return event.remove(i); }); }
return event; }
/** Remove a listener from a given event, or just completely remove an event */ public off( events: TypeEventInput, callback?: TypeListenerCallback | object, scope?: object ): EventEmitter { // If there is no event break if ( typeof events == "undefined" || events == null ) return this;
// Create a new event every space if (typeof events == "string") events = events.trim().split(/\s/g);
let _name: string; let _callback: TypeListenerCallback; let isObject = typeof events == "object" && !Array.isArray(events);
let _scope: object = isObject ? callback : scope; if (!isObject) _callback = (callback as TypeListenerCallback);
// Loop through the list of events Object.keys(events).forEach(key => { // Select the name of the event from the list // Remember events can be {String | Object | Array<any>}
// Check If events is an Object (JSON like Object, and not an Array) _name = isObject ? key : events[key]; if (isObject) _callback = events[key];
if (typeof _callback === "function") { this.removeListener(_name, _callback, _scope); } else this.remove(_name); }, this); return this; }
/** * Adds a one time event listener for an event */ public once( events: TypeEventInput, callback?: TypeListenerCallback | object, scope?: object ): EventEmitter { // If there is no event break if ( typeof events == "undefined" || events == null ) return this;
// Create a new event every space if (typeof events == "string") events = events.trim().split(/\s/g);
let isObject = typeof events == "object" && !Array.isArray(events);
// Loop through the list of events Object.keys(events).forEach(key => { // Select the name of the event from the list // Remember events can be {String | Object | Array<string>} // Check If events is an Object (JSON like Object, and not an Array) let _name: string = isObject ? key : events[key]; let _callback: TypeListenerCallback = isObject ? events[key] : (callback as TypeListenerCallback); let _scope: object = isObject ? callback : scope; let onceFn: TypeListenerCallback = (...args) => { _callback.apply(_scope, args); this.removeListener(_name, onceFn, _scope); };
this.newListener(_name, onceFn, _scope); }, this); return this; }
/** Call all listeners within an event */ public emit( events: string | Array<any>, ...args: any ): EventEmitter { // If there is no event break if ( typeof events == "undefined" || events == null ) return this;
// Create a new event every space if (typeof events == "string") events = events.trim().split(/\s/g);
// Loop through the list of events events.forEach((event: string) => { let _event: Event = this.get(event); if (_event instanceof Event) { _event.forEach((listener: IListener) => { let { callback, scope } = listener; callback.apply(scope, args); }); } }, this); return this; }
/** Clears events and event listeners */ public clear() { methodCall(this, "clear"); super.clear(); return this; }}
export default EventEmitter;