532 lines
13 KiB
JavaScript
Executable File
532 lines
13 KiB
JavaScript
Executable File
'use strict';
|
|
|
|
const {anyMap, producersMap, eventsMap} = require('./maps.js');
|
|
|
|
const anyProducer = Symbol('anyProducer');
|
|
const resolvedPromise = Promise.resolve();
|
|
|
|
// Define symbols for "meta" events.
|
|
const listenerAdded = Symbol('listenerAdded');
|
|
const listenerRemoved = Symbol('listenerRemoved');
|
|
|
|
let canEmitMetaEvents = false;
|
|
let isGlobalDebugEnabled = false;
|
|
|
|
function assertEventName(eventName) {
|
|
if (typeof eventName !== 'string' && typeof eventName !== 'symbol' && typeof eventName !== 'number') {
|
|
throw new TypeError('`eventName` must be a string, symbol, or number');
|
|
}
|
|
}
|
|
|
|
function assertListener(listener) {
|
|
if (typeof listener !== 'function') {
|
|
throw new TypeError('listener must be a function');
|
|
}
|
|
}
|
|
|
|
function getListeners(instance, eventName) {
|
|
const events = eventsMap.get(instance);
|
|
if (!events.has(eventName)) {
|
|
return;
|
|
}
|
|
|
|
return events.get(eventName);
|
|
}
|
|
|
|
function getEventProducers(instance, eventName) {
|
|
const key = typeof eventName === 'string' || typeof eventName === 'symbol' || typeof eventName === 'number' ? eventName : anyProducer;
|
|
const producers = producersMap.get(instance);
|
|
if (!producers.has(key)) {
|
|
return;
|
|
}
|
|
|
|
return producers.get(key);
|
|
}
|
|
|
|
function enqueueProducers(instance, eventName, eventData) {
|
|
const producers = producersMap.get(instance);
|
|
if (producers.has(eventName)) {
|
|
for (const producer of producers.get(eventName)) {
|
|
producer.enqueue(eventData);
|
|
}
|
|
}
|
|
|
|
if (producers.has(anyProducer)) {
|
|
const item = Promise.all([eventName, eventData]);
|
|
for (const producer of producers.get(anyProducer)) {
|
|
producer.enqueue(item);
|
|
}
|
|
}
|
|
}
|
|
|
|
function iterator(instance, eventNames) {
|
|
eventNames = Array.isArray(eventNames) ? eventNames : [eventNames];
|
|
|
|
let isFinished = false;
|
|
let flush = () => {};
|
|
let queue = [];
|
|
|
|
const producer = {
|
|
enqueue(item) {
|
|
queue.push(item);
|
|
flush();
|
|
},
|
|
finish() {
|
|
isFinished = true;
|
|
flush();
|
|
}
|
|
};
|
|
|
|
for (const eventName of eventNames) {
|
|
let set = getEventProducers(instance, eventName);
|
|
if (!set) {
|
|
set = new Set();
|
|
const producers = producersMap.get(instance);
|
|
producers.set(eventName, set);
|
|
}
|
|
|
|
set.add(producer);
|
|
}
|
|
|
|
return {
|
|
async next() {
|
|
if (!queue) {
|
|
return {done: true};
|
|
}
|
|
|
|
if (queue.length === 0) {
|
|
if (isFinished) {
|
|
queue = undefined;
|
|
return this.next();
|
|
}
|
|
|
|
await new Promise(resolve => {
|
|
flush = resolve;
|
|
});
|
|
|
|
return this.next();
|
|
}
|
|
|
|
return {
|
|
done: false,
|
|
value: await queue.shift()
|
|
};
|
|
},
|
|
|
|
async return(value) {
|
|
queue = undefined;
|
|
|
|
for (const eventName of eventNames) {
|
|
const set = getEventProducers(instance, eventName);
|
|
if (set) {
|
|
set.delete(producer);
|
|
if (set.size === 0) {
|
|
const producers = producersMap.get(instance);
|
|
producers.delete(eventName);
|
|
}
|
|
}
|
|
}
|
|
|
|
flush();
|
|
|
|
return arguments.length > 0 ?
|
|
{done: true, value: await value} :
|
|
{done: true};
|
|
},
|
|
|
|
[Symbol.asyncIterator]() {
|
|
return this;
|
|
}
|
|
};
|
|
}
|
|
|
|
function defaultMethodNamesOrAssert(methodNames) {
|
|
if (methodNames === undefined) {
|
|
return allEmitteryMethods;
|
|
}
|
|
|
|
if (!Array.isArray(methodNames)) {
|
|
throw new TypeError('`methodNames` must be an array of strings');
|
|
}
|
|
|
|
for (const methodName of methodNames) {
|
|
if (!allEmitteryMethods.includes(methodName)) {
|
|
if (typeof methodName !== 'string') {
|
|
throw new TypeError('`methodNames` element must be a string');
|
|
}
|
|
|
|
throw new Error(`${methodName} is not Emittery method`);
|
|
}
|
|
}
|
|
|
|
return methodNames;
|
|
}
|
|
|
|
const isMetaEvent = eventName => eventName === listenerAdded || eventName === listenerRemoved;
|
|
|
|
function emitMetaEvent(emitter, eventName, eventData) {
|
|
if (isMetaEvent(eventName)) {
|
|
try {
|
|
canEmitMetaEvents = true;
|
|
emitter.emit(eventName, eventData);
|
|
} finally {
|
|
canEmitMetaEvents = false;
|
|
}
|
|
}
|
|
}
|
|
|
|
class Emittery {
|
|
static mixin(emitteryPropertyName, methodNames) {
|
|
methodNames = defaultMethodNamesOrAssert(methodNames);
|
|
return target => {
|
|
if (typeof target !== 'function') {
|
|
throw new TypeError('`target` must be function');
|
|
}
|
|
|
|
for (const methodName of methodNames) {
|
|
if (target.prototype[methodName] !== undefined) {
|
|
throw new Error(`The property \`${methodName}\` already exists on \`target\``);
|
|
}
|
|
}
|
|
|
|
function getEmitteryProperty() {
|
|
Object.defineProperty(this, emitteryPropertyName, {
|
|
enumerable: false,
|
|
value: new Emittery()
|
|
});
|
|
return this[emitteryPropertyName];
|
|
}
|
|
|
|
Object.defineProperty(target.prototype, emitteryPropertyName, {
|
|
enumerable: false,
|
|
get: getEmitteryProperty
|
|
});
|
|
|
|
const emitteryMethodCaller = methodName => function (...args) {
|
|
return this[emitteryPropertyName][methodName](...args);
|
|
};
|
|
|
|
for (const methodName of methodNames) {
|
|
Object.defineProperty(target.prototype, methodName, {
|
|
enumerable: false,
|
|
value: emitteryMethodCaller(methodName)
|
|
});
|
|
}
|
|
|
|
return target;
|
|
};
|
|
}
|
|
|
|
static get isDebugEnabled() {
|
|
if (typeof process !== 'object') {
|
|
return isGlobalDebugEnabled;
|
|
}
|
|
|
|
const {env} = process || {env: {}};
|
|
return env.DEBUG === 'emittery' || env.DEBUG === '*' || isGlobalDebugEnabled;
|
|
}
|
|
|
|
static set isDebugEnabled(newValue) {
|
|
isGlobalDebugEnabled = newValue;
|
|
}
|
|
|
|
constructor(options = {}) {
|
|
anyMap.set(this, new Set());
|
|
eventsMap.set(this, new Map());
|
|
producersMap.set(this, new Map());
|
|
|
|
producersMap.get(this).set(anyProducer, new Set());
|
|
|
|
this.debug = options.debug || {};
|
|
|
|
if (this.debug.enabled === undefined) {
|
|
this.debug.enabled = false;
|
|
}
|
|
|
|
if (!this.debug.logger) {
|
|
this.debug.logger = (type, debugName, eventName, eventData) => {
|
|
try {
|
|
// TODO: Use https://github.com/sindresorhus/safe-stringify when the package is more mature. Just copy-paste the code.
|
|
eventData = JSON.stringify(eventData);
|
|
} catch {
|
|
eventData = `Object with the following keys failed to stringify: ${Object.keys(eventData).join(',')}`;
|
|
}
|
|
|
|
if (typeof eventName === 'symbol' || typeof eventName === 'number') {
|
|
eventName = eventName.toString();
|
|
}
|
|
|
|
const currentTime = new Date();
|
|
const logTime = `${currentTime.getHours()}:${currentTime.getMinutes()}:${currentTime.getSeconds()}.${currentTime.getMilliseconds()}`;
|
|
console.log(`[${logTime}][emittery:${type}][${debugName}] Event Name: ${eventName}\n\tdata: ${eventData}`);
|
|
};
|
|
}
|
|
}
|
|
|
|
logIfDebugEnabled(type, eventName, eventData) {
|
|
if (Emittery.isDebugEnabled || this.debug.enabled) {
|
|
this.debug.logger(type, this.debug.name, eventName, eventData);
|
|
}
|
|
}
|
|
|
|
on(eventNames, listener) {
|
|
assertListener(listener);
|
|
|
|
eventNames = Array.isArray(eventNames) ? eventNames : [eventNames];
|
|
for (const eventName of eventNames) {
|
|
assertEventName(eventName);
|
|
let set = getListeners(this, eventName);
|
|
if (!set) {
|
|
set = new Set();
|
|
const events = eventsMap.get(this);
|
|
events.set(eventName, set);
|
|
}
|
|
|
|
set.add(listener);
|
|
|
|
this.logIfDebugEnabled('subscribe', eventName, undefined);
|
|
|
|
if (!isMetaEvent(eventName)) {
|
|
emitMetaEvent(this, listenerAdded, {eventName, listener});
|
|
}
|
|
}
|
|
|
|
return this.off.bind(this, eventNames, listener);
|
|
}
|
|
|
|
off(eventNames, listener) {
|
|
assertListener(listener);
|
|
|
|
eventNames = Array.isArray(eventNames) ? eventNames : [eventNames];
|
|
for (const eventName of eventNames) {
|
|
assertEventName(eventName);
|
|
const set = getListeners(this, eventName);
|
|
if (set) {
|
|
set.delete(listener);
|
|
if (set.size === 0) {
|
|
const events = eventsMap.get(this);
|
|
events.delete(eventName);
|
|
}
|
|
}
|
|
|
|
this.logIfDebugEnabled('unsubscribe', eventName, undefined);
|
|
|
|
if (!isMetaEvent(eventName)) {
|
|
emitMetaEvent(this, listenerRemoved, {eventName, listener});
|
|
}
|
|
}
|
|
}
|
|
|
|
once(eventNames) {
|
|
let off_;
|
|
|
|
const promise = new Promise(resolve => {
|
|
off_ = this.on(eventNames, data => {
|
|
off_();
|
|
resolve(data);
|
|
});
|
|
});
|
|
|
|
promise.off = off_;
|
|
return promise;
|
|
}
|
|
|
|
events(eventNames) {
|
|
eventNames = Array.isArray(eventNames) ? eventNames : [eventNames];
|
|
for (const eventName of eventNames) {
|
|
assertEventName(eventName);
|
|
}
|
|
|
|
return iterator(this, eventNames);
|
|
}
|
|
|
|
async emit(eventName, eventData) {
|
|
assertEventName(eventName);
|
|
|
|
if (isMetaEvent(eventName) && !canEmitMetaEvents) {
|
|
throw new TypeError('`eventName` cannot be meta event `listenerAdded` or `listenerRemoved`');
|
|
}
|
|
|
|
this.logIfDebugEnabled('emit', eventName, eventData);
|
|
|
|
enqueueProducers(this, eventName, eventData);
|
|
|
|
const listeners = getListeners(this, eventName) || new Set();
|
|
const anyListeners = anyMap.get(this);
|
|
const staticListeners = [...listeners];
|
|
const staticAnyListeners = isMetaEvent(eventName) ? [] : [...anyListeners];
|
|
|
|
await resolvedPromise;
|
|
await Promise.all([
|
|
...staticListeners.map(async listener => {
|
|
if (listeners.has(listener)) {
|
|
return listener(eventData);
|
|
}
|
|
}),
|
|
...staticAnyListeners.map(async listener => {
|
|
if (anyListeners.has(listener)) {
|
|
return listener(eventName, eventData);
|
|
}
|
|
})
|
|
]);
|
|
}
|
|
|
|
async emitSerial(eventName, eventData) {
|
|
assertEventName(eventName);
|
|
|
|
if (isMetaEvent(eventName) && !canEmitMetaEvents) {
|
|
throw new TypeError('`eventName` cannot be meta event `listenerAdded` or `listenerRemoved`');
|
|
}
|
|
|
|
this.logIfDebugEnabled('emitSerial', eventName, eventData);
|
|
|
|
const listeners = getListeners(this, eventName) || new Set();
|
|
const anyListeners = anyMap.get(this);
|
|
const staticListeners = [...listeners];
|
|
const staticAnyListeners = [...anyListeners];
|
|
|
|
await resolvedPromise;
|
|
/* eslint-disable no-await-in-loop */
|
|
for (const listener of staticListeners) {
|
|
if (listeners.has(listener)) {
|
|
await listener(eventData);
|
|
}
|
|
}
|
|
|
|
for (const listener of staticAnyListeners) {
|
|
if (anyListeners.has(listener)) {
|
|
await listener(eventName, eventData);
|
|
}
|
|
}
|
|
/* eslint-enable no-await-in-loop */
|
|
}
|
|
|
|
onAny(listener) {
|
|
assertListener(listener);
|
|
|
|
this.logIfDebugEnabled('subscribeAny', undefined, undefined);
|
|
|
|
anyMap.get(this).add(listener);
|
|
emitMetaEvent(this, listenerAdded, {listener});
|
|
return this.offAny.bind(this, listener);
|
|
}
|
|
|
|
anyEvent() {
|
|
return iterator(this);
|
|
}
|
|
|
|
offAny(listener) {
|
|
assertListener(listener);
|
|
|
|
this.logIfDebugEnabled('unsubscribeAny', undefined, undefined);
|
|
|
|
emitMetaEvent(this, listenerRemoved, {listener});
|
|
anyMap.get(this).delete(listener);
|
|
}
|
|
|
|
clearListeners(eventNames) {
|
|
eventNames = Array.isArray(eventNames) ? eventNames : [eventNames];
|
|
|
|
for (const eventName of eventNames) {
|
|
this.logIfDebugEnabled('clear', eventName, undefined);
|
|
|
|
if (typeof eventName === 'string' || typeof eventName === 'symbol' || typeof eventName === 'number') {
|
|
const set = getListeners(this, eventName);
|
|
if (set) {
|
|
set.clear();
|
|
}
|
|
|
|
const producers = getEventProducers(this, eventName);
|
|
if (producers) {
|
|
for (const producer of producers) {
|
|
producer.finish();
|
|
}
|
|
|
|
producers.clear();
|
|
}
|
|
} else {
|
|
anyMap.get(this).clear();
|
|
|
|
for (const [eventName, listeners] of eventsMap.get(this).entries()) {
|
|
listeners.clear();
|
|
eventsMap.get(this).delete(eventName);
|
|
}
|
|
|
|
for (const [eventName, producers] of producersMap.get(this).entries()) {
|
|
for (const producer of producers) {
|
|
producer.finish();
|
|
}
|
|
|
|
producers.clear();
|
|
producersMap.get(this).delete(eventName);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
listenerCount(eventNames) {
|
|
eventNames = Array.isArray(eventNames) ? eventNames : [eventNames];
|
|
let count = 0;
|
|
|
|
for (const eventName of eventNames) {
|
|
if (typeof eventName === 'string') {
|
|
count += anyMap.get(this).size + (getListeners(this, eventName) || new Set()).size +
|
|
(getEventProducers(this, eventName) || new Set()).size + (getEventProducers(this) || new Set()).size;
|
|
continue;
|
|
}
|
|
|
|
if (typeof eventName !== 'undefined') {
|
|
assertEventName(eventName);
|
|
}
|
|
|
|
count += anyMap.get(this).size;
|
|
|
|
for (const value of eventsMap.get(this).values()) {
|
|
count += value.size;
|
|
}
|
|
|
|
for (const value of producersMap.get(this).values()) {
|
|
count += value.size;
|
|
}
|
|
}
|
|
|
|
return count;
|
|
}
|
|
|
|
bindMethods(target, methodNames) {
|
|
if (typeof target !== 'object' || target === null) {
|
|
throw new TypeError('`target` must be an object');
|
|
}
|
|
|
|
methodNames = defaultMethodNamesOrAssert(methodNames);
|
|
|
|
for (const methodName of methodNames) {
|
|
if (target[methodName] !== undefined) {
|
|
throw new Error(`The property \`${methodName}\` already exists on \`target\``);
|
|
}
|
|
|
|
Object.defineProperty(target, methodName, {
|
|
enumerable: false,
|
|
value: this[methodName].bind(this)
|
|
});
|
|
}
|
|
}
|
|
}
|
|
|
|
const allEmitteryMethods = Object.getOwnPropertyNames(Emittery.prototype).filter(v => v !== 'constructor');
|
|
|
|
Object.defineProperty(Emittery, 'listenerAdded', {
|
|
value: listenerAdded,
|
|
writable: false,
|
|
enumerable: true,
|
|
configurable: false
|
|
});
|
|
Object.defineProperty(Emittery, 'listenerRemoved', {
|
|
value: listenerRemoved,
|
|
writable: false,
|
|
enumerable: true,
|
|
configurable: false
|
|
});
|
|
|
|
module.exports = Emittery;
|