blob: bde69e853267a0969629618d7b94f69ee94cfafd [file] [log] [blame]
Leo Repp58b9f112021-11-22 11:57:47 +01001/*!
2 * EventEmitter2
3 * https://github.com/hij1nx/EventEmitter2
4 *
5 * Copyright (c) 2013 hij1nx
6 * Licensed under the MIT license.
7 */
8;!function(undefined) {
9
10 var isArray = Array.isArray ? Array.isArray : function _isArray(obj) {
11 return Object.prototype.toString.call(obj) === "[object Array]";
12 };
13 var defaultMaxListeners = 10;
14
15 function init() {
16 this._events = {};
17 if (this._conf) {
18 configure.call(this, this._conf);
19 }
20 }
21
22 function configure(conf) {
23 if (conf) {
24
25 this._conf = conf;
26
27 conf.delimiter && (this.delimiter = conf.delimiter);
28 conf.maxListeners && (this._events.maxListeners = conf.maxListeners);
29 conf.wildcard && (this.wildcard = conf.wildcard);
30 conf.newListener && (this.newListener = conf.newListener);
31
32 if (this.wildcard) {
33 this.listenerTree = {};
34 }
35 }
36 }
37
38 function EventEmitter(conf) {
39 this._events = {};
40 this.newListener = false;
41 configure.call(this, conf);
42 }
43
44 //
45 // Attention, function return type now is array, always !
46 // It has zero elements if no any matches found and one or more
47 // elements (leafs) if there are matches
48 //
49 function searchListenerTree(handlers, type, tree, i) {
50 if (!tree) {
51 return [];
52 }
53 var listeners=[], leaf, len, branch, xTree, xxTree, isolatedBranch, endReached,
54 typeLength = type.length, currentType = type[i], nextType = type[i+1];
55 if (i === typeLength && tree._listeners) {
56 //
57 // If at the end of the event(s) list and the tree has listeners
58 // invoke those listeners.
59 //
60 if (typeof tree._listeners === 'function') {
61 handlers && handlers.push(tree._listeners);
62 return [tree];
63 } else {
64 for (leaf = 0, len = tree._listeners.length; leaf < len; leaf++) {
65 handlers && handlers.push(tree._listeners[leaf]);
66 }
67 return [tree];
68 }
69 }
70
71 if ((currentType === '*' || currentType === '**') || tree[currentType]) {
72 //
73 // If the event emitted is '*' at this part
74 // or there is a concrete match at this patch
75 //
76 if (currentType === '*') {
77 for (branch in tree) {
78 if (branch !== '_listeners' && tree.hasOwnProperty(branch)) {
79 listeners = listeners.concat(searchListenerTree(handlers, type, tree[branch], i+1));
80 }
81 }
82 return listeners;
83 } else if(currentType === '**') {
84 endReached = (i+1 === typeLength || (i+2 === typeLength && nextType === '*'));
85 if(endReached && tree._listeners) {
86 // The next element has a _listeners, add it to the handlers.
87 listeners = listeners.concat(searchListenerTree(handlers, type, tree, typeLength));
88 }
89
90 for (branch in tree) {
91 if (branch !== '_listeners' && tree.hasOwnProperty(branch)) {
92 if(branch === '*' || branch === '**') {
93 if(tree[branch]._listeners && !endReached) {
94 listeners = listeners.concat(searchListenerTree(handlers, type, tree[branch], typeLength));
95 }
96 listeners = listeners.concat(searchListenerTree(handlers, type, tree[branch], i));
97 } else if(branch === nextType) {
98 listeners = listeners.concat(searchListenerTree(handlers, type, tree[branch], i+2));
99 } else {
100 // No match on this one, shift into the tree but not in the type array.
101 listeners = listeners.concat(searchListenerTree(handlers, type, tree[branch], i));
102 }
103 }
104 }
105 return listeners;
106 }
107
108 listeners = listeners.concat(searchListenerTree(handlers, type, tree[currentType], i+1));
109 }
110
111 xTree = tree['*'];
112 if (xTree) {
113 //
114 // If the listener tree will allow any match for this part,
115 // then recursively explore all branches of the tree
116 //
117 searchListenerTree(handlers, type, xTree, i+1);
118 }
119
120 xxTree = tree['**'];
121 if(xxTree) {
122 if(i < typeLength) {
123 if(xxTree._listeners) {
124 // If we have a listener on a '**', it will catch all, so add its handler.
125 searchListenerTree(handlers, type, xxTree, typeLength);
126 }
127
128 // Build arrays of matching next branches and others.
129 for(branch in xxTree) {
130 if(branch !== '_listeners' && xxTree.hasOwnProperty(branch)) {
131 if(branch === nextType) {
132 // We know the next element will match, so jump twice.
133 searchListenerTree(handlers, type, xxTree[branch], i+2);
134 } else if(branch === currentType) {
135 // Current node matches, move into the tree.
136 searchListenerTree(handlers, type, xxTree[branch], i+1);
137 } else {
138 isolatedBranch = {};
139 isolatedBranch[branch] = xxTree[branch];
140 searchListenerTree(handlers, type, { '**': isolatedBranch }, i+1);
141 }
142 }
143 }
144 } else if(xxTree._listeners) {
145 // We have reached the end and still on a '**'
146 searchListenerTree(handlers, type, xxTree, typeLength);
147 } else if(xxTree['*'] && xxTree['*']._listeners) {
148 searchListenerTree(handlers, type, xxTree['*'], typeLength);
149 }
150 }
151
152 return listeners;
153 }
154
155 function growListenerTree(type, listener) {
156
157 type = typeof type === 'string' ? type.split(this.delimiter) : type.slice();
158
159 //
160 // Looks for two consecutive '**', if so, don't add the event at all.
161 //
162 for(var i = 0, len = type.length; i+1 < len; i++) {
163 if(type[i] === '**' && type[i+1] === '**') {
164 return;
165 }
166 }
167
168 var tree = this.listenerTree;
169 var name = type.shift();
170
171 while (name) {
172
173 if (!tree[name]) {
174 tree[name] = {};
175 }
176
177 tree = tree[name];
178
179 if (type.length === 0) {
180
181 if (!tree._listeners) {
182 tree._listeners = listener;
183 }
184 else if(typeof tree._listeners === 'function') {
185 tree._listeners = [tree._listeners, listener];
186 }
187 else if (isArray(tree._listeners)) {
188
189 tree._listeners.push(listener);
190
191 if (!tree._listeners.warned) {
192
193 var m = defaultMaxListeners;
194
195 if (typeof this._events.maxListeners !== 'undefined') {
196 m = this._events.maxListeners;
197 }
198
199 if (m > 0 && tree._listeners.length > m) {
200
201 tree._listeners.warned = true;
202 console.error('(node) warning: possible EventEmitter memory ' +
203 'leak detected. %d listeners added. ' +
204 'Use emitter.setMaxListeners() to increase limit.',
205 tree._listeners.length);
206 console.trace();
207 }
208 }
209 }
210 return true;
211 }
212 name = type.shift();
213 }
214 return true;
215 }
216
217 // By default EventEmitters will print a warning if more than
218 // 10 listeners are added to it. This is a useful default which
219 // helps finding memory leaks.
220 //
221 // Obviously not all Emitters should be limited to 10. This function allows
222 // that to be increased. Set to zero for unlimited.
223
224 EventEmitter.prototype.delimiter = '.';
225
226 EventEmitter.prototype.setMaxListeners = function(n) {
227 this._events || init.call(this);
228 this._events.maxListeners = n;
229 if (!this._conf) this._conf = {};
230 this._conf.maxListeners = n;
231 };
232
233 EventEmitter.prototype.event = '';
234
235 EventEmitter.prototype.once = function(event, fn) {
236 this.many(event, 1, fn);
237 return this;
238 };
239
240 EventEmitter.prototype.many = function(event, ttl, fn) {
241 var self = this;
242
243 if (typeof fn !== 'function') {
244 throw new Error('many only accepts instances of Function');
245 }
246
247 function listener() {
248 if (--ttl === 0) {
249 self.off(event, listener);
250 }
251 fn.apply(this, arguments);
252 }
253
254 listener._origin = fn;
255
256 this.on(event, listener);
257
258 return self;
259 };
260
261 EventEmitter.prototype.emit = function() {
262
263 this._events || init.call(this);
264
265 var type = arguments[0];
266
267 if (type === 'newListener' && !this.newListener) {
268 if (!this._events.newListener) { return false; }
269 }
270
271 // Loop through the *_all* functions and invoke them.
272 if (this._all) {
273 var l = arguments.length;
274 var args = new Array(l - 1);
275 for (var i = 1; i < l; i++) args[i - 1] = arguments[i];
276 for (i = 0, l = this._all.length; i < l; i++) {
277 this.event = type;
278 this._all[i].apply(this, args);
279 }
280 }
281
282 // If there is no 'error' event listener then throw.
283 if (type === 'error') {
284
285 if (!this._all &&
286 !this._events.error &&
287 !(this.wildcard && this.listenerTree.error)) {
288
289 if (arguments[1] instanceof Error) {
290 throw arguments[1]; // Unhandled 'error' event
291 } else {
292 throw new Error("Uncaught, unspecified 'error' event.");
293 }
294 return false;
295 }
296 }
297
298 var handler;
299
300 if(this.wildcard) {
301 handler = [];
302 var ns = typeof type === 'string' ? type.split(this.delimiter) : type.slice();
303 searchListenerTree.call(this, handler, ns, this.listenerTree, 0);
304 }
305 else {
306 handler = this._events[type];
307 }
308
309 if (typeof handler === 'function') {
310 this.event = type;
311 if (arguments.length === 1) {
312 handler.call(this);
313 }
314 else if (arguments.length > 1)
315 switch (arguments.length) {
316 case 2:
317 handler.call(this, arguments[1]);
318 break;
319 case 3:
320 handler.call(this, arguments[1], arguments[2]);
321 break;
322 // slower
323 default:
324 var l = arguments.length;
325 var args = new Array(l - 1);
326 for (var i = 1; i < l; i++) args[i - 1] = arguments[i];
327 handler.apply(this, args);
328 }
329 return true;
330 }
331 else if (handler) {
332 var l = arguments.length;
333 var args = new Array(l - 1);
334 for (var i = 1; i < l; i++) args[i - 1] = arguments[i];
335
336 var listeners = handler.slice();
337 for (var i = 0, l = listeners.length; i < l; i++) {
338 this.event = type;
339 listeners[i].apply(this, args);
340 }
341 return (listeners.length > 0) || !!this._all;
342 }
343 else {
344 return !!this._all;
345 }
346
347 };
348
349 EventEmitter.prototype.on = function(type, listener) {
350
351 if (typeof type === 'function') {
352 this.onAny(type);
353 return this;
354 }
355
356 if (typeof listener !== 'function') {
357 throw new Error('on only accepts instances of Function');
358 }
359 this._events || init.call(this);
360
361 // To avoid recursion in the case that type == "newListeners"! Before
362 // adding it to the listeners, first emit "newListeners".
363 this.emit('newListener', type, listener);
364
365 if(this.wildcard) {
366 growListenerTree.call(this, type, listener);
367 return this;
368 }
369
370 if (!this._events[type]) {
371 // Optimize the case of one listener. Don't need the extra array object.
372 this._events[type] = listener;
373 }
374 else if(typeof this._events[type] === 'function') {
375 // Adding the second element, need to change to array.
376 this._events[type] = [this._events[type], listener];
377 }
378 else if (isArray(this._events[type])) {
379 // If we've already got an array, just append.
380 this._events[type].push(listener);
381
382 // Check for listener leak
383 if (!this._events[type].warned) {
384
385 var m = defaultMaxListeners;
386
387 if (typeof this._events.maxListeners !== 'undefined') {
388 m = this._events.maxListeners;
389 }
390
391 if (m > 0 && this._events[type].length > m) {
392
393 this._events[type].warned = true;
394 console.error('(node) warning: possible EventEmitter memory ' +
395 'leak detected. %d listeners added. ' +
396 'Use emitter.setMaxListeners() to increase limit.',
397 this._events[type].length);
398 console.trace();
399 }
400 }
401 }
402 return this;
403 };
404
405 EventEmitter.prototype.onAny = function(fn) {
406
407 if (typeof fn !== 'function') {
408 throw new Error('onAny only accepts instances of Function');
409 }
410
411 if(!this._all) {
412 this._all = [];
413 }
414
415 // Add the function to the event listener collection.
416 this._all.push(fn);
417 return this;
418 };
419
420 EventEmitter.prototype.addListener = EventEmitter.prototype.on;
421
422 EventEmitter.prototype.off = function(type, listener) {
423 if (typeof listener !== 'function') {
424 throw new Error('removeListener only takes instances of Function');
425 }
426
427 var handlers,leafs=[];
428
429 if(this.wildcard) {
430 var ns = typeof type === 'string' ? type.split(this.delimiter) : type.slice();
431 leafs = searchListenerTree.call(this, null, ns, this.listenerTree, 0);
432 }
433 else {
434 // does not use listeners(), so no side effect of creating _events[type]
435 if (!this._events[type]) return this;
436 handlers = this._events[type];
437 leafs.push({_listeners:handlers});
438 }
439
440 for (var iLeaf=0; iLeaf<leafs.length; iLeaf++) {
441 var leaf = leafs[iLeaf];
442 handlers = leaf._listeners;
443 if (isArray(handlers)) {
444
445 var position = -1;
446
447 for (var i = 0, length = handlers.length; i < length; i++) {
448 if (handlers[i] === listener ||
449 (handlers[i].listener && handlers[i].listener === listener) ||
450 (handlers[i]._origin && handlers[i]._origin === listener)) {
451 position = i;
452 break;
453 }
454 }
455
456 if (position < 0) {
457 continue;
458 }
459
460 if(this.wildcard) {
461 leaf._listeners.splice(position, 1);
462 }
463 else {
464 this._events[type].splice(position, 1);
465 }
466
467 if (handlers.length === 0) {
468 if(this.wildcard) {
469 delete leaf._listeners;
470 }
471 else {
472 delete this._events[type];
473 }
474 }
475 return this;
476 }
477 else if (handlers === listener ||
478 (handlers.listener && handlers.listener === listener) ||
479 (handlers._origin && handlers._origin === listener)) {
480 if(this.wildcard) {
481 delete leaf._listeners;
482 }
483 else {
484 delete this._events[type];
485 }
486 }
487 }
488
489 return this;
490 };
491
492 EventEmitter.prototype.offAny = function(fn) {
493 var i = 0, l = 0, fns;
494 if (fn && this._all && this._all.length > 0) {
495 fns = this._all;
496 for(i = 0, l = fns.length; i < l; i++) {
497 if(fn === fns[i]) {
498 fns.splice(i, 1);
499 return this;
500 }
501 }
502 } else {
503 this._all = [];
504 }
505 return this;
506 };
507
508 EventEmitter.prototype.removeListener = EventEmitter.prototype.off;
509
510 EventEmitter.prototype.removeAllListeners = function(type) {
511 if (arguments.length === 0) {
512 !this._events || init.call(this);
513 return this;
514 }
515
516 if(this.wildcard) {
517 var ns = typeof type === 'string' ? type.split(this.delimiter) : type.slice();
518 var leafs = searchListenerTree.call(this, null, ns, this.listenerTree, 0);
519
520 for (var iLeaf=0; iLeaf<leafs.length; iLeaf++) {
521 var leaf = leafs[iLeaf];
522 leaf._listeners = null;
523 }
524 }
525 else {
526 if (!this._events[type]) return this;
527 this._events[type] = null;
528 }
529 return this;
530 };
531
532 EventEmitter.prototype.listeners = function(type) {
533 if(this.wildcard) {
534 var handlers = [];
535 var ns = typeof type === 'string' ? type.split(this.delimiter) : type.slice();
536 searchListenerTree.call(this, handlers, ns, this.listenerTree, 0);
537 return handlers;
538 }
539
540 this._events || init.call(this);
541
542 if (!this._events[type]) this._events[type] = [];
543 if (!isArray(this._events[type])) {
544 this._events[type] = [this._events[type]];
545 }
546 return this._events[type];
547 };
548
549 EventEmitter.prototype.listenersAny = function() {
550
551 if(this._all) {
552 return this._all;
553 }
554 else {
555 return [];
556 }
557
558 };
559
560 if (typeof define === 'function' && define.amd) {
561 // AMD. Register as an anonymous module.
562 define(function() {
563 return EventEmitter;
564 });
565 } else if (typeof exports === 'object') {
566 // CommonJS
567 exports.EventEmitter2 = EventEmitter;
568 }
569 else {
570 // Browser global.
571 window.EventEmitter2 = EventEmitter;
572 }
573}();