events.js 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193
  1. /**
  2. * Module exports.
  3. */
  4. exports.EventEmitter = EventEmitter;
  5. /**
  6. * Object#toString reference.
  7. */
  8. var objToString = Object.prototype.toString;
  9. /**
  10. * Check if a value is an array.
  11. *
  12. * @api private
  13. * @param {*} val The value to test.
  14. * @return {boolean} true if the value is an array, otherwise false.
  15. */
  16. function isArray(val) {
  17. return objToString.call(val) === '[object Array]';
  18. }
  19. /**
  20. * Event emitter constructor.
  21. *
  22. * @api public
  23. */
  24. function EventEmitter() {}
  25. /**
  26. * Add a listener.
  27. *
  28. * @api public
  29. * @param {string} name Event name.
  30. * @param {Function} fn Event handler.
  31. * @return {EventEmitter} Emitter instance.
  32. */
  33. EventEmitter.prototype.on = function(name, fn) {
  34. if (!this.$events) {
  35. this.$events = {};
  36. }
  37. if (!this.$events[name]) {
  38. this.$events[name] = fn;
  39. } else if (isArray(this.$events[name])) {
  40. this.$events[name].push(fn);
  41. } else {
  42. this.$events[name] = [this.$events[name], fn];
  43. }
  44. return this;
  45. };
  46. EventEmitter.prototype.addListener = EventEmitter.prototype.on;
  47. /**
  48. * Adds a volatile listener.
  49. *
  50. * @api public
  51. * @param {string} name Event name.
  52. * @param {Function} fn Event handler.
  53. * @return {EventEmitter} Emitter instance.
  54. */
  55. EventEmitter.prototype.once = function(name, fn) {
  56. var self = this;
  57. function on() {
  58. self.removeListener(name, on);
  59. fn.apply(this, arguments);
  60. }
  61. on.listener = fn;
  62. this.on(name, on);
  63. return this;
  64. };
  65. /**
  66. * Remove a listener.
  67. *
  68. * @api public
  69. * @param {string} name Event name.
  70. * @param {Function} fn Event handler.
  71. * @return {EventEmitter} Emitter instance.
  72. */
  73. EventEmitter.prototype.removeListener = function(name, fn) {
  74. if (this.$events && this.$events[name]) {
  75. var list = this.$events[name];
  76. if (isArray(list)) {
  77. var pos = -1;
  78. for (var i = 0, l = list.length; i < l; i++) {
  79. if (list[i] === fn || (list[i].listener && list[i].listener === fn)) {
  80. pos = i;
  81. break;
  82. }
  83. }
  84. if (pos < 0) {
  85. return this;
  86. }
  87. list.splice(pos, 1);
  88. if (!list.length) {
  89. delete this.$events[name];
  90. }
  91. } else if (list === fn || (list.listener && list.listener === fn)) {
  92. delete this.$events[name];
  93. }
  94. }
  95. return this;
  96. };
  97. /**
  98. * Remove all listeners for an event.
  99. *
  100. * @api public
  101. * @param {string} name Event name.
  102. * @return {EventEmitter} Emitter instance.
  103. */
  104. EventEmitter.prototype.removeAllListeners = function(name) {
  105. if (name === undefined) {
  106. this.$events = {};
  107. return this;
  108. }
  109. if (this.$events && this.$events[name]) {
  110. this.$events[name] = null;
  111. }
  112. return this;
  113. };
  114. /**
  115. * Get all listeners for a given event.
  116. *
  117. * @api public
  118. * @param {string} name Event name.
  119. * @return {EventEmitter} Emitter instance.
  120. */
  121. EventEmitter.prototype.listeners = function(name) {
  122. if (!this.$events) {
  123. this.$events = {};
  124. }
  125. if (!this.$events[name]) {
  126. this.$events[name] = [];
  127. }
  128. if (!isArray(this.$events[name])) {
  129. this.$events[name] = [this.$events[name]];
  130. }
  131. return this.$events[name];
  132. };
  133. /**
  134. * Emit an event.
  135. *
  136. * @api public
  137. * @param {string} name Event name.
  138. * @return {boolean} true if at least one handler was invoked, else false.
  139. */
  140. EventEmitter.prototype.emit = function(name) {
  141. if (!this.$events) {
  142. return false;
  143. }
  144. var handler = this.$events[name];
  145. if (!handler) {
  146. return false;
  147. }
  148. var args = Array.prototype.slice.call(arguments, 1);
  149. if (typeof handler === 'function') {
  150. handler.apply(this, args);
  151. } else if (isArray(handler)) {
  152. var listeners = handler.slice();
  153. for (var i = 0, l = listeners.length; i < l; i++) {
  154. listeners[i].apply(this, args);
  155. }
  156. } else {
  157. return false;
  158. }
  159. return true;
  160. };